組件化之遠程私有庫

前言

上次講了如何把自己的工具傳上Cocoapods上,然后pod下來使用,這樣能很便利的維護自己的工具庫。但是,Cocoapods上的庫大家都能訪問,自己的項目還行,如果是公司的,那就不能公開于眾,如果因為你公開的原因而使公司出現損失,你是要付責任的,所以要搭建自己的索引庫。

準備工作

在GitHub上,建立私有庫是要錢的,所以推薦下碼云吧,地址:https://gitee.com,可以免費私有庫。不過這邊也是相對安全,最好還是公司內網搭建下gitlab,我們寫demo當然沒關系,放在GitHub都無所謂的。我還是用GitHub公開演示吧。

本地私有庫

創建一個Classes文件夾,里面放上你的工具類,你問我為什么叫Classes,我只能說約定俗成吧,而且到后面快速下載模板的時候也是叫Classes,如果你非要叫其他的名字也行,記得在spec文件里修改就行。

image.png

然后在你Classes的同級目錄下,建一個項目,一般用來測試你的組件化模塊的。

image.png

再然后創建描述文件,在終端進入文件夾,然后創建描述文件,pod spec create LocalTest

image.png

修改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,在打開項目,你會發現

image.png

工具庫已經導進去了。

這個項目主要是用來測試自己的工具庫的,當確認沒有bug的時候,就可以傳到遠程,下面就會講遠程私有庫。(對了,如果你在Classes里加了新文件,不需要拖到測試項目里,只要讓測試項目pod更新下就行。)

快速創建組件

在上面,我們已經創建里一個工具組件,并且創建了測試工程測試。這樣場景經常發生,所以pod給我們提供了這樣一個模板下載,這樣能快速創建一個組件。現在重新開一個文件夾,嘗試下快速創建的Demo。命令:pod lib create SpeedTest,最后一個組件名你隨便改。在生成模板的時候會問你幾個問題,自己翻譯下吧,就不多做解釋了。

image.png

回答完需求后就會很快生成一個項目。


image.png

你會看到在我們的組件(SpeedTest)文件里幫我們創建好了ClassesAssetsAssets里可以放圖片。也幫我們建好了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,結果出錯了:

image.png

其中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個問題后,發現驗證通過了。


image.png

本地驗證通過后進行遠程驗證,代碼是:pod spec lint,結果出錯,還是tag值的問題,所以忽略它,給命令加后綴:pod spec lint --allow-warnings

image.png

至此,一個組件就完成了。

建立私有索引庫

pod的管理,依賴于索引庫,我們可以在終端查看下有幾個索引庫pod repo

image.png

一般沒有建過的話,只有一個官方的。
接下來我們創建自己的索引庫。首先,在遠程創建一個庫,用來放索引庫的。隨便起個名,我這邊就叫STRepos了。創建完后與本地的索引庫關聯:pod repo add STRepos https://github.com/harryphone/STRepos.git,關聯成功后再pod repo,你就會發現多出來一個

image.png

這樣索引庫就好啦,現在我們要把工具庫中的spec文件傳給它后,我們就能使用了:pod repo push STRepos SpeedTest.podspec

image.png

這里提交到本地后自動會提交給遠程,我這里輸入了一次賬號和密碼。

我們也可以去本地看下文件:/Users/hyf/.cocoapods/repos/STRepos/SpeedTest/0.1.0/SpeedTest.podspec(記得打開隱藏文件,遠程庫也有了,自己看下)

驗證下成果,pod search SpeedTest,找下自己的庫,看下找不找的到(如果你成功了還是搜不到庫,把這個文件刪了,在搜下就有了:/Users/hyf/Library/Caches/CocoaPods/search_index.json

image.png

在主項目導入組件

到最后一步啦,建立一個主項目,創建一個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

結語

不出意外的話,一個自己的基礎組件就弄完了。等我累計了一定的組件化經驗后,我還會發一篇高級應用。

?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 229,565評論 6 539
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,115評論 3 423
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 177,577評論 0 382
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,514評論 1 316
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,234評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,621評論 1 326
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,641評論 3 444
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,822評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,380評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,128評論 3 356
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,319評論 1 371
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,879評論 5 362
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,548評論 3 348
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,970評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,229評論 1 291
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,048評論 3 397
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,285評論 2 376

推薦閱讀更多精彩內容