CocoaPods管理第三方庫

1、pod init自動生成Podfile：

2、vim Podfile，取消platform的注釋，注釋use_frameworks!使用靜態庫，添加pod 'AFNetworking', '~> 3.2.1'：

• 2.1、不使用use_frameworks!則在Pods專案（前面為藍色圖示）的Products下生成.a檔案；使用use_frameworks!則生成.framework檔案，

3、執行pod install生成CBD.xcworkspace檔案，

CocoaPods創建自己的庫

創建復合專案和Framework

1、創建普通的專案：

2、點擊TARGETS左下角的“+”號，添加一個Target，選擇“iOS”->“Framework & Library”->“Framework”，


創建Framework之后，左側導航面板會多一個“RCUtility”目錄，中間面板TARGETS也會多一個“RCUtility”，
TARGETS選中RCUtility，Build Settings中Mach-O Type為“Dynamic Library”（這里選擇動態庫，并不影響其他專案比如CBD使用這個庫時選擇靜態鏈接還是動態鏈接，這里的設定只影響本專案的編譯設定）（Framework是一種打包方式，包含.a二進制檔案+bundle資源檔案+.h頭檔案，不一定是元件，也可以使用靜態鏈接的方式，），

3、Framework的設定：

• 設定前綴：選中左側“Project Navigator”面板中的“RCUtilityDemo”專案（左側圖示是藍色而不是黃色），在打開的右側“File Inspector”面板下的“Project Document”->“Class Prefix”填入前綴如RC，這樣新建的class都自動以RC開頭命名，
• 設定scheme：Stop按鈕右側（左側是Build and then Run按鈕）選中“RCUtility”（不是RCUtilityDemo），再次點擊選擇“Edit Scheme…”，在彈出的面板中選中"Run"，在左側“Info”->“Build Configuration”改為“Release”，
• 設定Build Settings：TARGETS選中RCUtility，Build Settings下的“Build Active Architchture Only”->“Release”設定為NO（Debug可不修改），

4、Framework中創建類 和 主專案中使用Framework：

• 4.1、導航面板中選中“RCUtility”目錄（注意不是RCUtilityDemo目錄），新建一個類，將這個類.h檔案加到“Build Phases”->“Headers”->“Public”（默認在Project中，右鍵該檔案選擇“Move to Public Group”），

• 4.2、主專案中使用Framework：

  • 4.2.1、TARGETS->“RCUtilityDemo”->“Link Binary With Libraries”加入RCUtility.framework（默認已經加入），
    
  • 4.2.2、在主專案的類.m檔案中import自己創建的Framework的某個類的頭檔案.h，即可使用這個類的方法，

GitHub托管代碼

1、本地倉庫：

• 1.1、在終端cd到RCUtilityDemo目錄（里面包含RCUtility、RCUtilityDemo和RCUtilityDemo.xcodeproj），執行git init，
• 1.2、創建.gitignore（在Sourcetree中添加本地倉庫，可以看到哪些檔案被修改，哪些檔案應該加到.gitignore），然后commit全部檔案，

2、遠程倉庫：

• 2.1、GitHub上新建倉庫，名字填RCUtility，選擇Public，不勾選README這些檔案，創建一個空白倉庫，
• 2.2、關聯遠程倉庫：git remote add origin https://github.com/rccrx/RCUtility.git，git push -u origin master，

發布到CocoaPods

1、cd到RCUtilityDemo目錄，執行pod spec create RCUtility創建檔案RCUtility.podspec（生成的檔案的注釋里面會有各個引數的說明，雖然最后需要洗掉這些注釋），
2、修改檔案RCUtility.podspec如下：

Pod::Spec.new do |spec|

  spec.name         = "RCUtility"
  spec.version      = "0.0.1"
  spec.summary      = "A short description of RCUtility."
  spec.homepage     = "https://github.com/rccrx/RCUtility"
  spec.license      = "MIT"
  spec.author             = { "rccrx" => "rccrx@qq.com" }
  spec.platform     = :ios, "9.0"
  spec.source       = { :git => "https://github.com/rccrx/RCUtility.git", :tag => spec.version }
  spec.source_files  = "RCUtility"
  spec.requires_arc = true

end

3、添加LICENSE檔案：

• 3.1、在GitHub上點擊“Add file”->“Create new file”，
  
• 3.2、填入LICENSE，右邊會出現“Choose a license template”按鈕，點擊跳轉頁面，
  
• 3.3、選擇“MIT License”，點擊“Review and submit”，
  
• 3.4、選擇“Commit directly to the master branch”，點擊“Commit new file”，
  

4、拉取遠程最新代碼，包含LICENSE檔案，
5、驗證podspec檔案，執行pod lib lint RCUtility.podspec --allow-warnings（如果是“pod spec lint RCUtility.podspec --allow-warnings”則會出現tag的ERROR），出現“RCUtility passed validation.”則驗證通過，接下來要添加tag，
6、添加tag：執行git tag 0.0.1添加一個tag，（“git tag”可以顯示本地所有tag，“git ls-remote --tags origin”可以顯示遠程所有tag），執行“git push --tags”推送tag到遠程，
7、再次驗證podspec檔案，執行pod spec lint RCUtility.podspec --allow-warnings，出現“RCUtility.podspec passed validation.”則驗證通過，不再出現tag錯誤，

8、發布到CocoaPods之前如果未注冊CocoaPods，先注冊：

• 8.1、先驗證是否已經注冊，執行pod trunk me，回傳注冊資訊則已經注冊；回傳“[!] Authentication token is invalid or unverified. Either verify it with the email that was sent or register a new session.”則需要重新注冊；回傳“[!] There was an error fetching your info from trunk: execution expired”則已經成功注冊，重試直到出現注冊資訊，
• 8.2、注冊CocoaPods執行pod trunk register xxx@qq.com "crx" --verbose，出現“[!] Please verify the session by clicking the link in the verification email that has been sent to xxx@qq.com”之后查看郵箱點擊鏈接驗證即可，

9、發布到CocoaPods：

• 9.1、執行pod trunk push RCUtility.podspec --allow-warnings，出現錯誤：
  
  cocoapods版本為1.7.2，cocoapods-trunk版本為1.5.0，執行sudo gem uninstall cocoapods-trunk卸載cocoapods-trunk1.5.0版本，然后執行sudo gem install cocoapods-trunk -v 1.3.1安裝cocoapods-trunk1.3.1版本（卸載時好像有提示cocoapods1.7.2需要cocoapods-trunk>=1.3.1,<2.0）（rubygems.org可以查看cocoapods-trunk有哪些版本，當前最新1.5.0，cocoapods最新1.10.1），
• 9.2、重新執行pod trunk push RCUtility.podspec --allow-warnings，出現“Updating spec repo ‘master’”要等1小時最后出現如下：
  
• 9.3、執行pod search RCUtility出現錯誤“[!] Unable to find a pod with name, author, summary, or description matching ‘RCUtility’”，先洗掉“~/Library/Caches/CocoaPods/”目錄下的search_index.json檔案，再重新執行search，會出現“Creating search index for spec repo ‘master’… ”，5min后出現搜索結果并且重新生成search_index.json，

10、將RCUtility.podspec檔案commit到git倉庫，

Framework添加單元測驗

1、點擊TARGETS左下角“+”，彈出視窗選擇iOS->Test->Unit Testing Bundle，Product Name填“庫名稱+Tests”，Target to be Tested選擇庫RCUtility（不是RCUtilityDemo），添加之后，TARGETS會多一個RCUtilityTests，左側導航視窗會多一個RCUtilityTests目錄，

2、“#import “RCFirst.h””匯入Framework中一個類，寫一個以test開頭的方法，方法里面寫測驗代碼，點擊test方法左邊菱形執行測驗用例，測驗通過則菱形變成綠色，
2.1、“#import “RCFirst.h””出現警告“Missing submodule ‘RCUtility.RCFirst’”，則在RCUtility.h檔案中加上“#import “RCFirst.h””即可消除警告（不加這句也不會影響其他專案通過cocoapods的方式使用這個庫），加上之后又出現一個警告“Double-quoted include “RCFirst.h” in framework header, expected angle-bracketed instead”，通過設定TARGETS->“RCUtility”->“Build Settings”->“Quoted Include In Framework Header”為NO可以消除警告，或者改為“#import <RCUtility/RCFirst.h>”，

3、可以使用主專案測驗Framework，也可以使用單元測驗，

CocoaPods實作組件化

組件化的目的是為了不同產品共用相同模塊，避免相同模塊重復開發，

1、cd到任意目錄如TempProjects下，執行pod lib create RCAudioEngine創建庫，會在TempProjects目錄下創建一個RCAudioEngine目錄，里面包含Example目錄（雖然設定了include a demo app為No但是還是創建了一個測驗工程）、LICENSE、RCAudioEngine目錄（里面包含這個庫的類檔案）、RCAudioEngine.podspec、README.md，并且已經初始化了git并且有提交，TempProjects->RCAudioEngine目錄下的檔案有些需要洗掉、有些需要保留、有些需要修改、有些位置需要移動，所以沒有直接在CBD相關目錄下執行pod lib create創建庫，



2、在CBD目錄下創建一個存放本地組件庫的目錄，命名為LocalPods，
3、在LocalPods目錄下創建一個庫目錄RCAudioEngine，添加相關檔案：

• 3.1、將xx/TempProjects/RCAudioEngine目錄下的LICENSE、READEME.md移動到這里（即xx/LocalPods/RCAudioEngine目錄，之后的檔案和創建目錄都是放在這個目錄下），
• 3.2、創建一個Classes目錄，將任意檔案如一對.h、.m放到這個目錄下（這些檔案之后可以洗掉），
• 3.3、將xx/TempProjects/RCAudioEngine目錄下的RCAudioEngine.podspec移動到這里，修改如下：
  主要是修改s.source_files為庫檔案所在目錄，其他保持默認，洗掉注釋，

Pod::Spec.new do |s|
  s.name             = 'RCAudioEngine'
  s.version          = '0.1.0'
  s.summary          = 'A short description of RCAudioEngine.'
  s.homepage         = 'https://github.com/rccrx/RCAudioEngine'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { 'rccrx' => 'rccrx@qq.com' }
  s.source           = { :git => 'https://github.com/rccrx/RCAudioEngine.git', :tag => s.version.to_s }
  s.ios.deployment_target = '9.0'
  s.source_files = 'Classes/**/*'
end

• 3.4、修改CBD的Podfile，添加pod 'RCAudioEngine', :path => './LocalPods/RCAudioEngine'（path是本地組件庫RCAudioEngine的目錄相對CBD的Podfile的位置），cd的CBD目錄執行pod install，就會在左側導航面板Pods工程下出現一個Development Pods目錄，里面有本地組件庫，
  
  
• 3.5、如果需要資源目錄（不需要不用創建），則：
  【如果使用靜態庫（即CBD的Podfile沒有use_frameworks!），推薦使用“s.resource_bundles=xx”而不是“s.resources=xx”，因為resources中的圖片會與主工程中的圖片有重名風險，】
  • 3.5.1、使用resource_bundles：
    • 3.5.1.1、在LocalPods/RCAudioEngine目錄下創建一個目錄Assets，里面放入任意一個檔案比如d3.png，
    • 3.5.1.2、修改RCAudioEngine.podspec添加s.resource_bundles = { 'RCAudioEngine' => ['Assets/**/*'] }，執行pod install，在Development Pods->RCAudioEngine下自動生成Resources目錄，目錄下有資源檔案，
    • 3.5.1.3、不使用“use_frameworks!”，編譯之后的CBD->Products下的CBD.app里面會包含RCAudioEngine.bundle檔案（Assets.car中只包含添加到主工程CBD->CBD->Assets.xcassets中的圖片）（并且工程Pods->Products下也生成RCAudioEngine.bundle檔案），因此RCAudioEngine.bundle里面的檔案使用方式為：
      

NSBundle *aeBundle = [NSBundle bundleWithPath:[[NSBundle mainBundle] pathForResource:@"RCAudioEngine" ofType:@"bundle"]];
UIImage *image = [UIImage imageWithContentsOfFile:[aeBundle pathForResource:@"d3.png" ofType:nil]];

使用“[UIImage imageNamed:@“d3.png”]”是無法獲取圖片的，不管是在RCAudioEngine庫中還是主工程CBD中都無法顯示，

• 3.5.1.4、不要在RCAudioEngine/Assets下創建Asset Catalog檔案：如果在Development Pods->RCAudioEngine->Resources下創建一個RCAudioEngineAssets.xcassets（檔案存盤路徑為RCAudioEngine下的Assets，Targets勾選RCAudioEngine-RCAudioEngine，就算不勾選或者勾選其他也會在pod install之后Target Membership自動變成RCAudioEngine-RCAudioEngine），則會生成一個Assets.car在工程Pods->Products->RCAudioEngine.bundle中，但不在主工程CBD->Products->CBD.app->RCAudioEngine.bundle中，且CBD->Products->CBD.app->Assets.car中沒有包含RCAudioEngineAssets.xcassets中的圖片（用AssetCatalogTinkerer打開），所以不使用Asset Catalog，

  • 3.5.2、使用resources：
    • 3.5.2.1、右鍵Development Pods->RCAudioEngine，選擇New Group創建Resources目錄，這個目錄和Classes目錄同級，這個目錄之后可以放xx.xcassets等資源檔案，比如選中這個目錄，按Command+N新建檔案，在彈出的視窗中選擇iOS->Resource->Asset Catalog，檔案存盤路徑為RCAudioEngine下的Resources，Group為Resources，Targets不勾選，確定之后會在Resources目錄下生成一個檔案RCAudioEngine.xcassets，
      
    • 3.5.2.2、修改RCAudioEngine.podspec添加s.resources = 'Resources/**/*'，否則pod install之后這個目錄就不顯示在Development Pods->RCAudioEngine，（或者在Finder中創建一個Res目錄放入一張圖片，然后s.resources = ‘Res/**/*’，執行pod install會在Development Pods->RCAudioEngine下生成Resources目錄，名稱不是Res，）
    • 3.5.2.3、添加到Res目錄中的圖片，可以直接在CBD主工程、RCAudioEngine庫中通過“[UIImage imageNamed:@“d3.png”]”使用，因為這個圖片直接在CBD->Products下的CBD.app里面，沒有RCAudioEngine.bundle，
    • 3.5.2.4、添加到RCAudioEngine.xcassets中的圖片，在編譯時出現錯誤“Mutiple commands produce ‘xx/CBD.app/Assets.car’”也許是指主工程CBD下Assets.xcassets和工程Pods->Development Pods->RCAudioEngine下的RCAudioEngine.xcassets都生成名字為Assets.car的檔案，暫時不解決這個問題，使用resource_bundles，
      

• 3.6、在Finder中RCAudioEngine/Classes目錄下創建兩個目錄Public、Model（因為右鍵New Group會在Classes同級目錄下生成新目錄，所以在Finder中手動創建Classes下的子目錄），在這兩個目錄中放入任意檔案再執行pod install，會在Development Pods->RCAudioEngine下出現這兩個目錄（如果目錄中沒有檔案則不出現），
  

  • 3.6.1、刪掉ViewController.h、ViewController.m、T1.h、T2.h（選中右鍵->Delete->Move to Trash），在Model中創建RCFirstModel.h.m、Public創建RCFirstPublic.h.m，彈出視窗的Targets勾選RCAudioEngine，
  • 3.6.2、在CBD主工程中使用這個兩個類“#import “RCFirstPublic.h” #import “RCFirstModel.h””，報錯“‘RCFirstPublic.h’ file not found”，執行“pod install”之后就不再報錯了（每次新增洗掉檔案都要pod install），
  • 3.6.3、如果只想暴露Public目錄下的檔案給主工程使用，則修改RCAudioEngine.podspec添加s.public_header_files = 'Classes/Public/**/*.h'，這樣主工程“#import “RCFirstPublic.h””不會報錯，“#import “RCFirstModel.h””報錯，
  • 3.6.4、給RCFirstPublic添加方法aString，編譯通過，運行時出現錯誤“+[RCFirstPublic aString]: unrecognized selector sent to class 0x104e5e298”，Shift+Command+K進行clean，然后重新run，
  • 3.6.5、修改RCAudioEngine庫中的檔案如RCFirstPublic之后，要執行pod install，才會在主工程中使用時有補全提示，

• 3.7、prefix_header_file：

  • 3.7.1、默認在Development Pods->RCAudioEngine->Support Files下自動生成RCAudioEngine-prefix.pch檔案，如果不想生成這個檔案，則修改RCAudioEngine.podspec添加s.prefix_header_file = false，
  • 3.7.2、添加pch檔案步驟（但是不推薦使用，因為cocoapods.org中提示Pod不應該污染其他庫或用戶工程的prefix header）：選中Development Pods->RCAudioEngine->Pod新建檔案“iOS->Other->PCH File”，名稱RCAudioEnginePrefix，存盤位置選Classes，Group選Pod，Targets不勾選，修改RCAudioEngine.podspec為s.prefix_header_file = 'Classes/RCAudioEnginePrefix.pch'，執行pod install之后，這個檔案出現在Development Pods->RCAudioEngine而不是其下的Pod中，檔案中的內容都自動拼接到原RCAudioEngine-prefix.pch檔案結尾，

• 3.8、將本地組件庫RCAudioEngine的代碼加到主工程CBD的git：

  • 3.8.1、因為之前測驗時添加了一些檔案，又洗掉了，導致Sourcetree的CBD倉庫也顯示這些檔案，執行“git status”發現這些檔案在“Changes to be committed:”顯示為new file，在“Changes not staged for commit:”顯示為deleted，執行“git restore --staged 檔案如LocalPods/RCAudioEngine/Resources/RCAudioEngine.xcassets”，這樣Sourcetree就不顯示這些檔案了，
  • 3.8.2、Sourcetree的CBD倉庫勾選全部檔案（特別是LocalPods目錄下全部檔案），commit，