【iOS 开发】利用 Carthage 将项目打包 Framework 并依赖 CocoaPods 第三方库的方法

最近需要将自己公司的项目的打包成 Framework 然后以 SDK 的形式来供客户使用,但是项目中用到不少 Cocoapods 第三方的库,怎么才能将项目打包 Framework 并依赖 CocoaPods 第三方库呢,网上找了很久都没有找到一篇专门说这个的,让我走了很多的坑,手动打包 Framework 太麻烦,开始尝试了 cocoapods-packager 方式打包,但是这个插件貌似对于 Swift 项目的支持并不是很好,尝试很久都没有打包成功,作者貌似也不是很活跃,无奈放弃,最后选择用 Carthage 方式来打包 Framework ,下面就分享一下利用 Carthage 将项目打包 Framework 并依赖 CocoaPods 第三方库的方法。


创建工程并打包 Framework

我这边演示的是 Swift 工程,Objective-C 也是一样的,演示Demo 我会保留,不懂的可以看一下。

1. 创建 Framework 工程

  • 新建一个工程或者在现有工程下创建一个新的 target ,类型需要选择 Coaoa Touch Framework ,这里说一下我的 Xcode 版本是 10.0.0

    image
  • 由于 Carthagebuild 时,会自动将设置为 Sharedframework target 构建成 framework ,所以需要单击顶部 target ,在弹出选项中选中 Manager Schemes ,将 framework targetShared 选项选中。

2. 创建 podfile 集成第三方库

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

  • 创建 podfile 并加入 pod 'Alamofire' ,然后执行 pod install ,然后选择工程下的 FrameworkDemo.xcworkspace 重新打开工程。

    image

3. 创建测试代码

  • 我这边创建了一个 TestAlamofire.swift 的测试文件,并在里面使用了 Alamofire 这个库,一会打包就打包这个文件。

  • 然后编译一下,编译通过,测试代码如下。

4. 构建 framework

  • 打开终端 cd 到工程目录下,执行以下命令开始打包 framework ,执行完成后会自动将 framework 文件保存在工程的 Carthage/Build/iOS 文件夹下。

    carthage build --no-skip-current
    
  • 到此 framework 就打包完成了,想了解更多关于 Carthage 打包的详情,可以看我另一篇文章:【iOS 开发】给自己项目添加 Carthage 支持的方法 ,方法基本一致,我这边就不详述了。

将 Framework 传到 Cocoapods 仓库

由于打包好的 framework 需要依赖 Alamofire 这个库,单独运行会报错,如果直接将 framework 给客户让客户自己依赖 Alamofire 的话,并不友好,所以打算将 framework 传到 Cocoapods 仓库,并指定 Alamofire 依赖库,这样客户直接 pod 我们封装好的库即可。

1. 创建 Git 仓库

  • 先创建一个 Git 仓库,仓库中必须包含一个 License 文件,类型为 MIT License
  • 接着 Clone 到本地,将刚才打包的 Framework 放进去,我这边就直接将测试工程放进去了。

2. 创建 podspec 文件

  • 在仓库目录下新建一个 podspec 文件,文件名就是 pod 库的名称,我这边叫 FrameworkDemo_Gzz.podspec ,或者使用以下命令创建。

    pod spec create FrameworkDemo_Gzz
    
  • 然后打开 podspec 文件,内容编辑如下,内容的具体意思我这边就不详述了。

    Pod::Spec.new do |s|
      s.name                      = 'FrameworkDemo_Gzz'
      s.version                   = '1.0.0'
      s.summary                   = '测试 Framework'
      s.homepage                  = 'https://github.com/Jonzzs/FrameworkDemo'
      s.license                   = { :type => 'MIT', :file => 'LICENSE' }
      s.author                    = { 'Jonzzs' => '292710547@qq.com' }
      s.source                    = { :git => 'https://github.com/Jonzzs/FrameworkDemo.git', :tag => s.version }
      s.platform                  = :ios
      s.ios.deployment_target     = '9.0'
      s.swift_version             = '4.0'
      s.ios.vendored_frameworks   = 'Carthage/Build/iOS/*.framework'
    
      # 依赖库
      s.dependency 'Alamofire'
    end 
    

3. 验证 podspec 文件

  • 编辑完成后,打开终端 cdpodspec 所在文件目录下,输入以下命令来验证编译是否通过。

    pod lib lint --allow-warnings --verbose
    
  • 验证通过会显示 FrameworkDemo_Gzz passed validation

4. 给项目打上 tag 并上传

  • podspec 文件验证成功后,先将改动后的文件 commit 提交,接着 push 推送到远程仓库 。

  • 因为 CocoaPods 是依赖项目的 tag 版本的,所以必须打上 tag 版本,执行以下命令打上 tag 版本,版本名必须要和之前podspec 文件中的 s.version 一致。

    git tag "1.0.0" // 为 git 提交打上 tag
    git push --tags // 将 tag 推送到远程仓库
    

5. 发布到 CocoaPods

  • 打开终端 cdpodspec 所在文件目录下,输入以下命令来发布到 CocoaPods

    pod trunk push *.podspec --allow-warnings
    
  • 发布成功会显示 successfully published

  • 到此就发布完成了,我这边讲的比较简单,如果发布 CocoaPods 遇到什么问题或者报错,可以看我的另一篇文章:【iOS 开发】创建 podspec 文件,给自己写的框架添加 CocoaPos 支持 ,我这边就不详述了。

测试 Framework 的 Pod 库

  • 新建一个测试工程 Test ,然后将刚才传到 CocoaPods 的库引入,然后执行 pod install

  • 可以看到 pod 将我们的 frameworkAlamofire 依赖库一起 pod 下来了。

  • 然后在控制器中 import FrameworkDemo 引入我们的库,执行库中用到 Alamofire 的一个方法。

  • 编译运行成功,打印结果正常。


演示Demo 在这,有不懂的地方可以看一下,希望能够帮助大家少走一些坑。

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

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

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,458评论 4 363
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,454评论 1 294
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 109,171评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,062评论 0 207
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,440评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,661评论 1 219
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,906评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,609评论 0 200
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,379评论 1 246
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,600评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,085评论 1 261
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,409评论 2 254
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,072评论 3 237
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,088评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,860评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,704评论 2 276
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,608评论 2 270

推荐阅读更多精彩内容