要解除循環依賴,引入包管理技術cocoapods會讓我們更有效率。pod不允許組件間有循環依賴,若有pod install時就會報錯。
cocoapods,提供私有pod repo,使用時把自己的組件放在私有pod repo里,然后在Podfile里直接通過pod命令集成。一個組件對應一個私有pod,每個組件依賴自己所需要的三方庫。多個組件聯合開發的時候,可以再一個podspec里配置子模塊,這樣在每個組件自己的podspec里,只需要把子模塊里的pod依賴關系拷貝過去就行了。
pod repo update命令。
有個場景,幾個人共同維護一個項目,Podfile也是共同維護一份。有一天其中一個人,升級了Podfile中某個庫的版本,比如AFNetworking從3.0.4升級到了3.1.0, pod 'AFNetworking', '~> 3.1.0’。然后,你更新了最新的Podfile,跑了一下pod install。。。。。。
1、先從pod install拋出的異常開始,如下圖:
**1.Github **
創建自己的Repository,我創建了SDKLib,然后從本地上傳到github上, 這些步驟就不在這里贅述了,經常跑github的同學應該都會。
**2 基于pod命令創建SDK **
具體的pod命令如下:
pod lib create SDKLib
調用以后terminal中會需要填寫以下問題,一般選擇創建Demo,其他選項根據需求填寫:
What languagedoyou want to use??[ Swift / ObjC ]
ObjC
Would you like toincludea demo application with your library? [ Yes / No ]
YES
Which testing frameworks will you use? [ Specta / Kiwi / None ]
None
Would you like todoview based testing? [ Yes / No ]
Yes
What is yourclassprefix?
SDK
第二種:(使用xcode手動創建靜態庫,網上比較多的版本,需要做一些配置,這里個人覺得太不方便,如果喜歡xcode自己創建的可以參考這篇http://www.lxweimin.com/p/e588bb0411d8)費力不討好的工程
3.建tag
打開終端,cd 到項目SDKLib目錄下,
git tag '1.0.0'//這個命令是本地創建tag,1.0.0版本
git push --tags // 這個命令是把tag推送到遠端。
4.創建項目的podspec文件
現在終端還是在項目QShare的目錄下,執行以下命令
$ pod spec createSDKLib
在本地目錄下同時也生成了SDKLib.podspec文件
打開項目可以開到工程里都給你配置好了 畫的地方就是你開發自己靜態庫文件編碼的地方(怎么打包成靜態庫,請往下看)這里因為特殊原因,一些文件不能展開
$ vim SDKLib.podspec
編輯podspec文件,會發現這個文件已經生成了部分的字段
以下是編輯好的podspec 文件 做一些解釋
Pod::Spec.new do |s|
s.name = 'SDKLib'
s.version = '0.4.9'
s.summary = 'A short description of SDKLib.'
s.platform = :ios
s.homepage = 'https://github.com/wangxiaokui'#
s.screenshots = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2's.license = { :type => 'MIT', :file => 'LICENSE' }
s.author = { 'xiaokui' => 'm18736056517@163.com' }
s.source = { :git => 'https://github.com/xiaokui/SDKLib.git', :tag => s.version}
s.source = { :git => '/Users/fan/SDKLib' } #加載本地自己的庫的引用
s.social_media_url = 'https://twitter.com/'
s.ios.deployment_target = '8.0'
s.source_files = 'SDKLib/Classes/*/'
s.resource_bundles = {
'SDKLib' => ['SDKLib/Assets/*.png']
}
s.public_header_files = 'Pod/Classes/*/.h'
s.frameworks = 'SystemConfiguration','MobileCoreServices','CoreGraphics','UIKit','AVFoundation','Photos','AdSupport','GLKit','MediaPlayer','MessageUI','CoreMotion','CoreTelephony'
s.dependency 'MBProgressHUD'
s.dependency 'MJExtension'
s.dependency 'SDWebImage'
s.dependency 'Masonry'
s.dependency 'MJRefresh'
s.dependency 'SVProgressHUD'
s.dependency 'Google-Mobile-Ads-SDK'
end
podspec中重要的幾個內容解釋如下:
s.source中是表示使用pod package打包時候pod去尋找的打包的路徑,podspec默認使用git commit tag作為路徑,也可以修改成本地路徑/Users/pp/Desktop/MyCustomLib,如果當前沒有設置:tag,打包時候默認使用當前git commit的head節點(如果部分修改內容沒有commit,那么使用git package不會將未commit的內容進行打包).
s.source_files表示具體的源碼的路徑,這里注意源碼一般放到Classes文件夾目錄下,而且實體文件中不要有非源碼內容放到Classes文件夾.Classes文件夾的所有內容都要Add Targets To: MyCustomLib.不要Classes文件夾或子文件夾中部分內容被remove referrence.
s.resource_bundles中的資源.系統會自動將MyCustomLib/Assets文件夾下的內容,cocoapod會將我們把Assets中的內容自動打包成MyCustomLib.bundle.這里也可以使用簡單的方式
1 在Assets文件夾中放入我們自己寫好的MyCustomLib.bundle,bundle中是我們使用的資源.
2 使用s.resource = 'MyCustomLib/Assets/*'.最后會將這些資源打入framework中.
3 在Example中手動引用我們自己創建的*.bundle資源文件.
s.public_header_files用來指定需要對外部暴露的頭文件的位置
s.frameworks和s.libraries,表示當前sdk依賴的系統的framework和類庫
s.dependency表示當前podspec類庫對外部第三方庫的依賴.如果使用pod package打包sdk時候,這里的dependency會被自動添加前綴,防止重復引用沖突.而且這里的依賴只能是pod庫(公有或者私有)的內容.
s.subspec用來引入我們sdk依賴的自己的framework或者.a等靜態庫
特別注意在.podspec 操作了s.dependency依賴了一些庫了后,就不需要再同一工程里使用podfile文件再次pod這些庫了,它們會沖突,同時需要理解.podspec 里一些配置的意思相信會解決你不少問題
編輯好podspec文件后,需要驗證一下這個文件是否能通過編譯。
$ pod spec lint SDKLib.podspec --verbose
然而并沒有通過
- ERROR | [iOS] Encountered an unknown error (The'Pods'target has transitive dependencies that include static binaries:
找了一些相關的,這個錯誤是因為依賴庫(s.dependency)包含了.a靜態庫造成的。雖然這并不影響Pod的使用,但是驗證是無法通過的。可以通過 --use-libraries 來讓驗證通過。使用以下的命令:
$ pod spec lint QShare.podspec --verbose --use-libraries
這種情況下使用 --use-libraries 雖然不會出現錯誤(error),但是有時候會帶來一些警告(waring),警告同樣是無法通過驗證的。這時可以用 --allow-warnings 來允許警告。
$ pod spec lint QShare.podspec --verbose --use-libraries --allow-warnings
這里針對自己的項目情況判斷添加那些命令通過了。
5、提交到pod (使用git命令,打上tag再次提交,版本號每次需要更新哦)這里不多說了
發布時也會驗證 Pod 的有效性,如果你在手動驗證 Pod 時使用了 --use-libraries 或 --allow-warnings 等修飾符,那么發布的時候也應該使用相同的字段修飾,否則出現相同的報錯。
發布成功后,
終于可以使用 pod search 搜索到自己的 Pod 了。
?fanpod search SDKLib
-> SDKLib (1.0.0)
Gather Some Auth Share Pay.
pod 'SDKLib', '~> 1.0.0'
Homepage: https://github.com/xiaokui/SDKLib
Versions: 1.0.0 [master repo]
6、版本升級
當需要更新 Pod 版本的時候,修改 .podspec 中的 s.version 為更高的版本號,并修改 s.source 中對應的 Git 版本。提交到Git,并打上對應tag。然后再次執行pod trunk push SDKLib.podspec將新的 .podspec 發布到 CocoaPods。更新完成!
為了更方便的修改版本號,用了以下的語句:
s.source = { :git => "https://github.com/xiaokui/SDKLib.git", :tag => "v#{s.version}" }
這樣與 s.version進行了綁定,每次提交新的版本只需要修改s.version = "xxxx"。
7:將源碼打包成靜態庫.a或者.framework
需要安裝cocoapods-packager.(安裝命令:sudo gem install cocoapods-packager)
然后執行pod package SDKLib.podspec --force --verbose.通過這個命令打包時候會自動將podspec中dependency的第三方庫進行重命名.這樣打出來的是SDKLib.framework.
(打release 的包默認打包成framework,如果在后面加上參數“--library”則打包成.a文件,--force是指強制覆蓋)前面資源文件都在SDKLib.framework/Reources/SDKLib.bundle里面可以手動把這個bundle拖出去.
前面提到過使用pod package打包時候需要注意.pod會根據當前podspec中的s.source的地址去查找當前sdk源文件的地址.如果使用的s.source = { :git => 'https://github.com/xiaokui/SDKLib.git', :tag => s.version.to_s },那么就會去git中拉取最后一個tag對應commit的源碼.如果使用的s.source = { :git => '/Users/fan/Desktop/SDKLib'},那么會使用當前sdk中git 的HEAD位置的commit的源碼進行打包編譯.(如果源碼有修改,一定要先git commit,然后再打包)
** 注意問題**
1、 重點問題一: Example中依賴某些類庫
舉例說明,如果SDKLib.podspec中依賴s.dependency 'AFNetworking', '~> 2.3',此時在Example中也需要使用AFNetworking,那么這里千萬不要在Example中引入AFNetworking的源碼,請在podfile中添加pod AFNetworking.
2、 重點問題二: SDK中依賴的第三方庫無法使用BITCODE
在Example的podfile底部添加以下語句:
// post_install do |installer|
// installer.pods_project.targets.each do |target|
// target.build_configurations.each do |config|
// config.build_settings['ENABLE_BITCODE'] = 'NO'
// end
// end
3 、重點問題三: SDK中調用資源的問題
對于podfile,常見的庫的地址引用寫法如下:
pod'庫名', :podspec =>'podspec文件路徑'#指定導入庫的podspec文件路徑pod'庫名', :git =>'源碼git地址'#指定導入庫的源碼git地址pod'庫名', :tag =>'tag名'#指定導入庫的Tag分支pod'庫名', :path =>'~/Documents/AFNetworking'#指定本地的某個庫,文件夾中要有podspec文件
用AFNetworking舉例:
// 使用倉庫中的master分支:pod'AFNetworking', :git=>'https://github.com/gowalla/AFNetworking.git'//使用倉庫的其他分支:pod'AFNetworking', :git=>'https://github.com/gowalla/AFNetworking.git', :branch=>'dev'//使用倉庫的某個tag:pod'AFNetworking', :git=>'https://github.com/gowalla/AFNetworking.git', :tag=>'0.7.0'//指定一個提交記錄:pod'AFNetworking', :git=>'https://github.com/gowalla/AFNetworking.git', :commit=>'082f8319af'//指定本地路徑的最近一次提交commitpod'庫名', :path=>'~/Documents/AFNetworking'
打包成功后會在SDKLib.podspec文件路徑下面生成一個打包文件,在iOS文件夾里面會看到生成的靜態庫包
8:可以驗證自己的pod地址了(這樣pod下來的是靜態庫源碼,你會發現自己開發的靜態庫文件,到pod文件下面了,具體需要你自己驗證一篇)
** 再次創建一個項目,在配置podfile文件在里面添加自己的git地址,pod install 試試 ,一路有坑,根據特定的情況解決問題 **
特別注意:
** 7和8是不一樣,7是打包看不到源碼,8是在git上pod的下來的源碼,如果想在git上pod下來是打包好的靜態庫不是開源的源碼,可以把靜態庫配置好..podspec上傳上git,你需要在git上重新建一個倉庫。**
為了解決這個異常可能嘗試一下:
(1)是不是Podfile和Podfile.lock 文件不同步?刪掉.lock文件再pod install一次,仍然報錯。
(2)是不是AFNetworking沒有3.1.0版本?pod search afnetworking一下,版本存在。
如果被我猜中了,證明你把焦點放在了異常前三行,而忽略了最關鍵的信息:None of your spec sources contain a spec satisfying the dependencies: AFNetworking (~> 3.1.0), AFNetworking (= 3.1.0)。
這句話的意思是說:你spec資源中不包含AFNetworking的3.1.0的配置信息。這里面有個關鍵詞,spec資源和配置信息。
然后最下面提醒pod repo update’ does not happen on ‘pod install’ by default。意思是默認情況下,執行pod install不會自動執行pod repo update命令。那么pod repo update做了什么?
2、pod repo update
簡單來說,pod repo update命名是用來更新本地cocoapods的spec資源配置信息。
安裝完cocoapods后,在用戶根目錄下有個隱藏文件夾,/Users//.cocoapods,里面是cocoapods收錄的所有庫的配置信息,/Users//.cocoapods/repos/master/Specs/。比如AFNetworking就是/Users//.cocoapods/repos/master/Specs/AFNetworking,內部分版本包含多個文件夾,每個文件夾內包含一個配置文件,比如AFNetworking.podspec.json。
上面報錯的原因就是,Podfile中AFNetworking的版本更新到了3.1.0,但是本地.cocoapods下找不到相應的配置文件。
然后按照提示,執行pod repo update,碰到網速慢的時候,命令執行完了就不動了,又被迫擺出葛優躺等著。
重點來了,pod repo update實際是更新整個.cocoapods下的所有庫,其實我們可以只更新其中某個庫來達到快速可用的目的。下面提供兩個方法解決:
(1)正規方法:
指定更新單獨庫pod repo update /Users//.cocoapods/repos/master/Specs/
(2)野路子:
如果方法1仍然無法解決問題,而又著急使用。可以直接到相應目錄下手動增加缺少的版本目錄和spec文件,/Users//.cocoapods/repos/master/Specs//3.2.0/.spec。spec文件參考git上相應庫的版本。
podspec
**1.Github **
創建自己的Repository,我創建了SDKLib,然后從本地上傳到github上, 這些步驟上面有,不過經常跑github的同學應該都會。
**2 基于pod命令創建SDK **
具體的pod命令如下:
pod lib create SDKLib
調用以后terminal中會需要填寫以下問題,一般選擇創建Demo,其他選項根據需求填寫:
What languagedoyou want to use??[ Swift / ObjC ]
ObjC
Would you like toincludea demo application with your library? [ Yes / No ]
YES
Which testing frameworks will you use? [ Specta / Kiwi / None ]
None
Would you like todoview based testing? [ Yes / No ]
Yes
What is yourclassprefix?
SDK
第二種:(使用xcode手動創建靜態庫,網上比較多的版本,需要做一些配置,這里個人覺得太不方便,如果喜歡xcode自己創建的可以參考這篇http://www.lxweimin.com/p/e588bb0411d8)費力不討好的工程
3.建tag
打開終端,cd 到項目SDKLib目錄下,
git tag '1.0.0'//這個命令是本地創建tag,1.0.0版本
git push --tags // 這個命令是把tag推送到遠端。
4.創建項目的podspec文件
現在終端還是在項目QShare的目錄下,執行以下命令
$ pod spec createSDKLib
在本地目錄下同時也生成了SDKLib.podspec文件
$ vim SDKLib.podspec
編輯podspec文件,會發現這個文件已經生成了部分的字段
以下是編輯好的podspec 文件 做一些解釋
Pod::Spec.new do |s|
s.name = 'SDKLib'
s.version = '0.4.9'
s.summary = 'A short description of SDKLib.'
s.platform = :ios
s.homepage = 'https://github.com/wangxiaokui'#
s.screenshots = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2's.license = { :type => 'MIT', :file => 'LICENSE' }
s.author = { 'xiaokui' => 'm18736056517@163.com' }
s.source = { :git => 'https://github.com/xiaokui/SDKLib.git', :tag => s.version}
s.source = { :git => '/Users/fan/SDKLib' } #加載本地自己的庫的引用
s.social_media_url = 'https://twitter.com/'
s.ios.deployment_target = '8.0'
s.source_files = 'SDKLib/Classes/*/'
s.resource_bundles = {
'SDKLib' => ['SDKLib/Assets/*.png']
}
s.public_header_files = 'Pod/Classes/*/.h'
s.frameworks = 'SystemConfiguration','MobileCoreServices','CoreGraphics','UIKit','AVFoundation','Photos','AdSupport','GLKit','MediaPlayer','MessageUI','CoreMotion','CoreTelephony'
s.dependency 'MBProgressHUD'
s.dependency 'MJExtension'
s.dependency 'SDWebImage'
s.dependency 'Masonry'
s.dependency 'MJRefresh'
s.dependency 'SVProgressHUD'
s.dependency 'Google-Mobile-Ads-SDK'
end
podspec中重要的幾個內容解釋如下:
s.source中是表示使用pod package打包時候pod去尋找的打包的路徑,podspec默認使用git commit tag作為路徑,也可以修改成本地路徑/Users/pp/Desktop/MyCustomLib,如果當前沒有設置:tag,打包時候默認使用當前git commit的head節點(如果部分修改內容沒有commit,那么使用git package不會將未commit的內容進行打包).
s.source_files表示具體的源碼的路徑,這里注意源碼一般放到Classes文件夾目錄下,而且實體文件中不要有非源碼內容放到Classes文件夾.Classes文件夾的所有內容都要Add Targets To: MyCustomLib.不要Classes文件夾或子文件夾中部分內容被remove referrence.
s.resource_bundles中的資源.系統會自動將MyCustomLib/Assets文件夾下的內容,cocoapod會將我們把Assets中的內容自動打包成MyCustomLib.bundle.這里也可以使用簡單的方式
1 在Assets文件夾中放入我們自己寫好的MyCustomLib.bundle,bundle中是我們使用的資源.
2 使用s.resource = 'MyCustomLib/Assets/*'.最后會將這些資源打入framework中.
3 在Example中手動引用我們自己創建的*.bundle資源文件.
s.public_header_files用來指定需要對外部暴露的頭文件的位置
s.frameworks和s.libraries,表示當前sdk依賴的系統的framework和類庫
s.dependency表示當前podspec類庫對外部第三方庫的依賴.如果使用pod package打包sdk時候,這里的dependency會被自動添加前綴,防止重復引用沖突.而且這里的依賴只能是pod庫(公有或者私有)的內容.
s.subspec用來引入我們sdk依賴的自己的framework或者.a等靜態庫
特別注意在.podspec 操作了s.dependency依賴了一些庫了后,就不需要再同一工程里使用podfile文件再次pod這些庫了,它們會沖突,同時需要理解.podspec 里一些配置的意思相信會解決你不少問題
編輯好podspec文件后,需要驗證一下這個文件是否能通過編譯。
$ pod spec lint SDKLib.podspec --verbose
然而并沒有通過
- ERROR | [iOS] Encountered an unknown error (The'Pods'target has transitive dependencies that include static binaries:
找了一些相關的,這個錯誤是因為依賴庫(s.dependency)包含了.a靜態庫造成的。雖然這并不影響Pod的使用,但是驗證是無法通過的。可以通過 --use-libraries 來讓驗證通過。使用以下的命令:
$ pod spec lint QShare.podspec --verbose --use-libraries
這種情況下使用 --use-libraries 雖然不會出現錯誤(error),但是有時候會帶來一些警告(waring),警告同樣是無法通過驗證的。這時可以用 --allow-warnings 來允許警告。
$ pod spec lint QShare.podspec --verbose --use-libraries --allow-warnings
這里針對自己的項目情況判斷添加那些命令通過了。
5、提交到pod (使用git命令,打上tag再次提交,版本號每次需要更新哦)這里不多說了
發布時也會驗證 Pod 的有效性,如果你在手動驗證 Pod 時使用了 --use-libraries 或 --allow-warnings 等修飾符,那么發布的時候也應該使用相同的字段修飾,否則出現相同的報錯。
發布成功后,
終于可以使用 pod search 搜索到自己的 Pod 了。
?fanpod search SDKLib
-> SDKLib (1.0.0)
Gather Some Auth Share Pay.
pod 'SDKLib', '~> 1.0.0'
Homepage: https://github.com/xiaokui/SDKLib
Versions: 1.0.0 [master repo]
6、版本升級
當需要更新 Pod 版本的時候,修改 .podspec 中的 s.version 為更高的版本號,并修改 s.source 中對應的 Git 版本。提交到Git,并打上對應tag。然后再次執行pod trunk push SDKLib.podspec將新的 .podspec 發布到 CocoaPods。更新完成!
為了更方便的修改版本號,用了以下的語句:
s.source = { :git => "https://github.com/xiaokui/SDKLib.git", :tag => "v#{s.version}" }
這樣與 s.version進行了綁定,每次提交新的版本只需要修改s.version = "xxxx"。
7:將源碼打包成靜態庫.a或者.framework
需要安裝cocoapods-packager.(安裝命令:sudo gem install cocoapods-packager)
然后執行pod package SDKLib.podspec --force --verbose.通過這個命令打包時候會自動將podspec中dependency的第三方庫進行重命名.這樣打出來的是SDKLib.framework.
(打release 的包默認打包成framework,如果在后面加上參數“--library”則打包成.a文件,--force是指強制覆蓋)前面資源文件都在SDKLib.framework/Reources/SDKLib.bundle里面可以手動把這個bundle拖出去.
前面提到過使用pod package打包時候需要注意.pod會根據當前podspec中的s.source的地址去查找當前sdk源文件的地址.如果使用的s.source = { :git => 'https://github.com/xiaokui/SDKLib.git', :tag => s.version.to_s },那么就會去git中拉取最后一個tag對應commit的源碼.如果使用的s.source = { :git => '/Users/fan/Desktop/SDKLib'},那么會使用當前sdk中git 的HEAD位置的commit的源碼進行打包編譯.(如果源碼有修改,一定要先git commit,然后再打包)
** 注意問題**
1、 重點問題一: Example中依賴某些類庫
舉例說明,如果SDKLib.podspec中依賴s.dependency 'AFNetworking', '~> 2.3',此時在Example中也需要使用AFNetworking,那么這里千萬不要在Example中引入AFNetworking的源碼,請在podfile中添加pod AFNetworking.
2、 重點問題二: SDK中依賴的第三方庫無法使用BITCODE
在Example的podfile底部添加以下語句:
post_install do |installer|
installer.pods_project.targets.each do |target|
target.build_configurations.each do |config|
config.build_settings['ENABLE_BITCODE'] = 'NO'
end
end
3 、重點問題三: SDK中調用資源的問題
對于podfile,常見的庫的地址引用寫法如下:
pod'庫名', :podspec =>'podspec文件路徑'#指定導入庫的podspec文件路徑pod'庫名', :git =>'源碼git地址'#指定導入庫的源碼git地址pod'庫名', :tag =>'tag名'#指定導入庫的Tag分支pod'庫名', :path =>'~/Documents/AFNetworking'#指定本地的某個庫,文件夾中要有podspec文件
用AFNetworking舉例:
// 使用倉庫中的master分支:pod'AFNetworking', :git=>'https://github.com/gowalla/AFNetworking.git'//使用倉庫的其他分支:pod'AFNetworking', :git=>'https://github.com/gowalla/AFNetworking.git', :branch=>'dev'//使用倉庫的某個tag:pod'AFNetworking', :git=>'https://github.com/gowalla/AFNetworking.git', :tag=>'0.7.0'//指定一個提交記錄:pod'AFNetworking', :git=>'https://github.com/gowalla/AFNetworking.git', :commit=>'082f8319af'//指定本地路徑的最近一次提交commitpod'庫名', :path=>'~/Documents/AFNetworking'
打包成功后會在SDKLib.podspec文件路徑下面生成一個打包文件,在iOS文件夾里面會看到生成的靜態庫包
8:可以驗證自己的pod地址了(這樣pod下來的是靜態庫源碼,你會發現自己開發的靜態庫文件,到pod文件下面了,具體需要你自己驗證一篇)
** 再次創建一個項目,在配置podfile文件在里面添加自己的git地址,pod install 試試 ,一路有坑,根據特定的情況解決問題 **
特別注意:
** 7和8是不一樣,7是打包看不到源碼,8是在git上pod的下來的源碼,如果想在git上pod下來是打包好的靜態庫不是開源的源碼,可以把靜態庫配置好..podspec上傳上git,你需要在git上重新建一個倉庫。**