創建自己的CocoaPods庫並提交指南

來自我的個人博客Minecode.link

前言

CocoaPods是一款很棒的依賴管理工具,在開發中也經常用它來導入開源第三方庫。最近也想把自己的一些庫開源並加入CocoaPods中,特總結一下自己製作CocoaPods庫的過程。

前提

在製作之前,你需要:

  • 掌握CocoaPods的基本使用
  • 掌握Git的簡單使用
  • 準備好自己要開源的成品

開始製作

下面我們開始製作自己的開源庫,以個人的MCScratchImageView爲例。

推送至Git倉庫(Github)

首先需要將你的開源框架上傳至遠程倉庫,比如Github,使用方式不再贅述。記錄下你要使用的commit版本對應的SHA值。如下圖:

SHA Code

爲所選版本打tag

在Github自帶tag功能

在Github上爲項目打tag可在release頁面,選擇創建新tag並按下圖所示填寫即可。刪除tag也同理。
由於CocoaPods的版本信息僅支持數字的格式(如1.0.0),所以版本號請勿帶有其他特殊符號和字母。
Tag on Github

使用命令行

使用命令行進行版本管理較爲方便,簡單步驟爲: 創建本地tag -> 將tag推至遠程倉庫。

參考如下代碼:

// 創建本地tag
git tag -a 1.0.0 0c3b62d -m "Release Edition v1.0.0"
// 同步到遠程倉庫
git push origin 1.0.0

具體Tag的使用方式,可以參考使用Git添加tag的方法

製作Podspec描述文件

生成Podspec

首先在項目主目錄輸入一下命令
pod spec create <你的項目名>

該命令會在目錄中生成一個.podspec格式的文件,包含了該框架的詳細信息,我們創建CocoaPods庫的所有配置都圍繞它來完成。

配置Podspec文件

使用編輯工具(如SublimeText)打開該podspec文件,文檔中已經有詳細描述,在此簡單說明一下各屬性作用:

s.name: 框架名稱

s.version: 框架最新版本號。這個版本號對應了你Git倉庫中某個提交的tag,如果倉庫中對應的tag不存在則會提交失敗。

s.summary: 框架的概述。
s.description: 框架的詳細介紹。
s.homepage: 框架對應頁面,隨便寫
s.license: 框架的開源協議
s.author: 框架作者及郵箱,設置方式見註釋

s.platform: 這個要按註釋寫清支持的系統和版本,同時也要保證實際情況,比如Swift3.0最低支持到iOS 8.0,你就不能寫最低支持iOS 7.0

s.source: 對應的git源,在Github->Clone or download->Clone with HTTPS中
Git source

s.source_files: 庫的源代碼文件。這個是重點,應該包含全部你的庫所需的文件。
"s.source_files = MCScratchImageView/*.swift"爲MCScratchImageView文件夾內的全部swift代碼文件。注意默認爲.h和.m文件,需要設置爲swift的格式。可以設置多個文件參數。

s.framework: 項目所用到的原生框架,如UIKit Framework

s.dependency: 項目需要的其他CocoaPods庫,如s.dependency "JSONKit", "~> 1.4"

驗證Podspec文件

配置完Podspec文件之後,我們可以預先驗證一下文件是否可用。

pod spec lint <文件名稱>.podspec

若提示<文件名> passed validation.,則驗證通過。

發佈到CocoaPods(Trunk方式)

完成了所有的製作之後,我們現在將庫發佈到CocoaPods。使用了其自帶的Trunk工具進行提交。

註冊Trunk

首先需要將本機註冊到trunk

pod trunk register <E-mail> '<用戶名>' --description='<設備別名>'

提交註冊後,所填寫的郵箱將會收到一個驗證郵件,確認驗證即可。

同時也可以爲項目添加其他維護者:

pod trunk add-owner <庫名> <其他維護者郵箱>

可以使用pod trunk me來查看當前賬戶信息。

使用Trunk提交

通過配置好的Podspec,我們可以將庫提交到CocoaPods上。使用以下命令:

pod trunk push <文件名>.podspec

提交過程會檢查你的代碼能否正確編譯、以及Podspec是否正確配置。若成功將會顯示祝賀信息。

查看提交庫信息

我們可以在提交成功後查看是庫是否已經在CocoaPods上,命令如下:

pod search <庫名>
// 如果查找不到,可以嘗試
pod search <庫名> --simple

如果找不到,可以嘗試

pod setup
rm ~/Library/Caches/CocoaPods/search_index.json

如果能查看到庫信息,則說明上傳成功。我們可以看到庫的介紹以及所有版本等信息。

刪除庫的指定版本

當上傳的庫版本號已存在時會發生衝突,不能覆蓋。所以我們只能先刪除指定版本再重新提交。

pod trunk delete <庫名> <版本號>

示例

至此,我們已經成功把自己的庫提交至CocoaPods,用戶可以通過Podfile來使用。
下面附一份本人CocoaPods庫的Podspec文件以供參考, MCScratchImageView

Pod::Spec.new do |s|
s.name         = "MCScratchImageView"
s.version      = "1.0.0"
s.summary      = "Custom ImageView like scratch card"
s.description  = <<-DESC
A custom ImageView that is used to cover the surface of other view like a scratch card, user can swipe the mulch to see the view below.
DESC
s.homepage     = "https://github.com/Minecodecraft/MCScratchImageView"
s.license      = "MIT"
s.author       = { "Minecode" => "[email protected]" }
s.platform     = :ios, "8.0"
s.source       = { :git => "https://github.com/Minecodecraft/MCScratchImageView.git", :tag => "#{s.version}" }
s.source_files  = "MCScratchImageView/MCScratchImageView.swift"
s.framework  = "UIKit"
end

如有問題,可以發送郵件至 [email protected]
歡迎共同探討iOS開發問題

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章