關(guān)于自定義framework的文章可參考上一篇寫的內(nèi)容自定義framework
本篇文章主要講已經(jīng)打包好的自定義framework上傳到cocoapods，讓別人可以方便的通過pods引入
一、確定是否有CocoaPods賬號
有的話請?zhí)^步驟一
1.1、注冊CocoaPods賬號
# pod trunk register 郵箱 昵稱
$ pod trunk register 1111111@qq.com 'mark'
#注冊之后，會收到驗證鏈接，點擊進行驗證即可
1.2、查看注冊信息
#查看賬號信息，執(zhí)行指令后，會得到相應(yīng)的信息，Pods中會顯示你已發(fā)布的庫
$ pod trunk me
#內(nèi)容類似下面這樣
# 查詢到的內(nèi)容
- Name: sherry
- Email: 405275657@qq.com
- Since: August 5th, 02:40
- Pods:
- LKLPaymentSdk
- Sessions:
- August 5th, 02:40 - Unverified. IP: 180.165.96.46
- August 5th, 02:41 - December 15th, 00:01. IP: 180.165.96.46
Description: 昵稱
二、創(chuàng)建git遠程倉庫
2.1 github創(chuàng)建工程
1>設(shè)置為public倉庫
2>License設(shè)置為MIT License
2.2 clone工程到本地
# 切換到指定位置
$ cd ~/pay_git
$ git clone https://github.com/englishsister/PaymentSdk.git
# 下載完成后 在工徎目錄下創(chuàng)建一個與工程名相同的目錄 PaymentSdk
# 將靜態(tài)庫PaymentSdk.framework放到新創(chuàng)建的PaymentSdk目錄中去
# 目錄結(jié)構(gòu)應(yīng)該是: ~/pay_git/PaymentSdk/PaymentSdk/PaymentSdk.framework
三. 配置.podspec文件
3.1創(chuàng)建podspec文件
#名字隨意取，但是要和podspec文件中的spec.name保持一致
# ~/pay_git/PaymentSdk
$ pod spec create LKLPaymentSdk
# 執(zhí)行結(jié)束后，生成一個LKLPaymentSdk.podspec 文件
# ~/pay_git /PaymentSdk/LKLPaymentSdk.podspec
161660027898_.pic.jpg
3.2 修改podspec文件參數(shù)
# 名稱 podspec文件名保持一致
spec.name = "LKLPaymentSdk"
# 版本號，要與 git tag 保持一致，每次提交要遞增
spec.version = "1.0.0"
# 簡介
spec.summary = "收銀臺XXXX"
# 詳細描述的言語字要多寫一點，文字只能在DESC中間,最好不要與summary一樣，會提示警告
spec.description = <<-DESC
SDK是xxx用來xxxx的工具包，其中提供大量的API用于幫助用戶開發(fā)設(shè)備的各項功能....盡量寫長一點。
DESC
# 項目主頁如果有些項目主頁，沒有寫 github上創(chuàng)建的工程地址
spec.homepage = "https://github.com/englishsister/PaymentSdk.git"
# 協(xié)議 MIT, 創(chuàng)建github工程的協(xié)議
spec.license = "MIT"
# 作者
spec.author = { "Owner" => "mark@163.com" }
# 指定運行平臺，iOS 9.0以上
spec.platform = :ios, "9.0"
# 源代碼位置 git里與hoepage保持一致就可以了, tag不要動，會自動獲取變量
spec.source = { :git => "https://github.com/englishsister/PaymentSdk.git", :tag => "#{spec.version}" }
#在上傳之前可以進行本地測試,稍后另起文章寫
spec.source = {:path=> '.'}
# 開放的頭文件，從工程根目錄下開始寫起
spec.source_files = "PaymentSdk/lakalaPaySDK.framework/Headers/*.{h,m}"
# 排除文件，沒有排除文件可不寫
# spec.exclude_files = "Example"
# SDK的路徑 寫上庫的位置 (自動生成沒有這一項，不寫會出錯)
spec.vendored_frameworks = 'PaymentSdk/lakalaPaySDK.framework'
# 依賴系統(tǒng)動態(tài)庫，有就寫，沒有就不要寫
spec.frameworks = "CFNetwork", "SystemConfiguration"
# 依賴系統(tǒng)靜態(tài)庫，省略其名稱的lib前綴，以及.后綴
spec.library = "z"
# 第三方依賴 有幾個就寫幾個，
# spec.dependency "JSONKit", "~> 1.4"
# 項目配置，注意這里的SDK不支持模擬器
# 如果多個字段就用逗號分開 { 'VALID_ARCHS' => 'x86_64 armv7 arm64', 'ENABLE_BITCODE' => 'NO' }
spec.pod_target_xcconfig = { 'VALID_ARCHS' => 'armv7 arm64' }
四、 項目提交到遠程倉庫
# 提交后要打標簽
$ git add --all 或者 $ git add .
$ git commit -m '代碼描述'
$ git push
# tag要與 spec.version 字段保持一致
$ git tag '1.0.0'
$ git push origin --tags
#如果上傳代碼有問題，可以刪除tag分支
#刪除本地tag分支
$git tag -d tagName
#刪除遠程tag分支
$git push origin :refs/tags/tagName
五、校驗 podspec文件
校驗過程中如果出錯，可百度進行搜索改正，保存再次校驗
# 校驗 pod spec lint xxx.podspec
$ pod spec lint LKLPaymentSdk.podspec
# 如果出錯 就執(zhí)行下面的命令，可以查看詳細信息
$ pod spec lint LKLPaymentSdk.podspec --verbose
# 如果只是警告可以加上 --allow-warnings 選項
$ pod spec lint LKLPaymentSdk.podspec --allow-warnings
#http://gonghonglou.com/2021/03/09/xcode12-lint-error/
$ pod spec lint LKLPaymentSdk.podspec --skip-import-validation
我校驗過程中出現(xiàn)過如下錯誤
file patterns: The `source_files` pattern did not match any file.
意思是source_files沒有匹配到文件，是因為剛開始忘記應(yīng)用vendored_frameworks（自己添加的framework了），導致找不到文件
修改之后，重新驗證
六、發(fā)布
# 發(fā)布
$ pod trunk push LKLPaymentSdk.podspec
# 執(zhí)行后出現(xiàn)如下結(jié)果就表示成功發(fā)布了
Updating spec repo `trunk`
?? Congrats
?? LKLPaymentSdk (1.0.0) successfully published
?? March 3rd, 19:49
?? https://cocoapods.org/pods/LKLPaymentSdk
?? Tell your friends!
發(fā)布時，碰到以下問題
問題1
pod spec lint LKLPaymentSdk.podspec --allow-warnings 時
RPC failed; curl 16 Error in the HTTP2 framing layer
解決方法：
方法1.直接重新執(zhí)行$ pod trunk push LKLPaymentSdk.podspec
方法2.
#設(shè)置git配置，嘗試強制git使用HTTP 1.1
先git config --global http.version HTTP/1.1
再重新執(zhí)行$ pod trunk push LKLPaymentSdk.podspec
方法3.
#設(shè)置git配置到HTTP2
git config --global http.version HTTP/2
再重新執(zhí)行$ pod trunk push LKLPaymentSdk.podspec
七、使用
上傳成功后，使用之前，先本地搜索,看是否能搜到
pod search LKLPaymentSdk
如果搜索不到，更新本地庫，更新成功在重新搜索，
pod repo update
#更新成功之后，還搜索不到，先刪除本地索引，再更新
rm~/Library/Caches/CocoaPods/search_index.json
pod repo update
#Note
如果pod repo update之后，pod search 能搜索到庫的最新版本，但是pod install 還是找不到,報錯類似下面這樣
CocoaPods could not find compatible versions for pod "LKLPaymentSdk":
In Podfile:
LKLPaymentSdk (~> 1.1.1)
None of your spec sources contain a spec satisfying the dependency: `LKLPaymentSdk (~> 1.1.1)`.
You have either:
* mistyped the name or version.
* not added the source repo that hosts the Podspec to your Podfile.
在Podfile 的頂部增加source 'https://github.com/CocoaPods/Specs.git'
就可以了
能夠成功搜索到后，引入到項目中進行使用
# 和使用其它第三方庫一樣
platform :ios, '10.0'
target 'Your app' do
use_frameworks!
pod 'HYManager-Swift'
end
八、更新
SDK有新的變化后，將新生成的靜態(tài)庫導入到當前工程中。
修改 podspec中的version字段為新的版本號，
提交到遠程倉庫(第四步)，注意tag要與新的版本號保持一致,
并上傳發(fā)布到pod上（第六步）
本文章參考一步一步上傳framework到CocoaPods,并做了部分修改
如有錯誤歡迎指出
