iOS Static vs Dynamic frameworks clarifications

IosFrameworksStatic LibrariesStatic LinkingIos Frameworks

Ios Problem Overview


I have to admit that with the release of iOS 8 I am a bit confused about dynamic and static frameworks in iOS.

I am looking for a way to distribute a library that I created, and I need to support iOS 7 and above. (Note: This will be a proprietary framework. I cannot use cocoa pods, and I also cannot distribute the source). Here is what I already know:

  • iOS 8 introduced "embedded frameworks" for iOS, but, as I understand, they do not work for iOS 7, only for iOS 8 and above.
  • I have the option of distributing my library as a static library (.a file) and also distribute the headers. I know that this is a common way of dealing with the situation, but I would like to find something simpler than that (and also to bundle some resources with it, if possible).
  • I have also found that iOS 7 does not support dynamic .framework libraries (only static) because it doesn't support dynamic linking. But iOS 8 does, as well as static linking.

And here are my questions regarding this information:

  • I saw that I can create a .framework target, and make it static, by changing the Mach-O type to "static library. Would that be enough in order to support iOS 7 without any problems, and also to distribute my library as a .framework bundle? If so, why is "embedded frameworks" in iOS 8 that big of a deal, as many resources on the internet are suggesting? Am I missing something?
  • Is it necessary to codesign the .framework just as I do with any other application I make?
  • What if I need to include other resources (like Core Data or Images) with my .framework file? Will I need to make a separate .bundle file for that?

Ios Solutions


Solution 1 - Ios

Before iOS8, Xcode only allowed the option of creating static libraries for iOS. The common problem with that was we had to ship the binary and headers separately.

Later, some developers came with the idea of creating 'static frameworks'. [the .framework is just a folder with symbolic links to the lib and the headers]. One such example is https://github.com/jverkoey/iOS-Framework

This option will work for iOS 7 or 8 or before that. Because they are just static libraries with the convenience of bundling the headers files along.

As for your questions of the resources, we would need to bundle them in '.bundle'.. For shipping them i am not sure if we can enclose them in the .framework folder.. In the past i used to ship my libs as a static framework and bundle...

However the above option will not work for you if you use Swift. Xcode does not support building static libraries that include swift code.

You must go with Dynamic frameworks if there is swift usage. In theory, Dynamic frameworks work in iOS7.. But, i think iTunes Connect will reject if the app is targeting iOS7 and uses Dynamic frameworks :-).

Hope this helps

Solution 2 - Ios

With Xcode 9 onwards you can create static frameworks for Swift as well. This is possible due to ABI source compatibility. All you need to do is just change the Mach-O type under build settings of the framework target. This technique is also applicable to Hybrid Frameworks(frameworks with Swift and Objective-C code).

Solution 3 - Ios

Static vs Dynamic linking

static or dynamic in name usually points into a Linking[About] type

Frameworks can be static or dynamic[Check static or dynamic]

You can change the format of library that will have an impact on a Linker by changing Framework target -> Build Settings -> Mach-O Type[About] to Static Library or Dynamic Library. By default Xcode has Dynamic Library value.

Depends on this setting different types of binary will be generated

https://i.stack.imgur.com/U4psi.png" height="150">

After you successfully configure a consumer[Link vs Embed]

Static Linker ld: at compile time will include all code from the static library into the executable object file.

https://i.stack.imgur.com/OwmLt.png" height="100">

Dynamic Linker dyld: at load/run time will try to find the embedded framework using @rpath[About] and link it

https://i.stack.imgur.com/EqrM4.png" height="100">

[Vocabulary]

Solution 4 - Ios

I don't have all the answers but I'll try to address some of your questions here.

  • You will get a warning for using these frameworks in iOS 7, however that's all it is, a warning. See this answer.

  • You can include other resources like CoreData however you'll need to create them in code manually. Here's a tutorial showing how to create a core data model.

  • You have to code sign dynamic libraries for iOS.

  • You need to make sure your framework supports both simulator and device architectures if you're planning to distribute it.

Solution 5 - Ios

Swift does not work in static lib. If you have to use dynamic framework, you have to set min iOS to 8.0 because AppStore reject ios 7 with dynamic framework

Attributions

All content for this solution is sourced from the original question on Stackoverflow.

The content on this page is licensed under the Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.

Content TypeOriginal AuthorOriginal Content on Stackoverflow
QuestioncsotiriouView Question on Stackoverflow
Solution 1 - IosSubbuView Answer on Stackoverflow
Solution 2 - IosAvijeet DuttaView Answer on Stackoverflow
Solution 3 - IosyoAlex5View Answer on Stackoverflow
Solution 4 - IosBeau NouvelleView Answer on Stackoverflow
Solution 5 - IosAliasCocoaView Answer on Stackoverflow