Build Swift dynamic framework with third party static framework as a single framework
Asked Answered
D

1

11

Trying to prepare a single dynamic framework to my customer. My framework (A.framework) uses third-party recognition static framework (B.framework). I can't provide separate A and B frameworks to the customer. Ideally B.framework should be built and included into my A.framework's binary, so the customer's app will only embed A.framework without any additional actions to link with that third-party app.

What I did:

  1. Added B.framework to the project.
  2. Added B.framework to "Linked Frameworks and Libraries" in the corresponding target.
  3. Built A.framework.
  4. Created a demo application and included A.framework to the project.
  5. Added A.framework to "Embedded Binaries".
  6. Demo app's build fails with message "Missing required module 'B'" (despite the fact that it is used in A.framework only).

Note:

  • I neither created any modulemap files for B.framework, nor additional run scripts
  • Making A.framework static is not acceptable because it includes some resources (storyboards, icons and some other files)
  • Tried to make un-recommended "umbrella" framework but got stuck on loading B.framework's bundle in demo app
  • Tried to make fake "umbrella" framework by simply copying B.framework inside A.framework, but got 2 problems - huge size of A.framework and Mach-O error while exporting the demo application (because of Mach-O difference between dynamic A and static B frameworks)

Any ideas would be highly appreciated!

UPD 1: This is not about umbrella framework because the proper umbrella framework implementation requires to load sub-framework from bundle which is not good. The fake framework implementation (sub-framework simply copied to umbrella) won't work for release because of different Mach-O values - dynamic and static. Plus fake umbrella framework has a huge size because sub-framework is being fully copied inside umbrella.

UPD 2: Created a small test project: StaticFrameworkTest which has 3 sub-projects:

  1. Demo-application with dynamic framework dependency (framework A) and shouldn't know anything about framework B
  2. Dynamic framework with static framework dependency (framework B) which ideally should be included in A framework's binary.
  3. Static framework B
Dedrick answered 22/6, 2018 at 11:51 Comment(14)
Do a small demo project with 1 file in framework A and 1 file in framework B. It would help you understand and also others understandMerthiolate
Possible duplicate of How to create an umbrella framework in iOS SDK?Dislocate
@Dislocate no, it's not about umbrella framework because all the ways to implement umbrella are not proper solutions for release version. Please see UPD 1 with a bit more detailed explanation.Dedrick
@Merthiolate thank you for your reply! Please see UPD 2 with link to the projectDedrick
@Dedrick In your project where have you defined TestDynamic. I couldn't spot TestDynamic. Create a workspace and add the framework and TestApp's project file on to it. Refer: raywenderlich.com/126365/ios-frameworks-tutorialMerthiolate
@Merthiolate sorry, but I don't want to link TestApp and DynamicFramework projects with each other because the idea is to deliver the dynamic framework to the customer. Please check if DynamicFramework.framework is in "Embedded Binaries" of TestApp's build settings ("General" tab).Dedrick
@Merthiolate do you have any ideas how to resolve the problem?Dedrick
First creating a workspace doesn’t remove the demarcation still they are different projects, you can always select the scheme for the framework alone and build only the framework. Secondly hope you know the differences between static and dynamic frameworks. If you don’t want to expose the code then you could create a static framework of A that contains that static framework BMerthiolate
Can you just use cocoa pods, you can add dependency frameworks to your podspec so the thirdparty framework is always available with your frameworkPanda
@JustinMiller, unfortunately not. The client who use my dynamic framework doesn't use cocoa pods.Dedrick
@user1046037, so if they are different projects, the common workspace is not necessary, right? I just want to keep it similar to the real example, where I'm using third-party static framework (no access to source code) in my dynamic framework and then publish my framework to my clients who are using it again without sources.Dedrick
Please refer to the documentation would help you.Merthiolate
@user1046037, yes, I understand differences between static and dynamic frameworks. Making my framework (B) static is not allowed because it consists of other resources (storyboards, license file, etc.).Dedrick
@Merthiolate I couldn't find any appropriate documentation for my case. That static framework is actually Objective C static library wrapped into framework. When I've unwrapped this library with headers and included into the project, I've faced "Missing required module B" error again. I followed the following links to import the library: ioscake.com/importing-commoncrypto-in-a-swift-framework.html #42085717 nsomar.com/modular-framework-creating-and-using-themDedrick
K
4

A static framework is by definition a fat static library combined with any additional required resources. As such you can embed your third party static library inside your own and also include images, storyboards, plist etc.

You can't do that in a static library (i.e. *.a), but in a static framework you can do. See for example https://www.raywenderlich.com/65964/create-a-framework-for-ios for details on how to do that (at the end of the article it creates the static *.framework out of the static *.a and some resources)

A dynamic framework can never embed a third party static library. The main application that imports the dynamic framework will always have to also explicitly link against the static library, which it seems that is not what you want.

Kristynkrock answered 2/7, 2018 at 15:10 Comment(5)
Thank you! Finally, I was able to build static framework with all the dependencies and resources without any issues. Who will do similar stuff, note: an application that depends on a static framework should be only linked with this framework (not embed it), plus "Framework Search Paths" setting for the application should be set to all the inner frameworks.Dedrick
> A dynamic framework can never embed a third party static library. I think that is an incorrect statement. A dynamic framework can embed a static binary (library or framework) and then you the App does not need to know anything about this static dependency. Static binary would then be embedded == merged with dynamic binary symbols, exactly the way static binaries always do. I couldn't find a doc proving or disproving that but we have exactly this setup in our project and it works.Christenechristening
You are actually right. It is possible to set it up. But you do still incur the risk of symbol duplication so unless you control the entire app and you can guarantee that's the only place the binary library is imported, it is not a recommended approach.Kristynkrock
@Dedrick please let me know if you able to fix this i got same issuesStefan
How can I use pod or Firebase or some 3rd party libs in a dynamic framework?Clemente

© 2022 - 2024 — McMap. All rights reserved.