一、安裝和使用Cocopods
網上已有很多教程,參考示例:CocoaPods安裝教程
二、組件庫支持Cocopods方式引入
1.創建遠程代碼倉庫
創建遠程代碼倉庫(並不是podspec文件的倉庫),此倉庫放的是源代碼。可以在GitHub上創建倉庫。
2.創建遠程podspec倉庫
如果要發佈到Cocopods的官方spec倉庫(公開的),那麼就不需要創建。當然私有庫是需要創建的,在這一步兩者不一樣。
公開庫參考示例:發佈開源庫到Cocopods官方倉庫
3.創建本地代碼工程
可以使用pod命令創建,得到一個工程模板,並且可以根據需要配置工程,如下:
- 命令創建工程模板
pod lib create <組件庫名>
- 工程配置選擇
- 選擇平臺
What platform do you want to use?? [ iOS / macOS ]
iOS
- 選擇語言
What language do you want to use?? [ Swift / ObjC ]
ObjC
- 是否自動生成一個用來做demo測試的模板庫,建議Yes,後面方便測試
Would you like to include a demo application with your library? [ Yes / No ]
Yes
- 是否集成測試框架
Which testing frameworks will you use? [ Specta / Kiwi / None ]
None
- UI 測試
Would you like to do view based testing? [ Yes / No ]
No
- 指定類前綴
What is your class prefix?
WT
4.編寫podspec文件
如果用第三步的命令創建工程模板,那麼在Podspec Metadata目錄下已經自動生成了。如果是已有的工程或者庫文件目錄,也可以利用Pod命令自己製作.podspec文件,命令如下:
pod spec cretae <組件庫名>
參考鏈接:podspec文件的具體說明
5.驗證cocoaPods索引文件
命令如下:
pod lib lint (從本地驗證你的pod能否通過驗證)
pod spec lint (從本地和遠程驗證你的pod能否通過驗證)
pod lib lint --verbose (加--verbose可以顯示詳細的檢測過程,出錯時會顯示詳細的錯誤信息)
pod lib lint --allow-warnings (允許警告,用來解決由於代碼中存在警告導致不能通過校驗的問題)
pod lib lint --help (查看所有可選參數,可選參數可以加多個)
6.本地測試庫是否可用
-
新建工程,切換到工程目錄,執行命令
pod init
-
修改podfile文件, 並添加上本地庫路徑
pod '庫名', :path => '/Users/xxx/Documents/庫名'
- 拉取pod代碼:成功後可看到我們的庫並沒有在pods裏面,而是在Development Pods裏面,可用先檢測代碼有沒有問題。
7.提交工程代碼
提交工程代碼到遠程代碼倉庫,可以利用git或者svn進行代碼版本管理,提交代碼到GitHub等
8.提交podspec文件
- 開源庫提交podspec文件到Cocopods官方倉庫, 當然需要現在ocopods官方倉庫中註冊賬號,命令如下:
pod trunk me (檢查是否註冊trunk)
pod trunk register <郵箱> <註冊名字> --verbose (註冊命令)
註冊完成之後會給你的郵箱發個郵件,進入郵箱郵件裏面有個鏈接,需要點擊確認一下.之後開始提交,切換到有.podspec文件的組件工程根目錄執行命令
pod trunk push <組件庫名>.podspec
pod trunk push <組件庫名>.podspec --allow-warnings
- 私有庫提交podspec文件到遠程podspec倉庫,和Cocopods官方庫不同的是,私有倉庫需要先添加到本地倉庫,再push到遠程倉庫,因爲Cocopods默認已經添加到了本地倉庫(默認爲master),Mac系統可以查看文件目錄(~/.cocoapods/repos), 私有庫命令如下:
-
添加到本地倉庫, [email protected]爲遠端podspec庫的地址,成功之後目錄(~/.cocoapods/repos)除了master之外,新增了一個文件夾(<組件庫名>)
pod repo add <組件庫名> [email protected]
-
查看是否添加成功
pod repo list
-
push到遠程podspec倉庫
pod repo push <podspec遠端倉庫名> <組件庫名>.podspec
9. 檢查倉庫是否發佈成功
pod搜索一下:
pod search <組件庫名>
如果報錯,搜索不到,建議更新下pod:
pod update
10. pod庫文件引入
如果是開源庫(公有的),修改podfile文件:
pod '組件庫名'
如果是私有倉庫,建議在podfile文件開頭添加source源:
source 'https://github.com/CocoaPods/Specs.git' #官方倉庫地址
source ‘http://xxx/組件庫.git’ #私有podspecs倉庫地址
最後執行命令進行安裝:
pod install