如何部署 Framework 到 CocoaPods

CocoaPodsLogo.png

iOS 中常见的第三方库都可以通过 CocoaPods 集成到项目中,它们基本是开源的,但不妨有些商业项目,不希望源代码公开,只以 Framework 的形式发布,这时就需要考虑如何发布 Framework 包到 pod。

本文内容主要介绍如何部署 Framework 到 CocoaPods。

准备 Framework

关于如何创建 Framework 网上的教程已经很多了,这里就不再赘述了。值得注意的是即使在 Release 模式下,运行 Xcode 都只能编译出只支持真机或者模拟器的版本。

可通过以下两种方式集成全平台(Universal)版本。

手动合成

先编译出模拟器和真机的 Framework,用以下命令合成全平台包

lipo -create xxx/sdk-device xxx/sdk-simulator -output sdk-universal

lipo -info sdk-universal可查看支持的构架,如果为 i386, x86_64, armv7, arm64 即代表全平台支持。

注:armv7s 是 iPhone 5 的 CPU 构架,因为设备具有向下兼容的特性,所以只需包含 armv7 即可,还能减小 fat 包的大小 :)

自动合成

Xcode 新建 Target 选择 Cross-platform 分类中的 Aggregate, 添加依赖和脚本后能够编译全平台的 Framework。

Aggregate.jpg

具体可以参考这里

部署 Framework

Framework 制作完成后,将其压缩成 zip 包,并部署到能够公开访问的服务器上。可以放到自己的服务器,或者第三方服务器上,比如 GitHub release、又拍云等。只要最终能通过部署的 URL 下载该 zip 包即可。

制作 podsepc 文件

为了方便介绍将 Framework 名称取为: MyLib

在 framework 的工程目录下,执行 pod spec create MyLib创建 spec 文件。该目录下会生成一个 MyLib.podspec 文件。vi MyLib.podspec查看,每一行都对应有具体的解释。对每个条目有大致了解之后,填写好信息,删除所有 #注释的内容,类似于这样:

Pod::Spec.new do |s|
  s.authors      = "Tencent"
  s.name         = "Bugly"
  s.version      = "2.4.0"
  s.summary      = "Bugly iOS SDK"
  s.description  = "iOS library for Bugly Crash Report Service"
  s.homepage     = "http://bugly.qq.com/"
  s.license      = { :type => "Commercial", :text => "©2016 Tencent.com"}
  s.author       = { "Tencent" => "bugly@tencent.com" }
  s.source       = { :http => "http://softfile.3g.qq.com/myapp/buglysdk/Bugly-2.4.0.zip" }
  s.requires_arc = true  
  s.ios.deployment_target = '8.0'
  s.vendored_frameworks ='Bugly.framework'
  s.dependency 'Alamofire', '~> 1.0.0'
  end

详细的介绍可以参考这里,需要注意几点:

  1. s.version代表发布的 Framework 版本号,每次更新递增修改。
  2. s.source字段替换成前面的 zip 地址。
  3. s.vendored_frameworks改为自己 Framework 的名称。
  4. s.dependency代表依赖其它的库。

至此 spec 文件制作完毕,使用 pod lib lint 命令验证文件格式的正确性。

Framework 必须同时支持模拟器和真机否则会验证不通过。

提交 podspec 文件

提交 podspec,需要先注册一个 trunk 账户(如果提示网络失败,请使用梯子)

pod trunk register youremail@gmail.com 'Xiaofei Jiang' --description='macbook pro' --verbose

上面的命令邮箱和用户名需要替换成你自己的。

注册后 CocoaPods 会给你的邮箱发送验证链接,点击后就注册成功了,可以用 pod trunk me 命令查看自己的注册信息。

在提交 spec 文件前,如果发布的是 Swift 框架,需要指定 Swift 的版本,否则会报错,执行 echo "4.0" > .swift-version 即可指定版本为 4.0

最后,执行 pod trunk push MyLib.podspec提交 spec 文件到 Cocoapods。在后面附加 --verbose 可查看详细的进度。如果运气好没有报错的话就代表部署成功啦。

pod search MyLib搜索是否有刚刚提交的版本,如果没有,执行 rm ~/Library/Caches/CocoaPods/search_index.json删除缓存索引再尝试。

现在可以跟其他的第三方库一样,在 Podfile 文件中加入 「pod MyLib」,终端执行 pod update集成。

原理

整个过程看起来非常的简单,仅围绕着一个 spec 文件。那这个文件是干嘛用的呢?push trunk 又做了什么事情?

在安装 Cocoapods 的时候,会从 GitHub clone 一个仓库到本地目录 ~/.cocoapods/repos/master,该仓库维护这所有提交到 CocoaPods 的 spec 文件。

在执行 pod install时,就是从这个目录下找到 Podflie 中指定版本的第三方库的 spec 文件,并根据该文件中 s.source 字段为索引,找到真正的第三方库地址。

如果该地址存的是源代码,pod 会将代码下载下来添加到 Pods.xcodeproj 编译成 Framework,生成一个 target,并将这个 target 作为 Pod-xxx.framework 的依赖包。如果是 zip 包,则下载完成后直接解压,加入 Pods 工程。下载的源代码或者 zip 包会缓存在 ~/Library/Caches/CocoaPods目录下,如果版本没有更新的,下次 install 会直接从缓存获取。

对于安装 pods 的用户来说,spec 文件是安装第三方库的索引,它对使用者来说是透明的,只需关注 Podfile 文件即可。

对于 pod 的提供者,就需要提交 spec 文件给 CocoaPods,执行pod trunk push时,会先进行 pod lib lint验证。该验证过程会创建一个临时的工程文件,并使用这个 spec 文件,为其安装 pod 依赖,其实就是 pod install 的过程,如果能够编译链接成功,代表 spec 文件验证通过。详细的过程都可以在命令后面附加 --verbose 查看。

验证通过后的 spec 文件会 post 到 Trunk 服务器,Trunk 服务是 Cocoapods 团队开发的,每个人都可以在自己的账户下发布 pod,其他人没有权限修改。spec 以前以 ruby 的格式存储,现在以 json 的格式保存在 trunk 服务器上,并同步更新到 GitHub。

pod_trunk.png

全文完。

参考链接:
WWDC2014之iOS使用动态库
How to Create a Framework for iOS
Publish Your Pods on CocoaPods with Trunk
Getting setup with Trunk
CocoaPods Trunk
Cocoapods

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

推荐阅读更多精彩内容