0.前言
現在越來越多的項目開始考慮組件化開發了,因此使得cocoapod搭建私有庫成為一個必備的首要的技能。如同很多技術一樣,搭建環境是最煩人的一步,相信很多人都會死在第一步搭建環境上。筆者我也是看著各種資料琢磨了半個多月終于搭起來的。看資料的過程是很煩人的,因為好多文章都是東拼西湊,感覺寫文章的人都沒有實際運行他寫的步驟,特別讓人討厭。因此我搭建的必須是親自一步步實踐過的。應該不讓您失望。
1.簡單介紹幾個概念
三方庫的目錄表specs:終端輸入cd ~/.cocoapods/repos/master
可看到里面放的都是一個個的podspec文件大小僅僅為幾KB,是三方庫的索引文件。
私有庫目錄表的遠程倉庫:是目錄表文件的遠程存放地址。
私有庫的遠程倉庫:這是我們自己寫的想作為一個組件的代碼。
行了就這三個概念,簡單吧。
2.開始上具體組件代碼
- 2.1 首先創建兩個遠程倉庫
這個AutoziBaseSpec倉庫只存放索引文件,占用很小就幾kb。
這個AutoziBase倉庫存放的代碼
- 2.2 把要寫具體代碼的倉庫拷下來,寫入具體的組件代碼
把實際代碼倉庫clone下來
cd Desktop/
git clone https://git.oschina.net/heeween/AutoziBase.git
- 2.3 我這里直接拷貝了我的一些base文件和分類文件
- 2.4 創建pod描述文件,讓組件代碼具有被cocoapod管理的能力
cd /Users/heew/Desktop/AutoziBase
pod spec create AutoziBase
這個時候會在桌面的項目文件中多了一個podspec文件
- 2.5 編輯podspec描述文件,主要就是講清楚你這個私有庫的地址和依賴關系等,下面是必須修改才能通過的地方
s.platform = :ios, "9.0"
s.source = { :git => "https://git.oschina.net/heeween/AutoziBase.git", :tag => "#{s.version}" }
s.source_files = "Base", "Category"
s.dependency 'Alamofire', '~> 4.0.1'
s.dependency 'SnapKit', '~> 3.0.2'
s.dependency 'SVProgressHUD', '~> 2.0.3'
s.dependency 'SwiftyJSON', '~> 3.1.1'
s.dependency 'Kingfisher', '~> 3.2.0'
我這里的組件化Base和Category里的代碼依賴了5個知名的三方庫,而alamofire在swift3.0中必須要求項目版本最低9.0,因此有了上面的設置。
- 2.6 設置完了以后,在終端中驗證下AutoziBase這個項目是否真的具有了被cocoapod管理的能力,注意要添加allow-warning才可以通過。
pod lib lint --verbose --allow-warnings
基本上設置了以前的幾個必要選項,基本上也沒其他關鍵設置了,所以應該就可以通過了。或者你也可以直接任意下載一個知名的第三方庫,cd到庫里,運行pod lib lint --verbose可以詳細看看別人的代碼具體是怎么通過驗證的。
- 2.7 給組件庫打tag,并上傳到git服務器,注意還是在AutoziBase代碼的目錄下執行一下命令
git add .
git commit -m "添加了base和category代碼"
git tag -a 0.0.1 -m "添加0.0.1tag"
git push origin --tags
git push
所有以上操作全是在操作組件化代碼,操作的目錄也都是在AutoziBase這個項目的目錄下。接著開始整項目索引文件
3.開始著手項目的索引文件
- 3.1把遠程spec復制到本地pod管理目錄文件夾中
pod repo add AutoziBaseSpec https://git.oschina.net/heeween/AutoziBaseSpec.git
cd ~/.cocoapods/repos/
open .
這時系統中.cocoapod的本地文件夾就出現了我們自己的項目索引文件AutoziBaseSpec文件
- 3.2一句代碼添加剛才驗證好的podsec到本地這個文件夾并且上傳到遠程目錄管理服務器
注意這個時候必須回到AutoziBase這個具體項目的目錄下來執行
cd /Users/heew/Desktop/AutoziBase
pod repo push AutoziBaseSpec AutoziBase.podspec --verbose --allow-warnings
- 必須回到AutoziBase具體項目的目錄下
- 雖然是git上傳但口令是pod repo push,不是git push
- AutoziBaseSpec寫的是項目索引的名稱,不是項目名稱
- AutoziBase.podspec 是具體項目的描述文件podspec,就是剛才驗證通過的文件
- 要加--allow-warnings 因為我們的描述文件有些不規范的地方
現在再看看項目描述遠程倉庫的樣子
到現在所有配置就結束了
4.怎么使用
- 4.1創建一個demo項目來用用吧
xcode創建一個demo名稱的工程,退出
cd /Users/heew/Desktop/demo
pod init
pod search AutoziBase
-
4.2搜索自己的私有庫
終端中搜索到自己的私有庫,這一步就很有成就感了,看圖
私有庫的介紹
這時編輯demo項目中多出的podfile文件,如下
- 4.3 編輯podfile
特別注意要添加兩個源,并且使用use_frameworks
source 'https://github.com/CocoaPods/Specs.git'
source 'https://git.oschina.net/heeween/AutoziBaseSpec.git'
target 'demo' do
use_frameworks!
pod 'AutoziBase', '~> 0.0.1'
end
- 4.4最后的安裝組件
終于到最后一步安裝了
pod install