系统及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修饰供外面使用
1.4 设置
-
TARGETS —> Build Settings
中设置相关项Build Active Architecture Only
设置为NO
。意思是当前打包的.framework
支持所有的设备,否则打包时只能用当前版本的模拟器或真机运行。
-
Build Setting
搜索linking 设置Dead Code Stripping
为NO
是编译选项优化,包瘦身,(可不改) 。
Mach-O Type
选中StaticLibrary (静态库)
Xcode默认是Dynamic Library(动态库)
。
-
设置framework最低支持的版本
-
TARGETS —> Build Phases
将需要呈现给来的头文件,直接从工程目录
拖到Public
中。对于OC文件,不想呈现出来的.h文件
不建议拖到Private中, 放在Project
中即可。 -
编译为release模式
-
在真机和模拟器分别运行一次。Success状态如下,右键
Show in Finder
。
分为Debug版本和Release版本,以-iphoneos
的为真机版本,以-iphonesimulator
的为模拟器framework
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
处理合并失败的问题
-
回到工程中,
Build Settings -> Excluded Architectures
里按照这样设置一下,再重新编译合并就不会报错了。
如果手里只有.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 <AILLSDK/OC类名.h>
oc中调用swift代码。
在oc的.m
或.h
文件中,导入#import <AILLSDK/AILLSDK-Swift.h>
, 也就是你自己framework名-Swift.h