從前端到obj-c有小半年了,文章又快有一年沒有更新過了,前幾天才把域名續(xù)費(fèi)了3年,感嘆第一個(gè)三年就這樣過去了….所以決定不能再像以前那樣懶了,每天堅(jiān)持把自己的學(xué)習(xí)都記錄下來然后有空的時(shí)候整理下發(fā)布到小站,于是有了obj-c的第一篇. 如何安裝?1.安裝ruby環(huán)境,添加淘寶ruby鏡像
2.查看是否設(shè)置成功:
3.然后安裝cocoapods:
4.查看cocoapods是否支持某個(gè)類庫
如何使用?
注:Podfile也可以放在任何位置,但是需要在Podfile頂部使用”xcodeproj”關(guān)鍵字指定工程的路徑,如下: 但是執(zhí)行pod install命令后,生成的文件放在了Podfile所在的目錄.
注:有些第三方庫需要指明:platform 支持的IOS最低版本,否則在pod install時(shí)會(huì)報(bào)錯(cuò),如下圖,提示AFNetworking最低支持IOS6.0和OS X 10.8
注意上述命令運(yùn)行完畢后終端輸出的最后一段話,意思就是以后打開項(xiàng)目就用CocoaPodsDemo.xcworkspace 打開,而不是之前的.xcodeproj文件。
經(jīng)過以上步驟后,我們現(xiàn)在可以打開CocoaPodsDemo.xcworkspace啟動(dòng)我們的新工程了.新工程中已經(jīng)通過cocoapods引入并配置好了我們剛在podfile寫的需要依賴的第三方庫了. 引入第三方庫后找不到頭文件?在項(xiàng)目的Targe-Build Settings-Search Paths-User Header Searcj Paths中添加 ${SRCROOT} 值為 recursive 如下圖: 如何編譯從github上checkout下來的一個(gè)已包含CocoPods類庫的項(xiàng)目?打開終端進(jìn)入你所下載項(xiàng)目的根目錄,執(zhí)行以下命令,后會(huì)得到上面的那句話:
等待命令運(yùn)行完畢后,同樣最后會(huì)輸出
如何刪除cocopods?
CocoaPods常用命令1、pod install 根據(jù)Podfile文件指定的內(nèi)容,安裝依賴庫,如果有Podfile.lock文件而且對(duì)應(yīng)的Podfile文件未被修改,則會(huì)根據(jù)Podfile.lock文件指定的版本安裝。 每次更新了Podfile文件時(shí),都需要重新執(zhí)行該命令,以便重新安裝Pods依賴庫。 2、pod update 若果Podfile中指定的依賴庫版本不是寫死的,當(dāng)對(duì)應(yīng)的依賴庫有了更新,無論有沒有Podfile.lock文件都會(huì)去獲取Podfile文件描述的允許獲取到的最新依賴庫版本。 3、pod search 命令格式為:
紅框中的信息為AFNetworking 最新版本,Version中顯示了歷史版本,根據(jù)這些信息來編寫我們的Podfile文件如:
這句話具體含義是什么呢?
4、pod setup 用于跟新本地電腦上的保存的Pods依賴庫tree。由于每天有很多人會(huì)創(chuàng)建或者更新Pods依賴庫,這條命令執(zhí)行的時(shí)候會(huì)相當(dāng)慢,還請(qǐng)耐心等待。我們需要經(jīng)常執(zhí)行這條命令,否則有新的Pods依賴庫的時(shí)候執(zhí)行pod search命令是搜不出來的。 ①多個(gè)target中使用相同的Pods依賴庫 比如,名稱為CocoaPodsTest的target和Second的target都需要使用Reachability、SBJson、AFNetworking三個(gè)Pods依賴庫,可以使用link_with關(guān)鍵字來實(shí)現(xiàn),將Podfile寫成如下方式:
這種寫法就實(shí)現(xiàn)了CocoaPodsTest和Second兩個(gè)target共用相同的Pods依賴庫。 ②不同的target使用完全不同的Pods依賴庫 CocoaPodsTest這個(gè)target使用的是Reachability、SBJson、AFNetworking三個(gè)依賴庫,但Second這個(gè)target只需要使用OpenUDID這一個(gè)依賴庫,這時(shí)可以使用target關(guān)鍵字,Podfile的描述方式如下:
其中,do/end作為開始和結(jié)束標(biāo)識(shí)符。 Podfile.lock文件在使用CocoaPods,執(zhí)行完pod install之后,會(huì)生成一個(gè)Podfile.lock文件。這個(gè)文件看起來跟我們關(guān)系不大,實(shí)際上絕對(duì)不應(yīng)該忽略它。
Podfile.lock文件最大得用處在于多人開發(fā)。當(dāng)團(tuán)隊(duì)中的某個(gè)人執(zhí)行完pod install命令后,生成的Podfile.lock文件就記錄下了當(dāng)時(shí)最新Pods依賴庫的版本,這時(shí)團(tuán)隊(duì)中的其它人check下來這份包含Podfile.lock文件的工程以后,再去執(zhí)行pod install命令時(shí),獲取下來的Pods依賴庫的版本就和最開始用戶獲取到的版本一致。如果沒有Podfile.lock文件,后續(xù)所有用戶執(zhí)行pod install命令都會(huì)獲取最新版本的SBJson,這就有可能造成同一個(gè)團(tuán)隊(duì)使用的依賴庫版本不一致,這對(duì)團(tuán)隊(duì)協(xié)作來說絕對(duì)是個(gè)災(zāi)難!
鑒于Podfile.lock文件對(duì)團(tuán)隊(duì)協(xié)作如此重要,我們需要將它添加到版本管理中。 如何制作自己的Cocopods庫1.在github上新建一個(gè)工程 license類型 正規(guī)的倉庫都應(yīng)該有一個(gè)license文件,Pods依賴庫對(duì)這個(gè)文件的要求更嚴(yán),是必須要有的。因此最好在這里讓github創(chuàng)建一個(gè),也可以自己后續(xù)再創(chuàng)建。我使用的license類型是MIT。 把項(xiàng)目clone到本地然后在根目錄下新建MyPodDemo.podspec 或使用命令 $ pod spec create MyPodDemo Spec文件編寫: Pod::Spec.new do |s| s.name = "MyPodDemo" s.version = "0.0.1" s.summary = "A short description of MyPodDemo." s.description = <<-DESC A longer description of MyPodDemo in Markdown format. * Think: Why did you write this? What is the focus? What does it do? * CocoaPods will be using this to generate tags, and improve search results. * Try to keep it short, snappy and to the point. * Finally, don't worry about the indent, CocoaPods strips it! DESC s.homepage = "https://github.com/goingta/MyPodDemo" s.license = "MIT" s.author = { "goingta" => "tangle1128@gmail.com" } s.source = { :git => "https://github.com/goingta/MyPodDemo.git", :tag => "0.0.1" } s.source_files = "MyPodDemo/Src", "MyPodDemo/Src/**/*.{h,m}" s.requires_arc = true # s.framework = "SomeFramework" # s.frameworks = "SomeFramework", "AnotherFramework" # s.library = "iconv" # s.libraries = "iconv", "xml2" # s.dependency "JSONKit", "~> 1.4" # s.dependency "AFNetworking", "~> 2.2.4" end 自解析: name: 導(dǎo)入pod后的目錄名 version: 當(dāng)前版本號(hào) deployment_target: 配置的target prefix_header_file: 預(yù)編譯頭文件路徑,將該文件的內(nèi)容插入到Pod的pch文件內(nèi) source: 來源的具體路徑,是http鏈接還是本地路徑 requires_arc: 是否需要arc source_files: 指定該目錄下包含哪些文件 其他可選參數(shù)還包括: dependency: 指定依賴,如果依賴的庫不存在或者依賴庫的版本不符合要求將會(huì)報(bào)錯(cuò) libraries: 指定導(dǎo)入的庫,比如sqlite3 frameworks: 指定導(dǎo)入的framework weak_frameworks: 弱鏈接,比如說一個(gè)項(xiàng)目同時(shí)兼容iOS6和iOS7,但某一個(gè)framework只在iOS7上有,這時(shí)候如果用強(qiáng)鏈接,那么在iOS7上運(yùn)行就會(huì)crash,使用weak_frameworks可以避免這種情況。 整個(gè)podspec語法是一個(gè)嵌套結(jié)構(gòu)從Pod::Spec.new do |s|到最后一個(gè)end是最大的循環(huán),表示整個(gè)podspec導(dǎo)入的文件。中間每一個(gè)subspec到end結(jié)束是一個(gè)子目錄,Pods會(huì)為每個(gè)subspec創(chuàng)建一個(gè)邏輯目錄,相當(dāng)于Xcode的group概念。|**|中間是subspec的名字,可以隨便命名,但后面使用的名稱必須一致。 通配符說明
寫完podspec文件后使用pod spec lint驗(yàn)證spec是否合格,有error則需要修改
上傳代碼至github上傳podspec文件到CocoaPods倉庫(fork一下,修改完成后在push上去等待審核) 將我們剛剛生成的MyPodDemo.spec 文件上傳到Cocoapods官方specs倉庫中 : 私有庫實(shí)現(xiàn),編寫podfile如果由于某些原因我們編寫的庫不能公開,但是又想使用pods來進(jìn)行管理,要怎么辦呢? 首先我們要將我們剛剛在github上建的倉庫改為Private(不然還用Public搞毛啊) 然后修改我們項(xiàng)目的podfile,與已加入Cocopods倉庫的公有庫相比我們只需要指明私有庫低git地址,如下: platform :ios, '6.0' pod 'MyPodDemo', :git => 'https://github.com/goingta/MyPodDemo.git' //私有庫 pod 'CocoaLumberjack'//公有庫 版本控制和沖突(引用自http:///issue-6-4/)CocoaPods 使用語義版本控制 – Semantic Versioning 命名約定來解決對(duì)版本的依賴。由于沖突解決系統(tǒng)建立在非重大變更的補(bǔ)丁版本之間,這使得解決依賴關(guān)系變得容易很多。例如,兩個(gè)不同的 pods 依賴于 CocoaLumberjack 的兩個(gè)版本,假設(shè)一個(gè)依賴于2.3.1,另一個(gè)依賴于 2.3.3,此時(shí)沖突解決系統(tǒng)可以使用最新的版本 2.3.3,因?yàn)檫@個(gè)可以向后與 2.3.1 兼容。 但這并不總是有效。有許多第三方庫并不使用這樣的約定,這讓解決方案變得非常復(fù)雜。 當(dāng)然,總會(huì)有一些沖突需要手動(dòng)解決。如果一個(gè)庫依賴于 CocoaLumberjack 的 1.2.5,另外一個(gè)庫則依賴于 2.3.1,那么只有最終用戶通過明確指定使用某個(gè)版本來解決沖突。 配置非ARC文件(8.5號(hào)補(bǔ)充)前幾天項(xiàng)目中由于歷史原因,導(dǎo)致有一個(gè)私有的pods庫中某幾個(gè)文件是在非ARC時(shí)代寫的,如果要進(jìn)行修改工程量浩大,于是乎要對(duì)這幾個(gè)文件單獨(dú)處理,這幾個(gè)文件不使用arc其他文件使用arc,網(wǎng)上查了一些資料,只需要對(duì)source_file進(jìn)行修改并排除那幾個(gè)不使用ARC的文件就可以了,大致修改如下: Pod::Spec.new do |s| s.name = "MyPodDemo" s.version = "0.0.1" s.summary = "A short description of MyPodDemo. s.homepage = "https://github.com/goingta/MyPodDemo" s.license = "MIT" s.author = { "goingta" => "tangle1128@gmail.com" } s.source = { :git => "https://github.com/goingta/MyPodDemo.git", :tag => "0.0.1" } s.source_files = "MyPodDemo" non_arc_files = 'MyPodDemo/NoArcFile1.{h,m}','MyPodDemo/NoArcFile2.{h,m}' s.requires_arc = true s.exclude_files = non_arc_files s.subspec 'no-arc' do |sna| sna.requires_arc = false sna.source_files = non_arc_files end end 回退Cocoapods歷史版本(2015.3.17號(hào)補(bǔ)充)查看當(dāng)前安裝了哪些版本 gem list --local | grep cocoapods 如果你安裝了多個(gè)版本(如0.35和0.20.2)那么你將看到 cocoapods (0.34, 0.20.2) cocoapods-core (0.33, 0.20.2) cocoapods-downloader (0.2.0, 0.1.2) 先刪除已經(jīng)裝過的版本(可能有幾個(gè),卸載的時(shí)候會(huì)讓你輸入1,2..n選擇卸載那個(gè)版本 sudo gem uninstall cocoapods 或者強(qiáng)制卸載某一個(gè)版本 gem uninstall cocoapods -v 0.20.2 安裝某一個(gè)版本 sudo gem install cocoapods -v 0.35.0 處理 Use the `$(inherited)` flag 異常(2015.6.03補(bǔ)充)有時(shí)候在pod update之后會(huì)遇到下面錯(cuò)誤: - Use the `$(inherited)` flag, or - Remove the build settings from the target. 雖然對(duì)項(xiàng)目編譯沒什么影響,但是看著還是挺不舒服的.解決辦法就是 找到工程的 targets 點(diǎn)擊工程名 Build Settings -> Other linker flags -> 添加 $(inherited) |
|