美文网首页CocoaPods frameworkiOS学习交流iOS
【iOS 开发】打包 Framework 时使用 CocoaPo

【iOS 开发】打包 Framework 时使用 CocoaPo

作者: 爱吃鸭梨的猫 | 来源:发表于2017-06-02 13:19 被阅读4009次
Framework

最近需要将自己项目的公共代码打包成 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

相关文章

网友评论

  • 咸鱼永动机:这种依赖外部pod的方式是不是不可靠,主工程中的pod是会有更新的可能性的,如果SDK依赖的pod发生了调用方式改变这种特殊情况,那SDK不就废了吗,博主使用这种方式打包给第三方调用没发生问题此类问题吗
    咸鱼永动机:@Jonzzs 那对于这种需要集成第三方的场景,你们使用的是什么方式呢?静态库改类名?说起来我使用动态库直接拖入第三方库是可以在主项目也包含此三方库的情况下运行的,但是会有一些异常日志,运行正常.想问一下,你们采取的是什么方式呢~
    爱吃鸭梨的猫:@傲娇很痛苦 这个问题的确有,所以一般不建议采取这种方案。
  • 爱吃麦子的鱼:你好我想问一下,如果封装的framework里使用了微信支付的SDK,该如何实现让这个framework支持coccoapods导入。
    爱吃麦子的鱼:@Jonzzs 没有关系,嘻嘻
    爱吃鸭梨的猫:@_安然i 微信支付的SDK没试过,感觉应该不行吧,我也没有去深入研究,就是公司之前刚好需要打包framework就顺手记录一下,你这个可能帮助不了你哦,你再查一下资料吧,不好意思啦。
  • LD_左岸:如果是上线到App Store的版本中 我只需要把真机下编译的frameWork导入项目即可吧
    完全不必导入<模拟的和真机的合并成的包含i286 X86_64 arm7 arm7s arm64的大包>吧
    因为商店下载下来的用户只可能是arm7 arm7s arm64的架构 不可能用到模拟机的架构
    如果把模拟机的打进去 浪费空间啊
    LD_左岸:@Jonzzs OK 那我就给他两份 一个真机的 一个模拟机和真机合并后的 他如果到了上商店前的fim或者testFligt的测试阶段 就真能真机测了 包括之后上到商店里..
    爱吃鸭梨的猫:@左岸__ 如果你用不到模拟器调试,可以只打真机的,但是一般打包framework都是给别人用的,得保证别人可以用模拟器调试,可以根据自己需求来,都是可控的。
  • LD_左岸:您这个有没有试过 在一个xcode项目里 同时集成framework的工程和测试framework的工程 这样你写的framework的代码可以随时测试...
    我用您文章里的做法解决了 我的framework工程引用AFN
    同时测试framework的工程也引入AFN的问题
    但是当我把<framework工程>和<测试framework的工程>集成到一个xcode项目里 并且用cocopods进行管理的情况下 不可用 模拟机无限重启
    但是如果不用cocopods管理 是可以的
    但是 同时用到AFN又不知道咋处理了
    KeepMoveingOn:@luLou 用workspace然后测试工程依赖framework编译,再引入framework产生的.framwork文件。网上有教程,你可以搜下"framework包含第三方库"关键字,应该搜的到
    Veness_:@左岸__ 你好,你是怎么集成<framework工程>和<测试framework的工程>集成到一个xcode项目里,可以知道一下么
    LD_左岸:sorry 解决了 是podfile没写好
  • First灬DKS:博主你好:如果framework中用到的第三方,但是主工程中没有使用这个第三方,怎么去解决呢?
  • 摩羯小猪:我现在用了一个YYModel 但会提示 include of non-modular header inside framework module ‘*****’
  • amove_xu:如果你的framework跟第三方同时都存在MBProgressHUD,但是两个的版本不一致,会不会有冲突
  • 简简728:有demo吗
    爱吃鸭梨的猫:demo 被我删了,我过程写的已经很清楚啦。
  • 简简728:如果第三方库里有bundle类型 会有影响吗

本文标题:【iOS 开发】打包 Framework 时使用 CocoaPo

本文链接:https://www.haomeiwen.com/subject/ocoefxtx.html