1.安裝 cocoapods-repo-svn 插件(參考 https://github.com/dustywusty/cocoapods-repo-svn)
$ gem install cocoapods-repo-svn (如果出現(xiàn)權(quán)限問(wèn)題在指令前添加sudo)
2.制作基于 svn 的私有 sepc repo
使用 svn 管理,先在 svn 服務(wù)器上新建一個(gè)放 spec 的遠(yuǎn)程倉(cāng)庫(kù),本文以 yuntuchelian 命名,該倉(cāng)庫(kù)不需要?jiǎng)?chuàng)建標(biāo)準(zhǔn)的 trunk踢涌、tags通孽、branches 目錄,僅僅是放組件的 spec 文件的。(下圖為svn目錄)
使用該 yuntuchelian svn 地址建立私有 repo,命令行操作如下 pod repo-svn add yuntuchelian svn地址
使用pod repo查看repo信息和路徑(如下圖)
3.基本的組件化的創(chuàng)建
3.1 建立UserCenterModule的組件私有庫(kù)(下圖svn目錄)
使用 svn 管理,先在 svn 服務(wù)器上新建一個(gè) UserCenter 的倉(cāng)庫(kù),因?yàn)槭谴a文件且需要使用 tag,所以使用標(biāo)準(zhǔn)的 trunk睁壁、tags背苦、branches 目錄
3.2 使用 pod lib create UserCenterModule 命令來(lái)下載帶有默認(rèn)模板的庫(kù),之后基于默認(rèn)模板進(jìn)行修改,使用該命令后最回答幾個(gè)問(wèn)題,分別是姓名潘明、郵箱(用于 spec 文件中的作者信息)行剂、選擇語(yǔ)言(有 Swift 和 ObjC,這里選擇 ObjC)、是否需要 demo 工程(這個(gè)是需要的,利用這個(gè) demo 進(jìn)行組件測(cè)試)钳降、選擇測(cè)試庫(kù)(這里選 None)厚宰、do view based testing(這里選 No)
在 Finder 中,將 UserCenterModule 的核心文件復(fù)制到 demo 工程中的 UserCenterModule 下 Classes 文件夾下,并刪除模板文件 ReplaceMe.m,其中 Assets 文件夾下放與該組件有關(guān)的圖片等資源文件(文件中的.git等開(kāi)頭的文件刪除)
注意:Classes目錄文件里不要放.xcassets文件
命令行中 cd Example 工程目錄下,pod install 來(lái)更新工程的 CRProtocolManager 核心代碼
該工程目錄下 Podfile 文件中 pod 'CRProtocolManager', :path => '../' ,指向的外層文件夾下的 CRProtocolManager.podspec 文件,因此可以這樣添加刪除文件后使用pod install 來(lái)更新核心代碼到工程里
3.3 添加完核心代碼后,更改 UserCenterModule.podspec 文件(詳細(xì)UserCenterModule.podspec文件內(nèi)容在svn中查看)
一個(gè)是 s.version 這個(gè)和 svn 要打 tag 的編號(hào)是一致,例如s.version = ‘1.0.1’
一個(gè)是 s.source = {:svn =>'svn地址', :tag => s.version.to_s },原來(lái) s.source 是 git 地址,這里改為 svn 地址,指向 svn 代碼倉(cāng)庫(kù)牲阁。
s.source_files固阁、s.license、s.name(名字和svn倉(cāng)庫(kù)名城菊、創(chuàng)建的組件名最好統(tǒng)一)可保持不變
s.summary备燃、s.description、s.homepage凌唬、s.author 這些描述性的信息按需修改
3.4 將更改好的并齐、測(cè)試好的組件提交到 svn UserCenter 倉(cāng)庫(kù) trunk 下,注意:如果模板中有 .git 等文件夾刪掉漏麦。(我們使用的是 Cornerstone 管理工具)
對(duì)代碼進(jìn)行打 tag,且編號(hào)為 1.0.1,與 spec 文件里的 s.version 一致。
3.5 將 UserCenterModule.podspec 文件提交到之前制作好的私有 sepc repo 中
cd 到 UserCenterModule.podspec 所在目錄,使用pod repo-svn push yuntuchelian UserCenterModule.podspec
此時(shí) svn 倉(cāng)庫(kù)和 本地.cocoapods/repo/yuntuchelian 下都有 UserCenterModule.podspec
可在此之前進(jìn)行 spec 文件有效性檢查,pod repo-svn lint UserCenterModule.podspec
此時(shí)使用pod search UserCenterModule可以查看組件信息
4.使用 UserCenterModule 的私有庫(kù)組件
xcode 新建一個(gè)工程,使用pod init創(chuàng)建 Podfile 文件
Podfile文件內(nèi)容如下(以AF和UserCenterModule為例:)
注意:UserCenterModule的svn鏈接與上面UserCenterModule.podspec文件中的source鏈接一致
直接使用pod install 即可安裝 UserCenterModule 私有組件
踩過(guò)的坑:
一:podspec中的source鏈接填寫(xiě)到svn中trunk况褪,tags等所在的根目錄就行(如下圖:)
二:當(dāng)修改了UserCenterModule.podspec文件重復(fù)3.5不會(huì)更新svn 倉(cāng)庫(kù)和 本地.cocoapods/repo/yuntuchelian下的podspec文件(因此修改podspec文件后最好修改下target撕贞,重復(fù)3.4和3.5步驟)
三:使用cocoapods下載來(lái)的組件目錄沒(méi)有子目錄
要想實(shí)現(xiàn)UserCenterModule目錄下包含Login和ScanLogin目錄需要使用subspec來(lái)實(shí)現(xiàn)目錄分層
UserCenterModule.podspec中subspec寫(xiě)法如下
四:修改完UserCenterModule.podspec最好進(jìn)行 spec 文件有效性檢查,pod repo-svn lint UserCenterModule.podspec否則會(huì)導(dǎo)致pod install不下來(lái)UserCenterModule文件。
五:如果pod search UserCenterModule搜索不到,可到/user/mac02/Library/Caches/CocoaPods下刪除 search_index.json 文件后重試测垛。
六:庫(kù)包之間引用需要導(dǎo)入庫(kù)包和添加路徑(如下圖CommonalityModule需要引用其它庫(kù)需要導(dǎo)入其它四個(gè)framework)選中pods添加路徑
參考文章:
基于 svn 服務(wù)器及 cocoapods-repo-svn 插件進(jìn)行組件化私有庫(kù)的創(chuàng)建