Cocoa的依賴管理器,我們已經(jīng)有了CocoaPods飒炎,非常好用埋哟,那么為什么還要創(chuàng)建這樣一個項目呢?本文翻譯自Carthage的Github的README.md郎汪,帶大家來了解一下這個工具有何不同之處赤赊。
Carthage的目標是用最簡單的方式來管理Cocoa第三方框架。
基本的工作流如下:
創(chuàng)建一個Cartfile煞赢,包含你希望在項目中使用的框架的列表
運行Carthage抛计,將會獲取列出的框架并編譯它們
將編譯完成的.framework二進制文件拖拽到你的Xcode項目當中
Carthage編譯你的依賴,并提供框架的二進制文件照筑,但你仍然保留對項目的結(jié)構(gòu)和設(shè)置的完整控制吹截。Carthage不會自動的修改你的項目文件或編譯設(shè)置。
Carthage與CocoaPods的不同
CocoaPods是已存在很長時間的Cocoa依賴管理器凝危,那么為什么要創(chuàng)建Carthage呢波俄?
首先,CocoaPods默認會自動創(chuàng)建并更新你的應(yīng)用程序和所有依賴的Xcode workspace蛾默。Carthage使用xcodebuild來編譯框架的二進制文件懦铺,但如何集成它們將交由用戶自己判斷。CocoaPods的方法更易于使用趴生,但Carthage更靈活并且是非侵入性的阀趴。
CocoaPods的目標在它的README文件描述如下:
…為提高第三方開源庫的可見性和參與度,創(chuàng)建一個更中心化的生態(tài)系統(tǒng)苍匆。
與之對照刘急,Carthage創(chuàng)建的是去中心化的依賴管理器。它沒有總項目的列表浸踩,這能夠減少維護工作并且避免任何中心化帶來的問題(如中央服務(wù)器宕機)叔汁。不過,這樣也有一些缺點,就是項目的發(fā)現(xiàn)將更困難据块,用戶將依賴于Github的趨勢頁面或者類似的代碼庫來尋找項目码邻。
CocoaPods項目同時還必須包含一個podspec文件,里面是項目的一些元數(shù)據(jù)另假,以及確定項目的編譯方式像屋。Carthage使用xcodebuild來編譯依賴,而不是將他們集成進一個workspace边篮,因此無需類似的設(shè)定文件己莺。不過依賴需要包含自己的Xcode工程文件來描述如何編譯。
最后戈轿,我們創(chuàng)建Carthage的原因是想要一種盡可能簡單的工具——一個只關(guān)心本職工作的依賴管理器凌受,而不是取代部分Xcode的功能,或者需要 讓框架作者做一些額外的工作思杯。CocoaPods提供的一些特性很棒胜蛉,但由于附加的復(fù)雜性,它們將不會被包含在Carthage當中色乾。
安裝Carthage
Carthage提供OS X平臺的pkg安裝文件誊册,你可以從Github的最新release中找到,按照引導(dǎo)一步步安裝即可杈湾。
如果你想安裝最新的開發(fā)版本(可能存在穩(wěn)定性和兼容性的問題)解虱,你只需要clone本倉庫的master分支,然后運行make install.
添加框架到應(yīng)用程序
安裝完Carthage后漆撞,你能夠使用它來添加框架到你的項目。注意Carthage只支持動態(tài)框架于宙,而后者只存在于iOS 8以上(以及任意版本的OS X)浮驳。
開始使用:
創(chuàng)建一個Cartfile,將你想要使用的框架列在里面
運行carthage update捞魁,將獲取依賴文件到一個Carthage.checkout文件夾至会,然后編譯每個依賴
在你的應(yīng)用程序target的“General”設(shè)置標簽中的“Embedded Binaries”區(qū)域,將框架從Carthage.build文件夾拖拽進去谱俭。
在這個過程當中奉件,Carthage將創(chuàng)建一些build artifacts,其中最重要的是Cartfile.lock文件昆著,里面將列出每個框架的具體版本县貌,確保你提交了這個文件到版本控制工具里面(如Git、SVN)凑懂,因為每個用到項目的人都需要它來編譯相同版本的框架煤痕。
完成上面的步驟并提交你的修改,項目的其他用戶就只需要獲取該倉庫并執(zhí)行carthage bootstrap就能使用你所添加的框架。
添加框架到單元測試或另一個框架
使用Carthage添加框架到任意目標的方法摆碉,和添加到應(yīng)用程序差不多塘匣。主要的不同在于框架是如何設(shè)置并鏈接到Xcode的。
因為非應(yīng)用程序目標沒有“Embedded Binaries”設(shè)置區(qū)域巷帝,你需要將編譯完成后的框架拖拽到“Link Binaries With Libraries”的區(qū)域里忌卤。
在某些稀有案例中,你也許會想要復(fù)制每個依賴到已編譯的項目中(比如楞泼,在外部框架中嵌入依賴埠巨,或確保依賴在測試工具中正常顯示)。想要達到這個目的现拒,你需要創(chuàng)建一個新的“Copy Files”編譯選項和“Frameworks”組辣垒,然后將框架的引用添加到里面。
升級框架
如果你改動了你的Cartfile印蔬,或者你想升級到框架的最新版本(服從于你指定的需求版本)勋桶,執(zhí)行carthage update命令可以達到目的。
讓你的框架支持Carthage
Carthage只正式支持動態(tài)框架侥猬,動態(tài)框架能夠在任何版本的OS X上使用例驹,但只能在iOS 8及以上版本使用。
因為Carthage擁有非中心化的包列表退唠,以及沒有項目指定的編譯設(shè)置鹃锈,大多數(shù)框架應(yīng)該能自動編譯。
分享你的Xcode schemes
Carthage將只從你的.xcodeproj中標記為已分享的Xcode schemes來編譯瞧预。如果你想檢查編譯是否成功屎债,執(zhí)行carthage build --no-skip-current命令,然后檢查Carthage.build文件夾垢油。
如果當執(zhí)行命令但有scheme沒有被編譯盆驹,打開Xcode并確定對應(yīng)scheme被標記為“Shared”,以便Carthage能夠發(fā)現(xiàn)它滩愁。
解決編譯失敗
如果你在執(zhí)行carthage build --no-skip-current時編譯失敗躯喇,嘗試執(zhí)行xcodebuild -scheme SCHEME -workspace WORKSPACE build 或xcodebuild -scheme SCHEME -project PROJECT build(將其中的大寫單詞換成你項目的對應(yīng)名稱),然后觀察是否有相同的失敗發(fā)生硝枉,這應(yīng)該能生成足夠的失敗信息來解決問題廉丽。
穩(wěn)定版發(fā)布的標簽
Carthage使用語義化標簽來發(fā)布穩(wěn)定版本。如1.2.0妻味,如帶有字母則是不受支持的版本(如1.2-alpha-1).
CarthageKit
大多數(shù)carthage命令行工具的功能都封裝在一個名為CarthageKit的框架中正压。
如果你希望將Carthage作為另一個工具的一部分,或者希望擴展Carthage的功能弧可,可以看看CarthageKit的源碼蔑匣,檢查API是否符合你的需求劣欢。
授權(quán)協(xié)議
Carthage使用MIT開源協(xié)議授權(quán)發(fā)布。