在CocoaPods上建立自己iOS程式的依賴管理

阿新 • • 發佈：2019-01-17

一、github上建立開源專案

GitHub是目前使用最廣的分散式專案管理軟體。下面是如何從零開始，將自己的專案放到GitHub上面，並能夠像SVN那般update和commit。

2、按照的指引，建立第一個程式碼倉庫

“Repository name”可以理解為專案名稱。

※現在的Private許可權是收費的，所以只能建立Public許可權的倉庫。

※Private許可權，表示只有指定使用者可以檢視/下載/commit這些程式碼；而Public許可權，則表示所有人都能夠看到這些程式碼並進行下載，但只有你指定的使用者才能夠進行commit。

3、安裝和配置git

[[email protected] 
 ~]# git --version
git version 2.5.4(Apple Git-61)

接著就要設定使用者名稱和Email了，Email最好和註冊時候的一樣。

$ git config --global user.name "Your Name Here"
# Sets the default name for git to use when you commit
$ git config --global user.email "[email protected]"
# Sets the default email for git to use when you commit

上面的內容都寫在配置檔案~/.gitconfig裡了
恭喜，到這裡，基本Git和GitHub都配置好了！

mac已經帶有git，檢視版本

4、版本庫初始化

如果是從頭建立版本庫，可以採用先克隆，建立提交資料，最後再通過推送完成GitHub版本庫的初始化。

步驟如下

(1) 克隆版本庫:

git clone https://github.com/skylinbaiyi/HelloWorld.git
Cloning into 'HelloWorld'...
remote: Counting objects: 3, done.
remote: Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
Unpacking objects: 100% (3/3), done.
Checking connectivity... done.

克隆的方式，本地已經存在一個.git資料夾，就不需要執行 git init 了

(2) 修改檔案README.md檔案:

建立Repository時，如果選擇建立README.md檔案的話，github上已經存在該檔案，如果沒有，則手動建立

$ git add README
# Stages your README file, adding it to the list of files to be committed

(3) 提交

git add .

這個git add確實夠蛋疼的，commit的話當然是把本地修改的所有檔案提交上去了，還非得一個一個的add，這是反人類啊

#會把當前路徑下的所有檔案，新增到待上傳的檔案列表中

$ git commit -m 'first commit'
# Commits your files, adding the message "first commit"

(4) push

這裡所有的更改都只是在本地的, Push之後才會提交到GitHub儲存：

git remote add origin https://github.com/skylinbaiyi/HelloWorld.git

git push origin master

(5）給專案加入一個tag。以便pod能自動識別

git tag -a 0.0.1 -m "Tag release 0.0.1”
git push —tags

二、為自己的專案新增cocoaPods支援

1、註冊

trunk需要CocoaPods 0.33版本以上，用pod --version命令檢視版本，如果版本低，需要升級：

sudo gen install cocoapods
pod setup

pod setup後必須要註冊後才能提交podspec檔案，否則會出現下面的錯誤

更新完成後，下一步是註冊trunk

pod trunk register [email protected] 'test' --description=' ' --verbose

註冊完後，會提示使用者到郵箱驗證:

收到的郵箱內容如下:

點選連結驗證:

有的地方提示，這一步需要自備梯子,否則就會出現註冊失敗的問題，經我這裡測試，公司網路目前不需要翻牆

註冊後CocoaPods會給你的郵箱傳送驗證連結，點選後就註冊成功了，可以用pod trunk me命令檢視自己的註冊資訊：

上面的命令是我註冊時使用的，你需要把郵箱和名字以及描述替換成你的，加上--verbose可以輸出詳細debug資訊，方便出錯時檢視。

- Name: Yang Xiaoyu
- Email: [email protected]
- Since: May 25th, 20:27
- Sessions:
- May 25th, 20:27 - September 30th, 22:41. IP: 23.228.209.171
Description: macbook pro

上面是我的註冊資訊，CocoaPods不通過密碼來驗證使用者，而是通過一個session token。

2、部署你的Pod

首先你需要建立一個podspec檔案，這是我的podspec檔案：

Pod::Spec.new do |s|
  s.name         = "YXYNumberAnimationLabel"
  s.version      = "1.0.1"
  s.summary      = "一個可以動起來的數字Label"
  s.description  = <<-DESC
                    通過設定數字變化的插值來展現動畫效果
                   DESC
  s.homepage     = "https://github.com/yulingtianxia/YXYNumberAnimationLabel"

  s.license      = 'MIT'
  s.author       = { "YangXiaoyu" => "[email protected]" }
  s.social_media_url = "http://twitter.com/yulingtianxia"
  s.source       = { :git => "https://github.com/yulingtianxia/YXYNumberAnimationLabel.git", :tag => s.version.to_s }

  s.platform     = :ios, '6.0'
  s.requires_arc = true

  s.source_files = 'YXYNumberAnimationLabel/*'
  s.frameworks = 'Foundation', 'UIKit'
  #s.private_header_files = 'Classes/ios/private/*.h'

  #s.dependency 'FLKAutoLayout', '~> 0.1'
end

在驗證和上傳你的podspec檔案到trunk之前，需要將你的原始碼push到Github上，tag一個版本號併發佈一個release版本，這樣podspec檔案中的s.source的值才能是準確的：

git add -A 
git commit -m "Release 1.0.1."  
git tag '1.0.1'  
git push --tags  
git push origin master

這兩條命令是為pod新增版本號並打上tag:

set the new version to 1.0.1
set the new tag to 1.0.1

pod trunk push命令做了如下三個工作：

在你podspec檔案下的路徑執行pod trunk push YXYNumberAnimationLabel.podspec 命令，同樣需要翻牆梯子自備，別忘了將YXYNumberAnimationLabel.podspec替換成你的podspec檔名。

驗證你本地的podspec檔案（你也可以用pod spec lint命令來驗證）
上傳你的podspec檔案到trunk
將你的podspec檔案轉化成trunk需要的JSON檔案

如果部署成功，CocosPods會在Twitter上@你

就像文章最開始的架構圖描述的那樣，你在trunk中的操作依然會在CocoaPods/Specs倉庫中更新。以後再做更改時只需要更新版本號然後通過trunk來提交，不用向CocoaPods/Specspull request並等待稽核和merge了。

執行pod setup來更新你的Pods依賴庫tree後，再使用pod search YXYNumberAnimationLabel命令來查詢剛剛加入的名字叫YXYNumberAnimationLabel的依賴庫：

-> YXYNumberAnimationLabel (1.0.1)
   一個可以動起來的數字Label
   pod 'YXYNumberAnimationLabel', '~> 1.0.1'
   - Homepage: https://github.com/yulingtianxia/YXYNumberAnimationLabel
   - Source:   https://github.com/yulingtianxia/YXYNumberAnimationLabel.git
   - Versions: 1.0.1, 1.0.0 [master repo]

注意事項：

(1)驗證spec檔案的有效性:

pod spec lint檔名驗證resp上的檔案

pod lib lint 檔名這是隻是驗證本地檔案

(2) 新增 --verbose 可以顯示詳細資訊，便於檢視問題

pod trunk push Bugrpt.podspec --verbose

三、提交 podspec 檔案到github的方法對比

提交結果檢視地方
https://github.com/CocoaPods/Specs/tree/master/Specs

1、舊方法
http://blog.csdn.net/wzzvictory/article/details/20067595
2、新方法
http://yulingtianxia.com/blog/2014/05/26/publish-your-pods-on-cocoapods-with-trunk/http://www.cnblogs.com/wengzilin/p/4742530.html其他文章中提到，需要cocoaPods稽核幾天，才能有效，但我這裡使用的實際情況是，只要pod trunk push成功，就馬上有效了，在 CocoaPods/Specs中就可以看到了，CocoaPods也可以使用這個庫了