利用cocoapods管理開源項目，支持 pod install安裝整個流程記錄（github公有庫）

利用cocoapods管理開源項目，支持 pod install安裝整個流程記錄（github公有庫），完成預期的任務，大致有下面幾步：

1.代碼提交到github平台

2.創建.podspec

3.編輯.podspec

4.添加tag

5.驗證

6.注冊CocoaPods

7.發布

詳細流程如下：

1.代碼提交到github平台

將自己的代碼上傳到github上面（不是唯一的,上傳到任何平台上都可以,前提是項目是開源的）。至於怎么利用github管理我們的項目，可以參考：http://www.cnblogs.com/richard-youth/p/4684100.html

2.創建.podspec

首先要利用cocoapods將項目管理起來，具體可以參考：http://www.cnblogs.com/richard-youth/p/4508049.html

然后cd到你項目的目錄,執行命令（ 注yooweiTest這個是你框架的名稱）

$ pod spec create yooweiTest

3.編輯.podspec

創建好后打開,刪除注釋, 前面有#的為注釋,如果你想知道每個東西的含義可以了解一下

整理之后的文件

Pod::Spec.new do |s| s.name = "yooweiTest"
 s.version = "1.0"
 s.ios.deployment_target = '7.0'
 s.summary = "yooweiTest" 
 s.homepage = "https://github.com/yoowei/yooweiTest" 
     s.license= { :type => "MIT", :file => "LICENSE" }
 s.author = { "yoowei" => "[e-mail]" } 
  s.source = { :git => "https://github.com/yoowei/yooweiTest.git", :tag => s.version } /注意需要.git結尾。
     s.source_files  = "yooweitest", "yooweitest/**/*"  //需要和.podspec 的名稱一樣？？

接下來講解一下每行代碼的含義

s.name：名稱，pod search 搜索的關鍵詞,注意這里一定要和.podspec的名稱一樣,否則報錯
s.version：版本號
s.ios.deployment_target:支持的pod最低版本
s.summary: 簡介
s.homepage:項目主頁地址
s.license:許可證
s.author:作者
s.social_media_url:社交網址
s.source:項目的地址
s.source_files:需要包含的源文件
s.resources: 資源文件
s.requires_arc: 是否支持ARC
s.dependency：依賴庫，不能依賴未發布的庫
s.dependency：依賴庫，如有多個可以這樣寫

s.license= { :type => "MIT", :file => "LICENSE" }
這里建議大家這樣寫,如果寫別的會報警告,導致后面一直提交失敗

• source_files:寫法及含義建議大家寫第一種或者第二種

  "yooweitest/* "yooweitest/yoowei/*.{h,m}" "yooweitest/**/*.h"

• “*” 表示匹配所有文件
• “*.{h,m}” 表示匹配所有以.h和.m結尾的文件
• “**” 表示匹配所有子目錄
• s.source 常見寫法

  s.source = { :git => "https://github.com/yoowei/yooweiTest.git", :commit => "68defea" } s.source = { :git => "https://github.com/yoowei/yooweiTest.git", :tag => 1.0.0 } s.source = { :git => "https://github.com/yoowei/yooweiTest.git", :tag => s.version }

• commit => "68defea" 表示將這個Pod版本與Git倉庫中某個commit綁定
• tag => 1.0.0 表示將這個Pod版本與Git倉庫中某個版本的comit綁定
• tag => s.version 表示將這個Pod版本與Git倉庫中相同版本的comit綁定

另外：

1、引用靜態庫： “(.ios).library”。去掉頭尾的lib，用“,”分割 。注意： (.ios)括號括起來代表可以省略

// 引用libxml2.lib和libz.lib.   

spec.libraries = 'xml2', 'z'

2、引用公有framework："(.ios).framework" 用”,”分割. 去掉尾部的”.framework”

spec.frameworks = 'UIKit','SystemConfiguration', 'Accelerate'

3、引用自己生成的framework：’(.ios).vendored_frameworks’  用”,”分割 路徑寫從.podspec所在目錄為根目錄的相對路徑 ps:這個不要省略.framework spec.ios.vendored_frameworks = 'Pod/Assets/*.framework'

4、引用自己生成的.a文件, 添加到Pod/Assets文件夾里. Demo的Example文件夾里也需要添加一下, 不然找不到

spec.ios.vendored_libraries = 'Pod/Assets/*.a'

注意：在提交到私有倉庫的時候需要加上--use-libraries 

4.創建LICENSE(許可證/授權)文件,此文件必須要有

創建一個文件名字命名為LICENSE,內容為:只需要把前面的版權改一下就行了,后面的都一樣。

MIT LicenseCopyright (c) 2017Permission is hereby granted, free of charge, to any person obtaining a copy

of this software and associated documentation files (the "Software"), to deal

in the Software without restriction, including without limitation the rights

to use, copy, modify, merge, publish, distribute, sublicense, and/or sell

copies of the Software, and to permit persons to whom the Software is

furnished to do so, subject to the following conditions:The above copyright notice and this permission notice shall be included in all

copies or substantial portions of the Software.THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE

AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER

LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,

OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE

SOFTWARE.

但是：一般我們創建倉庫的時候，大多數已經創建好了的。

5.上傳到Git

將包含配置好的 .podspec, LICENSE 的項目提交 Git倉庫

6.打tag

$ git tag

1.0

$ git tag -a 2.0 -m "2.0版本"

$ git tag

1.0

2.0

$ git push origin 2.0

Counting objects:

1, done.Writing objects: 100% (1/1), 173 bytes | 0 bytes/s, done.

Total 1 (delta 0), reused 0 (delta 0)To https://github.com/yoowei/yooweiTest.git 

* [new tag]         2.0 -> 2.0

因為cocoapods是依賴tag版本的,所以必須打tag。以后再次更新只需要把你的項目打一個tag，然后修改.podspec文件中的版本，接着提交到cocoapods官方就可以了。

注意將tag提交這一步很重要

7.驗證.podspec文件

到此檢查一下你工程下面的文件, 你的項目, .podspec文件, LICENSE文件是否存在。驗證會先測試本地 .podspec 文件是否存在語法錯誤.

// --verbose 如果驗證失敗會報錯誤信息

$ pod spec lint yooweiTest.podspec --verbose

說明：2017.1.14 我將mac電腦系統升級到最新，所需要的cocoapods等環境重新更新安裝，包括該項目再github上面的項目倉庫也是重新建立的（經過修改），這次驗證居然一次性通過，沒有出現任何問題。
 yooweiTest.podspec passed validation.

前段時間操作遇到的錯誤和警告：

1、

-> yooweiTest (1.0)
    - WARN  | github_sources: Github repositories should end in `.git`. //注意需要以.git結尾
    - WARN  | description: The description is equal to the summary.
    - NOTE  | xcodebuild:  warning: no rule to process file 'yooweiTest/JSPatchtest/yoowei/JSPatch.js' of type sourcecode.javascript for architecture i386
    - NOTE  | xcodebuild:  warning: no rule to process file 'yooweiTest/JSPatchtest/yoowei/JSPatch.js' of type sourcecode.javascript for architecture x86_64

Analyzed 1 podspec.
[!] The spec did not pass validation, due to 2 warnings (but you can use `--allow-warnings` to ignore them).
[!] The validator for Swift projects uses Swift 3.0 by default, if you are using a different version of swift you can use a `.swift-version` file to set the version for your Pod. For example to use Swift 2.3, run:
    `echo "2.3" > .swift-version`.
$ pod lib lint --allow-warnings

$ echo "2.3" > .swift-version

2、 -> JSPatchtest (1.0.0)

    - ERROR | name: The name of the spec should match the name of the file.// 這個是要保證.podspe文件的名稱和里面s.name保持一致

    - WARN  | github_sources: Github repositories should end in `.git`.

    - WARN  | description: The description is equal to the summary.

    - ERROR | [iOS] unknown: Encountered an unknown error (No podspec found for `JSPatchtest` in `/Users/galahad/Desktop/yooweiTest`) during validation.

[!] JSPatchtest did not pass validation, due to 2 errors and 2 warnings.

3  、

[!] Error installing JSPatchtest
 -> yooweitest (1.0.0)
    - WARN  | description: The description is shorter than the summary.
    - ERROR | [iOS] unknown: Encountered an unknown error ([!] /usr/bin/git clone https://github.com/yoowei/yooweiTest.git /var/folders/rg/gmjp61bx0x95t4tjx2hh_3sr0000gn/T/d20170113-4028-cvivmq --template= --single-branch --depth 1 --branch 1.0.0

[!] The spec did not pass validation, due to 1 error and 1 warning.

解決方法：執行 sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer (-switch 后面加上你的Xcode.app包內容里的Developer的文件夾路徑即可).

驗證成功后:

yooweiTest passed validation.

驗證失敗:

[!] The spec did not pass validation, due to 1 error.

如果出現錯誤，就各式各樣，根據描述進行解決就可以了。

8.注冊Trunk

如果要添加到Cocoapods的官方庫了，可以使用trunk工具，具體可以查看官方文檔。如果是私有庫的話，詳見：http://www.cnblogs.com/richard-youth/p/6289015.html

trunk需要CocoaPods 0.33版本以上，用pod --version 命令查看版本，如果CocoaPods版本低，需要升級。已經注冊過的不需要注冊,怎么看自己有沒有注冊

$ pod trunk me

- Name:     yoowei 

- Email:    [e-mail] 

- Since:    January 12th, 04:38 

- Pods:     None 

- Sessions:    - January 12th, 04:38 - May 21st, 03:35. IP: 218.205.57.27

如果沒有注冊的話  [!] You need to register a session first.注冊

// 加上--verbose可以輸出詳細debug信息，方便出錯時查看。

$ pod trunk register [e-mail] "yoowei" --verbose

[!] Please verify the session by clicking the link in the verification email that has been sent to [e-mail]

注冊完成之后會給你的郵箱發個郵件,進入郵箱郵件里面有個鏈接,需要點擊確認一下。

補充： 

$ pod trunk help 可以查詢一般的命令

那么怎么將自己刪除？？？？

其實我們可以連根拔起，

# 顯示隱藏文件

defaults write com.apple.finder AppleShowAllFiles Yes && killall Finder

# 不顯示隱藏文件

defaults write com.apple.finder AppleShowAllFiles No && killall Finder

我們顯示隱藏文件后，在用戶目錄下，找到 /Users/galahad/.rvm 

直接將隱藏文件.rvm刪除

$ pod trunk me

-bash: /Users/galahad/.rvm/gems/ruby-2.2.2/bin/pod: No such file or directory

一切OK🌶

9.發布

發布時會驗證 Pod 的有效性，如果你在上面步驟中手動驗證 Pod 時使用了 --use-libraries 或 --allow-warnings 等修飾符，那么發布的時候也應該使用相同的字段修飾，否則出現相同的報錯。

pod trunk push yooweiTest.podspec --allow-warnings

成功了以后會出現以下內容

這個時候，再用

$ pod trunk me 

- Name:     yoowei 

- Email:     [e-mail] 

- Since:     January 12th, 04:38 

- Pods:    - yooweiTest 

- Sessions:    - January 12th, 04:38 - May 22nd, 00:54. IP: 218.205.37.37

你會發現- Pods:    - yooweiTest 已經有了內容了。

 

10.驗證

立即搜索

$ pod search yooweiTest

[!] Unable to find a pod with name, author, summary, or description matching `yooweiTest`

沒有搜到......

自己摸索着......進行以下嘗試

首先：

$ pod setup

然后：

 

$ pod search yoowei

[!] Unable to find a pod with name, author, summary, or description matching `yoowei`

還是失敗......

由於 pod setup成功后會生成~/Library/Caches/CocoaPods/search_index.json文件。

終端輸入rm ~/Library/Caches/CocoaPods/search_index.json

刪除成功后再執行pod search 一切OK🌶

$ rm ~/Library/Caches/CocoaPods/search_index.json

$ pod search yoowei

Creating search index for spec repo 'master'.. Done!

$ pod search yoowei

-> yooweiTest (1.0)

   yooweiTest just test.

   pod 'yooweiTest', '~> 1.0'

   - Homepage: https://github.com/yoowei/yooweiTest

   - Source:   https://github.com/yoowei/yooweiTest.git

   - Versions: 1.0 [master repo]

 

補充：Claim your Pod 聲稱，索取: https://trunk.cocoapods.org/claims/new 
可以利用 pod trunk info yooweiTest 查詢相關信息

$ pod trunk info yooweiTest

yooweiTest   

- Versions:      - 1.0 (2017-01-14 06:50:53 UTC)   

- Owners:      - yoowei <[e-mail]> 

點擊SEND進入頁面后： $ pod trunk help 可以查詢一般的命令，包括添加開發者

個人理解：最后不管你是不是有爭議，他們要求你說明為什么來到這里，我覺得你想寫就寫，不寫拉倒。 如有不對，歡迎交流。