如何釋出自己的開源框架到CocoaPods

——在專案所在目錄下執行* pod init * , 生成Podfile檔案, 我們需要對其進行相應的配置。

在開發過程中，經常會使用到第三框架，我們通過一個pod install命令，很方便的就將第三方框架加到我們自己的專案中。
用CocoaPods做iOS程式的依賴管理

1. 在github建立倉庫完成，需要將倉庫檢出到本地（擷取網上的例子）

注意：LICENSE(許可證)檔案不可缺少，否則檢測spec檔案時，會有警告

2. 將寫好開源框架/庫的Demo或者Example放到Git倉庫下，還要將要開源的資料夾也放入到git倉庫中（該資料夾在後面會被用到）（擷取網上的例子）

3. 專案釋出到github後，我們在工程根目錄中初始化一個Podspec檔案：建立自己專案的Podspec描述檔案:

pod spec create ECGCustomAlertView

1. 該命令將在本目錄產生一個名為ECGCustomAlertView.podspec檔案。用編輯器（命令列：vim ECGCustomAlertView.podspec）開啟該檔案，裡面已經有非常豐富的說明文件。下面介紹如何宣告第三方庫的程式碼目錄和資源目錄，還有該第三方庫所依賴ios核心框架和第三方庫。這是我的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:社交網址,這裡我寫的微博預設是Twitter,如果你寫Twitter的話,你的podspec釋出成功後會@你 s.source:專案的地址 s.source_files:需要包含的原始檔 s.resources: 資原始檔 s.requires_arc: 是否支援ARC s.dependency：依賴庫，不能依賴未釋出的庫，如 s.dependency = ‘AFNetworking’ s.dependency：依賴庫，如有多個可以這樣寫。我這裡是託管在github上,所以這裡將地址copy過來就行了。
   

   
   source_files: 核心程式碼的檔案地址。注意：這裡是經常出錯的地方！—如果使用的是這種方式來顯示核心程式碼地址而不是下面的模組化的話，注意：需要將程式碼檔案必須以倉庫名命名（也就意味著最多隻有兩個檔案.h和.m檔案了，可以有一個.h檔案，把它作為標頭檔案就行），這種方式檢驗podspec檔案有點嚴格，否則就會報錯。
   寫法及含義建議大家寫第一種或者第二種。
   
   “ECGCustomAlertView/*”
   “ECGCustomAlertView/ECGCustomAlertView/*.{h,m}”
   “ECGCustomAlertView/*/.h”

   “*” 表示匹配所有檔案
   “*.{h,m}” 表示匹配所有以.h和.m結尾的檔案
   “**” 表示匹配所有子目錄

4. 模組化

1. 通過PodSpec的subspec 可以使一個專案能模組化輸出功能 ,一個例子:

Pod::Spec.new do |s|
  s.name         = "iOS_Util"
  s.version      = "0.10.0"
  s.summary      = "Some iOS Util"

  s.license      = 'MIT'

  s.author       = { "文通" => "[email protected]" }


  s.platform     = :ios, '6.1'

  s.ios.deployment_target = '4.3'

  s.subspec 'Common' do |cos|
    cos.source_files = 'iOS_Util/Common/*.{h,m}'
    cos.public_header_files = 'iOS_Util/Common/*.h'
  end

  s.subspec 'Core' do |cs|
    cs.source_files = 'iOS_Util/Core/*.{h,m}'
    cs.public_header_files = 'iOS_Util/Core/*.h'
    cs.dependency 'libextobjc', '0.2.5'
  end

  s.subspec 'Json' do |js|
    js.source_files = 'iOS_Util/Json/*.{h,m}'
    js.public_header_files = 'iOS_Util/Json/*.h'
    js.dependency 'iOS_Util/Core'
  end

  s.subspec 'Bean' do |bs|
    bs.source_files = 'iOS_Util/Bean/*.{h,m}'
    bs.public_header_files = 'iOS_Util/Bean/*.h'
    bs.dependency 'iOS_Util/Core'
  end

  s.subspec 'DB' do |ds|
    ds.source_files = 'iOS_Util/DB/*.{h,m}'
    ds.public_header_files = 'iOS_Util/DB/*.h'
    ds.dependency 'FMDB/standard' ,'~> 2.1'
    ds.dependency 'iOS_Util/Common'
    ds.dependency 'iOS_Util/Core'
  end

  s.subspec 'WebP' do |ws|
    ws.source_files = 'iOS_Util/WebP/*.{h,m}'
    ws.public_header_files = 'iOS_Util/WebP/*.h'
    ws.dependency 'libwebp' ,'~> 0.3.0-rc7'
    ws.frameworks = 'CoreGraphics'
  end

  s.subspec 'Location' do |ls|
    ls.source_files = 'iOS_Util/Location/*.{h,m}'
    ls.public_header_files = 'iOS_Util/Location/*.h'
    ls.dependency 'iOS_Util/Common'
    ls.dependency 'iOS_Util/DB'
    ls.frameworks = 'CoreLocation' ,'MapKit'
    ls.resource = 'iOS_Util/Location/chinaDivision.sqlite'
  end

  s.subspec 'AMR' do |as|
    as.source_files = 'iOS_Util/AMR/**/*.{h,m,mm}'
    as.public_header_files = 'iOS_Util/AMR/**/*.h'
    as.preserve_paths = "iOS_Util/AMR/**"
    as.library   = 'opencore-amrnb','opencore-amrwb'
    as.xcconfig  = { 'LIBRARY_SEARCH_PATHS' => '"$(PODS_ROOT)/iOS_Util/iOS_Util/AMR/lib"' }
  end

  s.subspec 'Cache' do |cas|
    cas.source_files = 'iOS_Util/Cache/*.{h,m,mm}'
    cas.public_header_files = 'iOS_Util/Cache/*.h'
    cas.dependency 'iOS_Util/Common'
  end

  s.subspec 'Preference' do |ps|
    ps.source_files = 'iOS_Util/Preference/*.{h,m,mm}'
    ps.public_header_files = 'iOS_Util/Preference/*.h'
    ps.dependency 'iOS_Util/Json'
  end

  s.requires_arc = true



end

5. 設定tag號，提交修改（注：只要spec檔案被修改，就必須重新執行如下命令）

git commit -m "Release 1.0.1"  (先提交當前修改)
git tag 1.0.1            (新增tag)
git push --tags         (推送tag到遠端)
git push origin master  (推送到遠端到程式碼倉庫)

6. 提交之前先驗證.podspec檔案是否合法

pod spec lint ECGCustomAlertView.podspec  
pod spec lint ECGCustomAlertView.podspec --allow-warnings     (忽略警告)

• 錯誤列表
  
  從錯誤資訊中得到：我的專案編譯不通過：ECGLoadsAlertViewController.h 類檔案找不到，需要將專案錯誤的地方修改掉，如果顯示這樣的提示資訊：

• 驗證通過
  
  那麼就是已經配置成功，可以提交到cocoapods了，否則要將所有提示的error和warn修改掉。

7. 驗證.podspec檔案報錯，解決方法

• 先刪除tag

// 刪除本地tag
git tag -d 1.0.0
// 刪除遠端tag
git push origin -d tag 1.0.0

• 修改spec檔案（必須修改相應的version和source）
• 重新執行–>設定tag號，提交修改的步驟

8. podspec檔案驗證成功，通過trunk推送podspec檔案

pod trunk push ECGCustomAlertView.podspec

• 如果有如下提示，需要你用郵箱註冊一個trunk
  

• 用郵箱註冊trunk（建議：用github註冊的郵箱地址為好，外加使用者名稱–>gitub的使用者名稱（我用郵箱使用者名稱也通過了））

pod trunk register 郵箱地址 "使用者名稱" --description="macbook pro"

• 之後會有一封帶有驗證連結的郵件傳送到你輸入的郵箱，點選驗證後就可以回來終端繼續提交操作了。

9. 提交到cocoapods

pod trunk push ECGCustomAlertView.podspec
pod trunk push ECGCustomAlertView.podspec --allow-warnings

• 我碰到了個錯誤提示1：
  
• 網上查的解決方法：解決方案
  實質：If you get this error message:（如果你獲得這個錯誤資訊：）
  
  You need to set and unset that rename limit:
  

git config merge.renameLimit 999999
git config --unset merge.renameLimit

• 我碰到的錯誤資訊2：
  

• 該錯誤為：無法開啟TCP連線到trunk.cocoapods.org：
  具體原因我沒有找出來，我的解決辦法是重新修改spec配置檔案（vim），需要修改版本號，然後繼續提交就成功了！

• 然後繼續提交到cocoapods，如果成功會出現：
  

10. Cocoapods: pod search無法搜尋到類庫的解決辦法

• 刪除~/Library/Caches/CocoaPods目錄下的search_index.json檔案

 pod setup成功後會生成~/Library/Caches/CocoaPods/search_index.json檔案。
 終端輸入rm ~/Library/Caches/CocoaPods/search_index.json
 刪除成功後再執行pod search

稍等片刻就會出現你所要搜的類庫了。

11. podspec檔案更新方法

• 以後我們的庫有新版本時，我們可以修改相應的version和source。

• 有時你可能會遇到這種情況：執行pod trunk push操作後發現podspec檔案的某個地方寫錯了，想更新一下。對於這種情況，我們可能會先嚐試著在把podspec檔案push一次。但是如果你的程式碼版本號沒變(podspec裡的version自然也沒變)就會提示push失敗，即使你更改了podspec的其他地方，pod也會認為這兩個檔案是同一個。 我目前為止找不到trunk的相關update介面，所以只能順水推舟，更新原始碼版本號（如：1.1.1->1.1.2），重新push version tag，然後再執行pod trunk push操作。

• 後來遇到的坑：

• 
  
  • 1.通過程式碼建立的podspec檔案裡面都是雙引號，博主用的都是單引號，經測試，無影響，還有UIKIT等庫和第三方庫的引入，以及版本升級，這一部分已經放在這裡；
• 
  
  • 2.發現一個問題，如果你在某個庫中用了NSInteger，會報警告，原因是：typedef long NSInteger;類似這種情況的還有別的，如果遇到你可以替換成像這裡應該是long，也可以選擇忽略警告，比如：pod trunk push ScrollSliderView.podspec –allow-warnings；
• 
  
  • 3.有時候在push時會遇到這樣的報錯：[!] There was an error pushing a new version to trunk: Net::OpenTimeout 不要驚慌，僅僅是因為網路不好沒有push成功，不妨再試一次。