前言
上次講了如何把自己的工具傳上Cocoapods上,然后pod下來使用,這樣能很便利的維護自己的工具庫。但是,Cocoapods上的庫大家都能訪問,自己的項目還行,如果是公司的,那就不能公開于眾,如果因為你公開的原因而使公司出現損失,你是要付責任的,所以要搭建自己的索引庫。
準備工作
在GitHub上,建立私有庫是要錢的,所以推薦下碼云吧,地址:https://gitee.com,可以免費私有庫。不過這邊也是相對安全,最好還是公司內網搭建下gitlab,我們寫demo當然沒關系,放在GitHub都無所謂的。我還是用GitHub公開演示吧。
本地私有庫
創建一個Classes
文件夾,里面放上你的工具類,你問我為什么叫Classes
,我只能說約定俗成吧,而且到后面快速下載模板的時候也是叫Classes
,如果你非要叫其他的名字也行,記得在spec
文件里修改就行。
然后在你Classes
的同級目錄下,建一個項目,一般用來測試你的組件化模塊的。
再然后創建描述文件,在終端進入文件夾,然后創建描述文件,pod spec create LocalTest
修改podspec
文件
Pod::Spec.new do |s|
s.name = "LocalTest"
s.version = "0.0.1"
s.summary = "LocalTest"
s.description = "A short description of LocalTest."
s.homepage = "http://EXAMPLE/LocalTest"
s.license = { :type => "MIT", :file => "FILE_LICENSE" }
s.author = { "harryphone" => "harryphone@163.com" }
s.source = { :git => "", :tag => "#{s.version}" }
s.source_files = "Classes", "Classes/**/*"
end
因為是本地的,所以除了s.source_files
外,其余都不是很重要。然后進入項目文件夾,pod init
創建podfile文件,修改文件。
pod ‘LocalTest’, :path => ‘../’
在pod跟上路徑就行(相對路徑),然后pod install
,在打開項目,你會發現
工具庫已經導進去了。
這個項目主要是用來測試自己的工具庫的,當確認沒有bug的時候,就可以傳到遠程,下面就會講遠程私有庫。(對了,如果你在Classes里加了新文件,不需要拖到測試項目里,只要讓測試項目pod更新下就行。)
快速創建組件
在上面,我們已經創建里一個工具組件,并且創建了測試工程測試。這樣場景經常發生,所以pod給我們提供了這樣一個模板下載,這樣能快速創建一個組件。現在重新開一個文件夾,嘗試下快速創建的Demo。命令:pod lib create SpeedTest
,最后一個組件名你隨便改。在生成模板的時候會問你幾個問題,自己翻譯下吧,就不多做解釋了。
回答完需求后就會很快生成一個項目。
你會看到在我們的組件(SpeedTest)文件里幫我們創建好了Classes
和Assets
,Assets
里可以放圖片。也幫我們建好了example的測試工程,連git管理也幫我們創建了。
我們就去GitHub創建名字一樣的組件庫,關聯下提交上去(本地關聯遠程庫git remote add origin 遠程地址
,并在第一次push的時候加上-u讓master建立關聯: git push -u origin master
)
等上傳完畢后可以修改spec文件了。
Pod::Spec.new do |s|
s.name = 'SpeedTest'
s.version = '0.1.0'
s.summary = 'SpeedTest.'
s.description = 'A description of SpeedTest.'
s.homepage = 'https://github.com/harryphone/SpeedTest'
s.license = { :type => 'MIT', :file => 'LICENSE' }
s.author = { 'harryphone' => 'harryphone@163.com' }
s.source = { :git => 'https://github.com/harryphone/SpeedTest.git', :branch => 'master' }
## 這里不支持ssh的地址,只支持HTTP和HTTPS,最好使用HTTPS
## 正常情況下我們會使用穩定的tag版本來訪問,如果是在開發測試的時候,不需要發布release版本,直接指向git地址使用
## 待測試通過完成后我們再發布指定release版本,使用如下方式
## s.source = { :git => 'https://github.com/harryphone/SpeedTest.git', :tag => s.version.to_s }
s.ios.deployment_target = '9.0'
s.source_files = 'SpeedTest/Classes/**/*'
# s.resource_bundles = {
# 'SpeedTest' => ['SpeedTest/Assets/*.png']
# }
# s.public_header_files = 'Pod/Classes/**/*.h'
# s.frameworks = 'UIKit', 'MapKit'
# s.dependency 'AFNetworking', '~> 2.3'
end
這里spec文件就比較嚴了,如果不合格會提交失敗的。所以需要用pod的工具驗證下,先是本地驗證pod lib lint
,結果出錯了:
其中warn說我沒有打tag值,紅色警告說我用了swift的代碼,明明全是OC的代碼(有點無語)。
第一個警告,可以在發布release版本時打上tag值并提交到遠程,注意tag值要和spec文件中version一致。現在嘛,忽略它,在命令后面加上后綴,變成這樣pod lib lint --allow-warnings
第二個問題,在終端里直接運行
`echo "4.1" > .swift-version`
4.1替換成你當前的swift版本
至于解釋嘛,給你來段英文的: It will create a swift version file in your pod-project folder. And then you can run the lint command to validate your podspec.
解決了這2個問題后,發現驗證通過了。
本地驗證通過后進行遠程驗證,代碼是:pod spec lint
,結果出錯,還是tag值的問題,所以忽略它,給命令加后綴:pod spec lint --allow-warnings
至此,一個組件就完成了。
建立私有索引庫
pod的管理,依賴于索引庫,我們可以在終端查看下有幾個索引庫pod repo
一般沒有建過的話,只有一個官方的。
接下來我們創建自己的索引庫。首先,在遠程創建一個庫,用來放索引庫的。隨便起個名,我這邊就叫STRepos了。創建完后與本地的索引庫關聯:pod repo add STRepos https://github.com/harryphone/STRepos.git
,關聯成功后再pod repo
,你就會發現多出來一個
這樣索引庫就好啦,現在我們要把工具庫中的spec文件傳給它后,我們就能使用了:pod repo push STRepos SpeedTest.podspec
這里提交到本地后自動會提交給遠程,我這里輸入了一次賬號和密碼。
我們也可以去本地看下文件:/Users/hyf/.cocoapods/repos/STRepos/SpeedTest/0.1.0/SpeedTest.podspec
(記得打開隱藏文件,遠程庫也有了,自己看下)
驗證下成果,pod search SpeedTest
,找下自己的庫,看下找不找的到(如果你成功了還是搜不到庫,把這個文件刪了,在搜下就有了:/Users/hyf/Library/Caches/CocoaPods/search_index.json
)
在主項目導入組件
到最后一步啦,建立一個主項目,創建一個podfile文件,將自己的工具庫pod進來。
# source 'https://github.com/harryphone/STRepos.git'
# source 'https://github.com/CocoaPods/Specs.git'
## 當沒有source的時候,默認都是官方的地址,就是https://github.com/CocoaPods/Specs.git。所以想要pod自己的私有庫時,需要寫上自己的索引庫地址。如果你還想要加上AFNetworking的話,官方的索引庫地址也得加上。
target 'MainAPP' do
pod 'SpeedTest', :source => ‘https://github.com/harryphone/STRepos.git’
end
結語
不出意外的話,一個自己的基礎組件就弄完了。等我累計了一定的組件化經驗后,我還會發一篇高級應用。