Cocopods基礎使用

一、安裝和使用Cocopods

網上已有很多教程,參考示例:CocoaPods安裝教程

二、組件庫支持Cocopods方式引入

1.創建遠程代碼倉庫

創建遠程代碼倉庫(並不是podspec文件的倉庫),此倉庫放的是源代碼。可以在GitHub上創建倉庫。

2.創建遠程podspec倉庫

如果要發佈到Cocopods的官方spec倉庫(公開的),那麼就不需要創建。當然私有庫是需要創建的,在這一步兩者不一樣。
公開庫參考示例:發佈開源庫到Cocopods官方倉庫

3.創建本地代碼工程

可以使用pod命令創建,得到一個工程模板,並且可以根據需要配置工程,如下:

  1. 命令創建工程模板
pod lib create <組件庫名>
  1. 工程配置選擇
  • 選擇平臺
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文件

  1. 開源庫提交podspec文件到Cocopods官方倉庫, 當然需要現在ocopods官方倉庫中註冊賬號,命令如下:
pod trunk me (檢查是否註冊trunk)
pod trunk register <郵箱> <註冊名字> --verbose (註冊命令)

註冊完成之後會給你的郵箱發個郵件,進入郵箱郵件裏面有個鏈接,需要點擊確認一下.之後開始提交,切換到有.podspec文件的組件工程根目錄執行命令

pod trunk push <組件庫名>.podspec
pod trunk push <組件庫名>.podspec --allow-warnings
  1. 私有庫提交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

三、Cocopods打包靜態庫

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章