【iOS 开发】打包 Framework 时使用 CocoaPods 引入第三方库的方法

最近需要将自己项目的公共代码打包成 Framework 来使用,但是在打包过程中遇到一个问题,就是提取的公共代码中用到了一些第三方的库,比如 AFNetworking 等,怎么才能把第三方库集成进来让代码编译通过并打包成功呢,网上找了很久都没有找到一篇专门说这个的,让我走了不少坑,现在就分享一下在打包 Framework 时怎样使用 CocoaPods 引入第三方库。

如果你的代码中没有用到其他第三方库的话,可以转到我的另一篇文章:【iOS 开发】将自己的框架打包成 Framework 的方法


创建 Framework 工程

1. 创建打包工程

  • 打开 Xcode 新建一个工程,选择 Framework & Libray 选项中的 Cocoa Touch Framework ,这里说一下我的 Xcode 版本是 8.3.2

创建工程

  • 假设我的代码中要用到 MBProgressHUD 这个第三方库(比较好演示),然后使用 CocoaPods 在工程中集成 MBProgressHUD ,集成方法和普通项目一模一样。

CocoaPods

  • 然后选择工程下的 TestFramework.xcworkspace 重新打开工程。

重新打开工程

  • 因为要打包所需的文件,所以这里我自己创建了一个测试类,并在里面使用了 MBProgressHUD 这个库,在实际的打包过程中,直接把需要打包的所有文件拖到该工程中即可。

测试类

2. 添加公开头文件

  • 选中 Target ,选择 Build Phases - Headers ,可以看出有三个选项,分别是 Public 、Private 、Project ,把需要公开给别人的 .h 文件拖到 Public 中,把不想公开的,即为隐藏的 .h 文件拖到 Project 中。

Headers

  • 完成上述步骤之后,在默认生成的 .h 文件中,我的是 TestFramework.h ,把所有需要暴露的 .h 文件都用 #import <TestFramework/PublicHeader.h>引入,记住一定要将所有需要暴露的 .h 文件都引入,也就是上面 Headers - Public 中加的所有 .h 文件,不然编译后生成的 .framework 在引用的时候会有警告。

引入头文件

3. 更改设置参数

  • 选中 Target ,选择 Build Settings ,在 Architectures 下增加 armv7s

更改设置参数

  • 选中 Target ,选择 Build Settings ,在搜索栏搜索 Mach-O Type ,将 Mach-O Type 修改为 Static Library

更改设置参数

工程打包成 Framework

1. 真机编译所有文件

  • 按照下图将编译的 Device 选择为真机 ,然后按下 Command + B 开始编译,编译成功后右键 Products 文件夹下的 .framework 文件,点击 show in Finder

编译真机

  • 打开后可以看到打包完成的真机 Framework 包。

Framework

2. 模拟器编译所有文件

  • 按照下图将编译的 Device 选择为随便一个模拟器 ,然后按下 Command + B 开始编译,编译成功后右键 Products 文件夹下的 .framework 文件,点击 show in Finder

编译模拟器

  • 打开后可以看到打包完成的模拟器 Framework 包。

Framework

3. 将两个 Framework 合成

上面有两个 Framework , 一个是 Debug-iphoneos(真机) 下的,一个是 Debug-iphonesimulator(模拟器) 下的,需要通过终端命令将两个 Framework 合为一个模拟器和真机都可使用的 Framework

  • 打开终端先输入 lipo -create ,然后输入 空格

Framework 合成

  • 接着将 Debug-iphoneos(真机) 下的 TestFramework 也就是上面框出来的空白文件直接拖到终端,终端会自动显示路径。

Framework 合成

  • 然后直接将 Debug-iphonesimulator(模拟器) 下的 TestFramework 也拖到终端。

Framework 合成

  • 接着输入 -output ,然后输入 空格

Framework 合成

  • 然后输入 ~/Desktop/NewTestFramework 后直接回车。

Framework 合成

  • 这时候桌面上会多一个新的文件为 NewTestFramework ,这时候将真机下的 .framework 包文件复制出来,然后将 NewTestFramework 重命名为 TestFramework 也就是 .framework 包中那个空白文件的名字,如果有 .lipo 后缀就去掉,接着替换 .framework 包中的那个空白文件。

Framework 合成

  • 最终替换完成后的 .framework 包就是我们最后所需要的包了,但是可以发现打包完后的 .framework 包里面是没有 CocoaPods 集成的第三方库的,所以在使用 .framework 包时,工程中必须也要集成 .framework 包中用到的第三方库,否则会找不到文件而报错。

测试打包完的 Framework

  • 新建一个测试工程 TestDemo ,将打包完的 TestFramework.framework 拖到工程中,测试一下刚才创建的 TestClass 类,可以看到 MBProgressHUD 加载框显示出来了,测试成功。

测试工程

  • 上面说了,测试工程中也要集成 MBProgressHUD ,否则会报错。

第三方库


主要步骤大概就是这样,如果有发现什么问题可以给我留言,希望能够帮助大家少走一些坑。

将来的你,一定会感激现在拼命的自己,愿自己与读者的开发之路无限美好。

我的传送门: 博客简书微博GitHub

如果觉得我的文章对您有用,请随意打赏吧,您的支持将鼓励我继续创作!
0%