在上一篇分享的文章《如何制作一個令人愉悅的框架》中,我們有講到包依賴和管理工具:CocoaPods,今天我們就來談一談如何使用CocoaPods打包靜態(tài)庫。一般情況下我們使用CocoaPods來管理第三方開源類庫,但是我們也有可能存在這樣的需求:開發(fā)一個用CocoaPods來管理依賴關系的靜態(tài)庫給其他人使用,但是又不想公開源代碼,比如:SDK,那么我們就需要把他打成靜態(tài)庫。這篇文章以一個依賴AFNetworking 3.0的靜態(tài)庫來講述如何創(chuàng)建使用了CocoaPods的靜態(tài)庫以及打包的過程。
靜態(tài)庫的創(chuàng)建方式
1、通過Xcode提供的項目模板
2、使用CocoaPods自動創(chuàng)建
手動創(chuàng)建
1、在Xcode直接創(chuàng)建一個Cocoa Touch Static Library;
2、創(chuàng)建Podfile文件;
3、執(zhí)行pod install完成整個項目的搭建;
4、手動創(chuàng)建Demo程序,使用pod添加對私有靜態(tài)庫的依賴,再次執(zhí)行pod install完成Demo項目的搭建。
使用CocoaPods自動創(chuàng)建
以Core-JJSNetworking項目為例:
1、請確保已經正確安裝CocoaPods環(huán)境,之后步驟均建立在此基礎上進行,安裝請參考CocoaPods使用篇;
2、打開終端,執(zhí)行pod lib create Core-JJSNetworking, 接下來需要確認5個問題,如下
第一個問題是我們需要選擇的開發(fā)語言,這里我們選擇ObjC;
第二個問題是詢問是否包含一個Demo項目,一般會選擇Yes,不過這里我選擇了No...
具體說明你也可以參考官方文檔?Using Pod Lib Create,接下來終端正在自動執(zhí)行pod install (如果沒有自動執(zhí)行情看終端輸出的錯誤信息并修正好相關語法 ? ? ?后,在終端通過 cd 命令進入到 Example 目錄下,手動執(zhí)行 pod install 來讓你的 Demo 項目安裝依賴項)
3、我們的項目自動創(chuàng)建好了,通過xcworksapce打開項目,我們的目錄結構是這樣的(如果創(chuàng)建的時候選擇了Include a demo application的結構稍有不同):
4、打開 Core-JJSNetworking.podspec 文件,并修改配置信息,如下:
Pod::Spec.new do |s|
s.name= "Core-JJSNetworking"
s.version? ? ? ? ? = "0.1.0"
s.summary? ? ? ? ? = "A short description of Core-JJSNetworking."
s.description? ? ? = "Description of Core-JJSNetworking."
s.homepage ? ? ? ? = "https://github.com/KosonGou/Core-JJSNetworking"
# s.screenshots ? ? = "www.example.com/screenshots_1", "www.example.com/screenshots_2"
s.license? ? ? ? ? = 'MIT'
s.author ? ? ? ? ? = { "KS" => "kosonguo@gmail.com" }
s.source ? ? ? ? ? = { :git => "/Users/KS/Documents/Workspace/Library/Core-JJSNetworking_3.0.0", :tag => "0.1.0" }
s.platform ? ? = :ios, '7.0'
s.requires_arc = true
s.source_files = 'Core-JJSNetworking/Classes/**/*'
s.resource_bundles = {
'Core-JJSNetworking' => ['Core-JJSNetworking/Assets/*.png']
}
s.public_header_files = 'Pod/Classes/**/*.h'
s.frameworks = 'SystemConfiguration','MobileCoreServices','CoreGraphics'
s.dependency 'AFNetworking', '~> 3.0'
end
s.version 表示的是當前類庫的版本號;
s.source 表示當前類庫源;
s.sources_files 表示類庫的源文件存放目錄;
s.resource_bundles 表示資源文件存放目錄;
s.frameworks 表示類庫依賴的framework;
s.dependency 表示依賴的第三方類庫;
更多詳細說明,請參照Podspec Syntax Reference。
5、添加代碼類,需要值得注意的是:我們的 podspec 文件里面的指定的 s.source_files 是在 Pod/Classes 目錄下面,所以小伙伴的類文件一定不要存放錯了哦!代碼添加完畢后,可以運行一下 pod install 來讓 demo 程序加載剛剛新創(chuàng)建的類了。因為編輯器問題,這里簡單貼一下我的代碼吧,詳細代碼可到SVN上獲取。
6、如果你也包含了 Demo 項目的話,那就需要在項目中加入使用示例了。
7、提交源碼,打 tag。
8、使用 pod lib lint 驗證類庫是否符合 pod 的要求,可以使用 --allow-warnings 來忽略一些警告。
9、打包。此時你需要安裝一個 CocoaPods 打包插件
,安裝命令如下:
sudo gem install cocoapods-packager
安裝完成之后,就可以愉快地繼續(xù)打包了,在終端輸入如下命令(切記,此時你應該在你的項目根目錄下,即 podspec 文件所在目錄):
注意了,如果命令后面加條尾巴 ?--library 則表示打包成 .a 文件,如果不帶,則會打包成 .framework?文件。而 --force 則表示強制覆蓋之前存在的文件。下面 ? ? ?讓我們一起來見證奇跡吧,項目目錄下面多了一個?Core-JJSNetworking-0.1.0 的文件夾,這個便是插件幫我們打好的靜態(tài)庫了,而 .framework 文件是放在了 ios 目錄下面:
10、最后,小伙伴們可以使用打包好的靜態(tài)庫了。直接把靜態(tài)庫拖入到項目中,然后,加入指定的依賴項目即可。
寫在最后
歡迎大家加我好友,一起探討 iOS 開發(fā)相關的知識,如果你在開發(fā)過程中遇到什么 bug,也可以發(fā)給我一起解決。