您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

讓你的 GitHub 代碼支持 CocoaPods:從 podspec 到 trunk 發佈

編輯:iOS 開發基礎

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

CocoaPods 支持

一、上傳代碼到 GitHub

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

創建 GitHub 倉庫

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

項目目錄

完成整理後,將代碼提交並推送到 GitHub。

二、創建 podspec 文件

在項目根目錄打開終端:

終端目錄

執行:

pod spec create ZGRSAEncryptor

執行成功後,會生成 ZGRSAEncryptor.podspec 文件。

生成 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}"
end

summary 會顯示在 CocoaPods 搜索結果中,因此需要寫清楚。

summary 展示

完成後執行驗證:

pod lib lint ZGRSAEncryptor.podspec

如果有警告,可以忽略;但錯誤必須修復。

驗證警告

可以加上 allow-warnings 參數:

pod lib lint ZGRSAEncryptor.podspec --allow-warnings
驗證通過

看到 passed validation 即表示驗證成功。

三、在 GitHub 創建 release

打開 GitHub 項目頁面,進入 releases。

release 入口

點擊 Draft a new release。

創建 release

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

發布 release

四、註冊 CocoaPods 賬號

執行:

pod trunk register 郵箱地址 "用戶名" --description="描述信息"
註冊 trunk

終端會提示郵箱驗證。打開郵件中的鏈接完成驗證。

郵箱驗證

可以執行以下命令查看是否註冊成功:

pod trunk me
查看 trunk 信息

五、上傳代碼到 CocoaPods

先再次檢查 podspec:

pod spec lint
pod spec lint

如有警告,可使用:

pod spec lint --allow-warnings
允許警告

通過後執行推送:

pod trunk push ZGRSAEncryptor.podspec --allow-warnings
推送成功

六、檢查是否成功

pod search ZGRSAEncryptor
搜索成功

如果能看到你的庫,說明已經成功發佈。

總結

讓 GitHub 代碼支持 CocoaPods 並不複雜,關鍵在於保證 podspec 信息準確、tag 與源地址一致,並通過 trunk 完成身份驗證。完成後,其他開發者就可以通過 CocoaPods 安裝你的庫。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved