XCFramework with Pods Dependencies

Question

Our goal is to create a framework that hides our internal code and provide SDK to our customers. We have thought of creating XCFramework which fulfills our requirement. Umbrella framework is also suggested over the internet but mostly suggested to avoid that approach. Our Framework is dependent on some third-party libraries which we are using via Pods.

Issue: XCFramework does not compile pods framework. We got an error like "Xyz(Pod) module not found". Even if we add pods from the client-side it does not work.

Code to create XCFramework is as bellow

1) Create an archive for iOS platform

xcodebuild archive -workspace ABC.xcworkspace \
  -scheme ABC \
  -sdk iphoneos \
  -archivePath "./archives/ios_devices.xcarchive" \
  BUILD_LIBRARY_FOR_DISTRIBUTION=YES \
  SKIP_INSTALL=NO

2) Create an archive for iOS-Simulator platform

  xcodebuild archive  -workspace ABC.xcworkspace \
  -scheme ABC \
  -sdk iphonesimulator \
  -archivePath "./archives/ios_simulators.xcarchive" \
  BUILD_LIBRARY_FOR_DISTRIBUTION=YES \
  SKIP_INSTALL=NO

3) Create an XCFramework from Archives

xcodebuild -create-xcframework \
-framework ./archives/ios_devices.xcarchive/Products/Library/Frameworks/ABC.framework \
-framework ./archives/ios_simulators.xcarchive/Products/Library/Frameworks/ABC.framework \
-output build/ABC.xcframework

We got ABC XCFramework successfully but dependencies are not included in XCFramework. Any solution for this? or Is there any way where we can set framework search path to client-side? or Any alternate approach?

Did the below solution actually work? I'm trying something similar and when using the framework I get errors. — Dustin Pfannenstiel, Dec 16 '20 at 14:10
@BhavinVaghela - if you do not include the external dependancies in your Framework project, doesn't the compiler give you an error when trying to build the Framework ? — Shawn Frank, Feb 16 '21 at 13:53
@ShawnFrank I have tried in serval way, every time I got an error like a module(third party) is not found. The solution which works for me is to create a pod and add a third-party dependency in a pod spec. Also, I am not getting an error while building or creating a framework I got an error while adding to another project. — Bhavin Vaghela, Mar 01 '21 at 11:53
@BhavinVaghela in my case only create of iOS device but not for simulator — Bhadresh Sonani, Sep 03 '22 at 09:07
@BhadreshSonani Have you followed step 2 properly? Please share some more details — Bhavin Vaghela, Sep 05 '22 at 05:54
@BhavinVaghela Do you have any idea about integration of facebook login in framework ? — Bhadresh Sonani, Sep 05 '22 at 06:47
@BhadreshSonani No, i have not integrate facebook in framework — Bhavin Vaghela, Oct 06 '22 at 14:22

score 15 · Accepted Answer · answered Nov 11 '20 at 07:44

15

You can create a pod and publish it.

Check https://guides.cocoapods.org/making/making-a-cocoapod.html

Sample Podspec file with XCFramework + Third party dependency

Pod::Spec.new do |s|  
    s.name              = 'XCFrameworkTest' # Name for your pod
    s.version           = '0.0.1'
    s.summary           = 'Sample Spec'
    s.homepage          = 'https://www.google.com'

    s.author            = { 'Sample' => 'sample@sample.com' }
    s.license = { :type => "MIT", :text => "MIT License" }

    s.platform          = :ios
    # change the source location
    s.source            = { :http => 'http://localhost:8080/XCFrameworkTest.zip' } 
    s.ios.deployment_target = '10.0'
    s.ios.vendored_frameworks = 'XCFrameworkTest.xcframework' # Your XCFramework
    s.dependency 'PromisesSwift', '1.2.8' # Third Party Dependency
end

After you publish your pod, Customer can use cocopods to get our framework.

In Customer's Podfile

pod 'XCFrameworkTest' #Your pod name

answered Nov 11 '20 at 07:44

Ayyanar

526
1
5
10

This is elegant. – Dustin Pfannenstiel Dec 15 '20 at 18:37
4

There are important bits to be found here though: https://github.com/CocoaPods/CocoaPods/issues/9775#issuecomment-722298424 – Dustin Pfannenstiel Dec 16 '20 at 14:35
5

I tried this approach but I'm still unable to run an app, because of a build errors: > Missing required module 'Stripe3DS2'. > Failed to build module from its module interface; it may have been damaged or it may have triggered a bug in the Swift compiler when it was produced. My guess is that xcframework couldn't handle static dependency from Stripe. – Konrad Siemczyk Dec 18 '20 at 14:43
2

This solution makes sense however what I don't get is, if we do not include the exteral dependancies in the Framework project, how does the Framework compile and build ? – Shawn Frank Feb 16 '21 at 13:52
@KonradSiemczyk - I am also facing the same issue. Did you got any solution??? – Surya Mar 06 '21 at 06:34
@Surya Nope, but if you will find some solution, please let me know :) – Konrad Siemczyk Mar 23 '21 at 11:01
@ShawnFrank You and I had the same question I think, does this answer it? https://stackoverflow.com/a/69546163/1795356 – Jordan H Oct 12 '21 at 22:04

Alejandro Zalazar · Answer 2 · 2021-03-22T12:11:44.360

I have created a template for this purpose. You can test it by running the command

pod lib create YourLibName --template-url="https://github.com/zalazara/pod-template-xcframework.git"

The template basically generates an example project together with its podfile file where, in turn, the framework to be developed is embedded, then the generation file compiles the framework using the workspace.

BUILD_DIR="Build"
TMP_DIR="${BUILD_DIR}/Tmp"
IOS_ARCHIVE_PATH="${TMP_DIR}/iOS.xcarchive"
IOS_SIM_ARCHIVE_PATH="${TMP_DIR}/iOSSimulator.xcarchive"

rm -rf ${BUILD_DIR}
rm -rf "${FRAMEWORK_NAME}.xcframework"

xcodebuild archive \
 -workspace "Example/${WORKSPACE}" \
 -scheme ${SCHEME} \
 -archivePath ${IOS_SIM_ARCHIVE_PATH} \
 -sdk iphonesimulator \
 SKIP_INSTALL=NO \
 | xcpretty


 xcodebuild archive \
 -workspace "Example/${WORKSPACE}" \
 -scheme ${SCHEME} \
 -archivePath ${IOS_ARCHIVE_PATH} \
 -sdk iphoneos \
 SKIP_INSTALL=NO \
 | xcpretty

 xcodebuild -create-xcframework \
 -framework ${IOS_SIM_ARCHIVE_PATH}/Products/Library/Frameworks/${FRAMEWORK_NAME}.framework \
 -framework ${IOS_ARCHIVE_PATH}/Products/Library/Frameworks/${FRAMEWORK_NAME}.framework \
 -output ${FRAMEWORK_NAME}.xcframework \
 | xcpretty

For more information : https://github.com/zalazara/pod-template-xcframework.git

score 0 · Answer 3 · edited Jul 18 '21 at 20:49

0

Ayyanar's solution do the trick for me, but get an error on build: "Failed to build module from its module interface; it may have been damaged or it may have triggered a bug in the Swift compiler when it was produced".

I solve it linking the target to the .xcframwork from Pod.

Hope it helps somebody.

edited Jul 18 '21 at 20:49

voxobscuro

2,132
1
21
45

answered Jul 15 '21 at 12:19

ManuelAT

1
1

XCFramework with Pods Dependencies

3 Answers3

Linked