Carthage的安裝與使用

1. brew

安裝Carthage之前需要安裝brew,進入官網(https://brew.sh/index_zh-cn.html) 有詳細的安裝步驟。

獲取 Homebrew

打開終端Tterminal,輸入以下命令:

 /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" 
獲取 最新版本
brew update

注意:如果遇到Error: The /usr/local directory is not writable.錯誤,就執行以下命令sudo chown -R $(whoami):admin /usr/local,再更新。

其他 brew命令
brew install git // 使用brew安裝軟件
brew uninstall wget // 使用brew卸載軟件
brew search /wge*/  // 使用brew查詢軟件,其中/wge*/是個正則表達式,需要包含在/中
brew list  // 列出已安裝的軟件
brew home   // 用瀏覽器打開brew的官方網站
brew info   // 顯示軟件信息
brew deps   // 顯示包依賴

2.安裝 Carthage

安裝brew之后,就可以安裝Carthage了。

brew install carthage

安裝Carthage之后,查看版本

carthage version

3.使用 Carthage

進入項目所在文件夾

cd ~/Path/Project  // 進入項目所在文件夾

創建一個空的carthage文件

touch Cartfile  // 此時你的項目文件夾里會創建一個名為Cartfile的文件

使用Xcode打開Cartfile文件

open -a Xcode Cartfile

編輯Cartfile

github "SVProgressHUD/SVProgressHUD" ~> 1.0

~> 3.0 表示使用版本3.0以上但是低于4.0的最新版本,如3.5, 3.9

== 3.0 表示使用3.0版本

>= 3.0表示使用3.0或更高的版本

如果你沒有指明版本號,則會自動使用最新的版本

Cartfile格式說明

依賴源 Dependency origin

Carthage支持兩種類型的源,一個是github,另一個是git。

github 表示依賴源,告訴Carthage去哪里下載文件。依賴源之后跟上要下載的庫,格式為Username/ProjectName
git 關鍵字后面跟的是資料庫的地址,可以是遠程的URL地址,使用git://, http://, ssh://,或者是本地資料庫地址。

4. 運行 Carthage

保存并關閉Cartfile文件,回到終端,執行以下命令:

carthage update --platform iOS

carthage會clone文件中對應的git第三方庫,把每一個第三方庫編譯成二進制文件的framework文件。

其中--platform iOS命令是可選的,作用是保證只為iOS編譯framework,如果不指定平臺,會為全平臺編譯framework文件。如果想要了解更多的命令,可以運行carthage help update查看。

當命令執行完畢,在Cartfile文件同級別的文件夾中生成一個名為“Carthage”文件夾和“Cartfile.resolved”文件。打開Carthage文件夾,可以看到兩個文件夾Build和Checkouts。

Cartfile.resolved:這個文件是輔助Cartfile的,需要被提交到版本庫中,它有助于其他開發者使用和你相同版本的第三方庫。

Build:包含每一個第三方庫創建生成的framework,可以被集成到項目中,每一個framework都是依賴于源文件或者GitHub上的Releases版本。

Checkouts:這里包含的是轉換成framework之前的源文件,Carthage有自己的緩存機制,所以不需要在不同的項目中對同一個的第三方庫clone多次。

對于是否把BuildCheckouts文件夾提交到版本庫取決于你,這不是必須的。如果提交的話,其他人clone了你的資料庫就可以使用這兩個文件中的內容。

不要改變Checkouts文件夾中的內容,因為如果使用carthage update 或者 carthage checkout命令的話,這個文件夾中的內容可以隨時被復寫,那么改動工作就白費了。如果一定要改動的話,在使用carthage update命令時,可以使用--use-submodules選項。如果加上這個選項的話,Carthage在添加每個依賴庫的時候就會作為一個字模塊。

如果其他人想要使用你的工程,你不需要在你的代碼中提交已經編譯好的framework,他們需要在check out你的工程之后執行carthage bootstrap命令。

bootstrap命令會根據Cartfile.resolved文件下載和編譯依賴庫的精確版本。另一方面,carthage update命令會更新項目中的第三方庫的最新的編譯版本,這是不可取的。

在"Carthage/Build/iOS"文件夾中會生成.framework文件。

Carthage生成目錄

注意, 如果遇到如下問題,解決方法如下:
*** Skipped downloading Alamofire.framework binary due to the error: "Bad credentials"
這個錯誤的原因是carthage通過git
向 Github API 發送請求時,要先取得GitHub憑證

解決辦法一

打開命令行工具terminal

1.檢查git
和osxkeychain helper
是否已經安裝$ git credential-osxkeychain# 如果出現以下提示說明已經安裝,進入第3步Usage: git credential-osxkeychain <get|store|erase># 如果出現以下提示說明未安裝,進入第2步xcode-select: note: no developer tools were found at '/Applications/Xcode.app',requesting install. Choose an option in the dialog to download the command line developer tools.

2.如果第一步提示未安裝,則使用Homebrew
來安裝git
。$ brew install git

3.告訴git
通過全局的credential.helper
的配置來使用osxkeychain helper
。$ git config --global credential.helper osxkeychain# Set git to use the osxkeychain credential helper

4.通過HTTPS URL
方式 clone 在github
上一份代碼下來,這個過程你有可能被提示輸入GitHub的用戶名和密碼來授權訪問OSX keychain
,此時,你的用戶名和密碼就會被保存在keychain
中了。# 可以進入系統桌面,創建一個臨時文件夾,用來clone代碼,之后再刪除即可$ cd$ cd Desktop$ mkdir tempdir$ cd tempdir$ git clone https://github.com/SVProgressHUD/SVProgressHUD.git

5.再次進入項目所在目錄,執行carthage update
命令,就可以看到問題解決了。參考:https://help.github.com/articles/caching-your-github-password-in-git/GitHub名稱密碼已更改,需要更新OSX Keychain
https://help.github.com/articles/updating-credentials-from-the-osx-keychain/

解決辦法二

參考:http://stackoverflow.com/questions/39578496/carthage-error-bad-credentials

5. 添加FrameWorks到項目中

點擊項目名稱-> target -> Gerneral -> Builf Phases,找到Linked Frameworks and Libraries

再點擊+ -> Add Other... -> Build/iOS SVProgressHUD.framework

Frameworks

目的是告訴Xcode鏈接你的app到這個framework,允許你在代碼中使用。

下一步選擇菜單上的Build Phases,并添加一個新的Run Script,并添加以下命令:

/usr/local/bin/carthage copy-frameworks

點擊Input Files下面的+號為每一個framework添加條目。

$(SRCROOT)/Carthage/Build/iOS/SVProgressHUD.framework

嚴格來講,build phase對項目運行來說不是必須的,但是,這巧妙的解決了APP因為使用的frameworks包含二進制圖像的iOS模擬器在提交APP Store時會被自動拒絕的問題。

carthage copy-frameworks命令剔除了額外的框架。

Run Script

command + B編譯項目,比已成功之后就可以使用了。

import SVProgressHUD

升級指定Frameworks

carthage update SVProgressHUD --platform iOS

原文章地址:http://www.lxweimin.com/p/a734be794019

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 229,362評論 6 537
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,013評論 3 423
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 177,346評論 0 382
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,421評論 1 316
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,146評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,534評論 1 325
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,585評論 3 444
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,767評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,318評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,074評論 3 356
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,258評論 1 371
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,828評論 5 362
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,486評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,916評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,156評論 1 290
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,993評論 3 395
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,234評論 2 375

推薦閱讀更多精彩內容