iOS 静态库和动态库打包framework流程(纯swift版/swift、OC混编版)

系统及Xcode版本

macOS Big Sur 版本11.6
Xcode Version 13.0

1. 静态库打包流程

1.1 新建工程

选择iOS -- Framework&Library, 点击next

新建工程

1.2 Pod三方库

如果打包文件中使用了第三方库,建议pod管理,并告知用户使用pod安装,避免用户重复导入。跟平时开发逻辑一样,打开.xcworkspace工程。

pod init
open Podfile 编辑framework依赖的第三方(不要指定iOS版本 # platform :ios, '9.0')
pod install

操作完之后工程目录显示


工程目录
1.3 添加文件

把打包需要的文件添加到项目中。如果想要这个类或类里面的方法被外面使用,需要配合pubic修饰供外面使用

添加打包文件

public设置

1.4 设置
  1. TARGETS —> Build Settings 中设置相关项 Build Active Architecture Only 设置为NO。意思是当前打包的.framework支持所有的设备,否则打包时只能用当前版本的模拟器或真机运行。

    Build Active Architecture Only设置

  2. Build Setting 搜索linking 设置Dead Code StrippingNO是编译选项优化,包瘦身,(可不改) 。
    Mach-O Type 选中StaticLibrary (静态库)Xcode默认是Dynamic Library(动态库)

    Build Setting设置

  3. 设置framework最低支持的版本


    Build Setting设置
  4. TARGETS —> Build Phases 将需要呈现给来的头文件,直接从工程目录拖到Public中。对于OC文件,不想呈现出来的.h文件不建议拖到Private中, 放在Project中即可。

  5. 编译为release模式


    Release模式设置
  6. 在真机和模拟器分别运行一次。Success状态如下,右键Show in Finder


    分为Debug版本和Release版本,以-iphoneos的为真机版本,以-iphonesimulator的为模拟器framework
    文件目录

  7. framework真机模拟器合并
    使用lipo -info 查看framework支持的架构信息,tip: 查看的文件是上图的①AILLSDK文件

真机版本
lipo -info /Users/wangjia/Library/Developer/Xcode/DerivedData/AILLSDK-cpbbnoggikwgjhbjflmuxtaeedig/Build/Products/Release-iphoneos/AILLSDK.framework/AILLSDK
结果:
Architectures in the fat file: /Users/wangjia/Library/Developer/Xcode/DerivedData/AILLSDK-cpbbnoggikwgjhbjflmuxtaeedig/Build/Products/Release-iphoneos/AILLSDK.framework/AILLSDK are: arm64 armv7

模拟器版本
lipo -info /Users/wangjia/Library/Developer/Xcode/DerivedData/AILLSDK-cpbbnoggikwgjhbjflmuxtaeedig/Build/Products/Release-iphonesimulator/AILLSDK.framework/AILLSDK
结果:
Architectures in the fat file: /Users/wangjia/Library/Developer/Xcode/DerivedData/AILLSDK-cpbbnoggikwgjhbjflmuxtaeedig/Build/Products/Release-iphonesimulator/AILLSDK.framework/AILLSDK are: arm64 x86_64 i386

由于以上获取的framework只能在对应的版本上运行(即真机只能在设备上运行模拟器版本只能在模拟器上面运行使用),所以需要合并framework版本。
合并framework版本:
sudo lipo -create (此处请填写真机AppVest文件路径) (此处填写模拟器AILLSDK文件路径) -output 自定义合成文件存储路径(合成文件的名字AILLSDK)

sudo lipo -create/Users/wangjia/Library/Developer/Xcode/DerivedData/AILLSDK-cpbbnoggikwgjhbjflmuxtaeedig/Build/Products/Release-iphonesimulator/AILLSDK.framework/AILLSDK /Users/wangjia/Library/Developer/Xcode/DerivedData/AILLSDK-cpbbnoggikwgjhbjflmuxtaeedig/Build/Products/Release-iphoneos/AILLSDK.framework/AILLSDK -output ~/Desktop/AILLSDK

因为真机版本和模拟器版本的framework都存在arm64架构,导致架构重复,不出意外,会提示合并失败。如下

fatal error: /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/lipo: /Users/wangjia/Library/Developer/Xcode/DerivedData/AILLSDK-cpbbnoggikwgjhbjflmuxtaeedig/Build/Products/Release-iphonesimulator/AILLSDK.framework/AILLSDK and /Users/wangjia/Library/Developer/Xcode/DerivedData/AILLSDK-cpbbnoggikwgjhbjflmuxtaeedig/Build/Products/Release-iphoneos/AILLSDK.framework/AILLSDK have the same architectures (arm64) and can't be in the same fat output file

处理合并失败的问题

  1. 回到工程中,Build Settings -> Excluded Architectures里按照这样设置一下,再重新编译合并就不会报错了。

    Excluded Architectures设置

  2. 如果手里只有.a或.framework文件
    使用lipo remove命令将模拟器库的arm64架构移除

lipo XXX.a -remove arm64 -output XXX.a
(XXX.a 换成本文的AILLSDK)

最后,将XX.framework(真机或者模拟器framework都可)文件夹拷贝出来,替换AILLSDK(本文使用的)为刚才合并的新文件。
查看替换后的framework支持全部真机模拟器架构。

lipo -info ~/Desktop/mm/AILLSDK.framework/AILLSDK
结果:
Architectures in the fat file: /Users/wangjia/Desktop/mm/AILLSDK.framework/AILLSDK are: i386 armv7 x86_64 arm64

使用

我在合并binary文件之后,仅拷贝出Release-iphoneos文件夹下的XXX.framework,并替换掉AILLSDK二进制文件。导入项目中使用模拟器运行,报错,显示找不到架构。

Could not find module 'AILLSDK' for target 'x86_64-apple-ios-simulator'; found: arm64, arm64-apple-ios

解决方案

模拟器的framework
XXX-iphonesimulatar.framework/Modules/XXX.swiftmodule/

拷贝所有的modules到

XXX-iphoneos.framework/Modules/XXX.swiftmodule/

再替换掉AILLSDK二进制文件,导入项目,如果framework中内含第三方库,需要在所在的工程中使用pod加载,否则会提示编译失败。
至此,编译成功。

OC 和Swift混编的Framework

不管是在framework封装的内部,内部swift类调用内部的OC类,还是内部的OC类使用内部的swift类,还是外部工程swift类使用framework内部OC类,还是外部工程OC类使用framework内部swift类。原理是一致的,以下来介绍下:

swift中调用oc

AILLSDK.h(你自己创建framework时候生成的.h文件)中添加import导入
#import

oc中调用swift代码。

在oc的.m.h文件中,导入#import , 也就是你自己framework名-Swift.h

你可能感兴趣的:(iOS 静态库和动态库打包framework流程(纯swift版/swift、OC混编版))