目錄
一、前面部分是創建本地庫,這里省略
二、發布版本 -- 發布到公司內網
三、發布版本 -- 發布到外網
四、打包framework
五、遇到的錯誤
一、前面部分是創建本地庫,這里省略
有需要的可以參考簡書的文章:http://www.lxweimin.com/p/7d1533fc6ce7
以下介紹的內容為創建本地私有庫后,怎么向遠程庫發布版本,以期最后可以通過pod search xxx、pod install方式安裝自己的遠程庫到項目;
以及發布遠程版本過程中遇到的問題,以及解決方法;
二、發布版本 -- 發布到公司內網
1、創建私有庫
在內網 Git 創建一個空的倉庫,用來存放私有庫;-- 我們這里是網絡配置管理幫我們創建好的,這一步省略,有需要的可自行搜索,網上資料很多;
2、提交代碼,打tag
(1)克隆這個項目WztFoundation
到本地,指令:$ git checkout clone https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoundation.git
(2)使用命令創建模板項目:$ pod lib create WztFoundation
按照步驟提示,創建模版組件項目;
(3)用 XCode打開 WztFoundation
.podspec,進行修改
podspec文件修改并通過校驗
……(略)
(4)提交代碼修改
$ git add .
$ git commit -m "WztFoundation first commit"
(5)打tag并推送到gitlab遠程私有庫
git tag -m "version 0.1.5.9" 0.1.5.9
git push --tags
3、本地檢測
指令:
$ pod spec lint WztFoundation.podspec --allow-warnings --verbose --no-clean --use-libraries --skip-import-validation
如果有警告,會導致無法通過,需要添加--allow-warnings
如果使用了 C 函數相關的,需要添加--use-libraries
如果導入的私有庫有動態庫/靜態庫,有些C++的代碼會導致pod命令編譯找不到頭文件問題,而真機調試卻正常,解決方法:--skip-import-validation
本地檢測--指令:
// 本地檢測
$ pod lib lint WztFoundation.podspec --allow-warnings --verbose --no-clean --use-libraries --skip-import-validation
// 或者使用者一條指令
$ pod spec lint WztFoundation.podspec --allow-warnings --verbose --no-clean --use-libraries --skip-import-validation
4、產生私有庫
$ pod repo add WztFoundation 'https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoundation.git'
把內網倉庫 WztFoundation
添加到CocoaPods本地倉庫,這步操作會在 ~/.cocoapods/repo 路徑下創建一個名字為 WztFoundation
的空文件夾;
指令:
$ pod repo add WztFoundation 'https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoundation.git' master`
$ pod repo push `WztFoundation` WztFoundation.podspec --allow-warnings --verbose --use-libraries --skip-import-validation`
4.1遇到的問題總結:
pod repo add命令后,可以通過pod repo可以查看剛剛添加的本地庫信息:
$ pod repo
WztFoundation
- Type: git (master)
- URL: /Users/wzt/.cocoapods/repos/master
- Path: /Users/wzt/.cocoapods/repos/WztFoundation
WztFoundation https:
- Type: file system
- URL:
- Path: /Users/wzt/.cocoapods/repos/WztFoundation https:
master
- Type: git (remotes/origin/master)
- URL: [https://github.com/CocoaPods/Specs.git](https://github.com/CocoaPods/Specs.git)
- Path: /Users/wzt/.cocoapods/repos/master
volcengine-volcengine-specs
- Type: git (master)
- URL: [https://github.com/volcengine/volcengine-specs.git](https://github.com/volcengine/volcengine-specs.git)
- Path: /Users/wzt/.cocoapods/repos/volcengine-volcengine-specs
4.1.1 WztFoundation路徑下,config文件url為空?
不知道什么原因,只知道url需要修改為我們的遠程私有庫地址:https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoundation.git
4.1.2 報錯:
Validating spec
Cloning spec repo `-1` from ``
$ /usr/bin/git clone -- -1
fatal: repository '' does not exist
[!] Unable to add a source with url `` named `-1`.
(/usr/bin/git clone -- -1
fatal: repository '' does not exist
)
You can try adding it manually in `/Users/wzt/.cocoapods/repos` or via `pod repo add`.
以上是報錯信息,下方是問題分析及解決方法 :
(1)~/.cocoapods/repos/WztFoundation/config文件下url為https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoudnation.git
再次pod repo push
依然失敗...
(2)直到看到這篇資料:https://github.com/CocoaPods/CocoaPods/issues/8315
說是因為pod repo list,有的repo更新失敗導致的,需要刪掉一些沒用的repo,比如一些url為空的repo;
再次執行,成功~
成功后打印:
WztFoundation passed validation.
Adding the spec to the `SpecRepo' repo
$ /usr/bin/git -C /Users/wzt/.cocoapods/repos/SpecRepo status --porcelain
- [No change] WztFoundation (0.1.5.9)
Pushing the `SpecRepo' repo
$ /usr/bin/git -C /Users/wzt/.cocoapods/repos/SpecRepo push origin HEAD
To [https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoundation.git](https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoundation.git)
1244815..3613322 HEAD -> master
5、項目中引用私有庫
在 podfile 文件中添加 source 參考:
source 'https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoundation.git'
source 'https://github.com/CocoaPods/Specs.git'
target 'xxxx' do
pod 'WztFoundation'
end
三、發布版本 -- 發布到外網
1、提交修改
$ git add .
$ git commit -m "changes' description"
2、驗證本地.podspec 文件的有效性
$ pod lib lint WztFoundation.podspec --allow-warnings --verbose --no-clean --use-libraries --skip-import-validation
##或者
$ pod spec lint WztFoundation.podspec --allow-warnings --verbose --no-clean --use-libraries --skip-import-validation
打印表示成功:WztFoundation passed validation.
3、推到 pod 上
$ pod trunk push WztFoundation.podspec --allow-warnings --verbose --use-libraries --skip-import-validation
成功后打印:
- Log messages:
- May 4th, 06:11: Push for `WztFoundation 0.1.5.5' initiated.
- May 4th, 06:11: Push for `WztFoundation 0.1.5.5' has been pushed (0.428640813 s).
3.1 error
Error: Authentication token is invalid or unverified. Either verify it with the email that was sent or register a new session.
解決方法--注冊 CocoaPods 的 Trunk 服務:
$ pod trunk register [wzt@wztcom.com](mailto:wzt@wztcom.com) 'A21001' --verbose
行完以下命令,去郵箱點擊 Trunk 驗證鏈接。
查詢注冊信息。
$ pod trunk me
3.2 error
[!] An unexpected error occurred: <!DOCTYPE html>
解決方法:
https://github.com/CocoaPods/CocoaPods/issues/11621
這個問題上說,這一步會有50%的成功概率,要多嘗試幾次
然后會有概率遇到另外一個錯誤:"error":"Unable to accept duplicate entry for: WztFoundation (0.1.5.4)"
3.3 error
"error\":\"Unable to accept duplicate entry for: WztFoundation (0.1.5.4)\"
解決方法:
$ pod trunk delete WztFoundation 0.1.5.4 --allow-warnings --verbose
然后繼續重試~
成功后打印信息:
Push for `WztFoundation 0.1.5.4' has been pushed (0.421013575 s).
4.可以新建一個項目測試一下自己的庫是否發布成功
pod search 一下自己的類庫
$ pod search WztFoundation
成功打印:
-> WztFoundation (0.1.5.6)
A short description of WztFoundation.
pod 'WztFoundation', '~> 0.1.5.6'
- Homepage: [https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoundation](https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoundation)
- Source: [https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoundation.git](https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoundation.git)
- Versions: 0.1.5.6, 0.1.5.5, 0.1.5.4 [master repo]
4.1 error:Unable to find a pod with name, author, summary, or description matching WztFoundation
解決方法:
$ pod setup
$ rm -rf ~/Library/Caches/Cocoapods
$ pod search WztFoundation
4.2 error
依然報錯:Unable to find a pod with name, author, summary, or description matching WztFoundation
解決方法:
cd ~/.cocoapods/repos
pod repo remove master
pod repo add master [https://github.com/CocoaPods/Specs.git](https://github.com/CocoaPods/Specs.git)
pod repo add master https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoundation.git
rm ~/Library/Caches/CocoaPods/search_index.json
四、打包framework
1、pod命令package
2、Xcode項目添加xcodbuild命令
五、遇到的錯誤
1、創建私有庫后,pod install時報Classes和Assets的錯誤
https://juejin.cn/post/6952753809974099982
2、[!] An unexpected version directory Classes
was encountered for the 'xxxx'
或者使用這種方法解決,簡單快捷
pod 'WztFoundation', :git => "https://gitlab.wztcom.com/NewEnergy/IOSAPP/WztFoundation.git", :tag => '0.1.6.0'
參考資料:
CocoaPods公有庫和私有庫制作 https://blog.csdn.net/Johncahong/article/details/123426980
(CocoaPods) - 在內網搭建私有庫 http://www.lxweimin.com/p/89e22651952f