如果你希望把自己的 GitHub 代碼變成一個可被 CocoaPods 安裝的庫,需要完成 podspec 創建、標籤發佈、trunk 註冊與上傳驗證等步驟。本文以一個示例庫 ZGRSAEncryptor 為例,梳理完整流程。

首先在 GitHub 創建倉庫,並選擇合適的 License。示例中選擇 MIT License,後續 podspec 中會用到。

將代碼克隆到本地,整理好目錄結構。通常包含示例工程、庫源碼與 LICENSE 文件。

完成整理後,將代碼提交並推送到 GitHub。
在項目根目錄打開終端:

執行:
pod spec create ZGRSAEncryptor執行成功後,會生成 ZGRSAEncryptor.podspec 文件。

打開 podspec,填寫庫名稱、版本、摘要、主頁、License、作者、源地址與源碼路徑。
Pod::Spec.new do |s|
s.name = "ZGRSAEncryptor"
s.version = "1.0.0"
s.summary = "A Library for iOS to use for RSA encryptor."
s.homepage = "https://github.com/ScottZg/ZGRSAEncryptor"
s.license = "MIT"
s.author = { "scottzg" => "scottzg@126.com" }
s.source = { :git => "https://github.com/ScottZg/ZGRSAEncryptor.git", :tag => "#{s.version}" }
s.source_files = "ZGRSAEncryptor/*.{h,m}"
endsummary 會顯示在 CocoaPods 搜索結果中,因此需要寫清楚。

完成後執行驗證:
pod lib lint ZGRSAEncryptor.podspec如果有警告,可以忽略;但錯誤必須修復。

可以加上 allow-warnings 參數:
pod lib lint ZGRSAEncryptor.podspec --allow-warnings
看到 passed validation 即表示驗證成功。
打開 GitHub 項目頁面,進入 releases。

點擊 Draft a new release。

填寫 tag 與標題,然後發布。

執行:
pod trunk register 郵箱地址 "用戶名" --description="描述信息"
終端會提示郵箱驗證。打開郵件中的鏈接完成驗證。

可以執行以下命令查看是否註冊成功:
pod trunk me
先再次檢查 podspec:
pod spec lint
如有警告,可使用:
pod spec lint --allow-warnings
通過後執行推送:
pod trunk push ZGRSAEncryptor.podspec --allow-warnings
pod search ZGRSAEncryptor
如果能看到你的庫,說明已經成功發佈。
讓 GitHub 代碼支持 CocoaPods 並不複雜,關鍵在於保證 podspec 信息準確、tag 與源地址一致,並通過 trunk 完成身份驗證。完成後,其他開發者就可以通過 CocoaPods 安裝你的庫。