最近需要将自己项目的公共代码打包成 Framework 来使用,但是在打包过程中遇到一个问题,就是提取的公共代码中用到了一些第三方的库,比如 AFNetworking 等。
创建 Framework 工程
1. 创建打包工程
-
打开 Xcode 新建一个工程,选择 Framework & Libray 选项中的 Cocoa Touch Framework
-
由于项目需要引入第三方库,所以需要引入cocopods
-
cd 项目名称
-
pod init 创建Podfile 文件
-
编辑Podfile文件
-
pod install 拉去cocopods下的第三方库
2. 添加公开头文件
-
将需要转成静态库的文件导入项目,注意需要保留创建工程自动生成的.h文件,它相当于我们平时工程里的pch文件,用于导入头文件的
-
选中 Target ,选择 Build Phases - Headers ,可以看出有三个选项,分别是 Public 、Private 、Project ,把需要公开给别人的 .h 文件拖到 Public 中,把不想公开的,即为隐藏的 .h 文件拖到 Project 中。
-
完成上述步骤之后,在默认生成的 .h 文件中,我的是 TestFramework.h ,把所有需要暴露的 .h 文件都用 #import <TestFramework/PublicHeader.h>引入,记住一定要将所有需要暴露的 .h 文件都引入,也就是上面 Headers - Public 中加的所有 .h 文件,不然编译后生成的 .framework 在引用的时候会有警告。
-
注意引入第三方库的头文件,是在自动生成的.h文件里导入第三方库,其他文件需要引用第三方库的文件,则直接引入自动生成的.h文件即可,例如ASAESUtil需要引用第三方库,则直接导入AESFramework.h文件,如果需要引用的文件不是第三方库,则直接引用该文件,文件名为<AESFramework/NSData+ASAES.h>类型,如图所示
3.添加公开头文件
-
选中 Target ,选择 Build Settings ,Build Active Archiyecture Onluy 设置为No。
-
选中 Target ,选择 Build Settings ,在搜索栏搜索 Mach-O Type ,将 Mach-O Type 修改为 Static Library。
工程打包成 Framework
1. 真机编译所有文件
-
按照下图将编译的 Device 选择为真机 ,然后按下 Command + B 开始编译,编译成功后右键 Products 文件夹下的 .framework 文件,点击 show in Finder
-
打开后可以看到打包完成的真机 Framework 包。
2. 模拟器编译所有文件,将真机换成模拟器即可
3. 将两个 Framework 合成
上面有两个 Framework , 一个是 Debug-iphoneos(真机) 下的,一个是 Debug-iphonesimulator(模拟器) 下的,需要通过终端命令将两个 Framework 合为一个模拟器和真机都可使用的 Framework
-
打开终端先输入 lipo -create ,然后输入 空格
-
接着将 Debug-iphoneos(真机) 下的 AESFramework也就是上面框出来的空白文件直接拖到终端,终端会自动显示路径。
-
然后直接将 Debug-iphonesimulator(模拟器) 下的AESFramework也拖到终端。
-
接着输入 -output ,然后输入 空格 。
-
然后输入 Debug-iphoneos(真机)的AESFramework 地址后直接回车。
-
这时候将真机下的AESFramework.framework 就是我们需要的framework静态库了。
-
但是可以发现打包完后的 .framework 包里面是没有 CocoaPods 集成的第三方库的,所以在使用 .framework 包时,工程中必须也要集成 .framework 包中用到的第三方库,否则会找不到文件而报错。
4.打包完的 Framework
-
将framework拖入项目中,然后用#import <AESFramework/AESFramework.h> 这种格式引入静态库即可
5.打包完的 Framework 放置私有库
-
将.framework放到 Frameworks文件夹下,修改对应的podspec文件,framework静态库的私有库只需要一个.framework的文件和podspec文件即可和.a静态库的私有库是有区别的
Pod::Spec.new do |s|
s.name = "ASAESSecurity"
s.version = "2.0.3"//版本号
s.summary = "A short description of ASAESSecurity"
s.description = <<-DESC
DESC
s.homepage = "http://EXAMPLE/ASAESSecurity"
s.license = "MIT"
s.author = { "xx" => "xxx@xx.com" }
s.platform = :ios, "8.0"
s.source = { :svn => "xxxxxx/cocoapods-svn/", :tag => "#{s.name}/#{s.version}" }//私有库地址
s.vendored_frameworks = 'Frameworks/AESFramework.framework' //依赖对应的.framework文件
s.dependency 'xxx' //引用的第三方
s.requires_arc = true
end
-
私有库更新之后,本地项目选择对应的私有库版本号加入podfile文件中,再终端执行pod repo-svn update tags 更新本地tags库,再执行pod install 拉取framework私有库,头文件引用也是一样的#import <AESFramework/AESFramework.h> 这种格式引入
-
引入.framework 私有库可能会出现找不到头文件的报错
-
这时候,我们可以选择在项目工程的Building setting 里选择Allow Non-modular includes in Framework Modules 设置成YES,再运行项目,就可以正常运行(有个疑问,正常运行之后,我讲设置重新改成NO,但是项目依旧可以正常运行了,很奇怪,不过总之是成功了)
-
如果pod install之后发现私有库的代码没有更新,Cocoapods下的tags库中的私有库更新了,可以使用open ~/Library/Caches/Cocoapods 清除Cocoapods缓存