Carthage的安裝和使用(轉(zhuǎn))

轉(zhuǎn)自 https://blog.csdn.net/u011374880/article/details/78803903

Carthage和CocoaPods相比哮奇,輕量級一些要拂,在swift中使用很方便扁誓,它本身就是swift寫的缕粹。

1.brew

安裝carthage之前需要安裝brew岛抄,進(jìn)入官網(wǎng)(https://brew.sh/index_zh-cn.html) 有詳細(xì)的安裝步驟璃诀。

獲取 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.錯(cuò)誤谷暮,就執(zhí)行以下命令sudo chown -R $(whoami):admin /usr/local,再更新盛垦。

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

2.安裝Carthage

安裝brew之后腾夯,就可以安裝Carthage了颊埃。

brew install carthage

安裝Carthage之后,查看版本

carthage version // 目前的版本號為0.25.0

3. 使用Carthage

進(jìn)入項(xiàng)目所在文件夾
cd ~/路徑/項(xiàng)目文件夾
創(chuàng)建一個(gè)空的carthage文件
touch Cartfile

此時(shí)項(xiàng)目文件夾中會有一個(gè)名字為Carthage的文件

使用Xcode打開該文件
open -a Xcode Cartfile
編輯Cartfile
github "SVProgressHUD/SVProgressHUD" ~> 1.0

Cartfile格式說明

依賴源 Dependency origin

Carthage支持兩種類型的源蝶俱,一個(gè)是github班利,另一個(gè)是git

  1. github 表示依賴源榨呆,告訴Carthage去哪里下載文件罗标。依賴源之后跟上要下載的庫,格式為Username/ProjectName
  2. git 關(guān)鍵字后面跟的是資料庫的地址愕提,可以是遠(yuǎn)程的URL地址馒稍,使用git://, http://, ssh://皿哨,或者是本地資料庫地址浅侨。
依賴版本號 Dependency Version

告訴Carthage使用哪個(gè)版本,這是可選的证膨,不寫默認(rèn)使用最新版本

  1. == 1.0 表示使用1.0版本
  2. >= 1.0 表示使用1.0或更高的版本
  3. ~> 1.0 表示使用版本1.0以上但是低于2.0的最新版本如输,如1.2,1.6
  4. branch名稱 / tag名稱 / commit名稱,意思是使用特定的分支/標(biāo)簽/提交不见,比如可以是分支名master澳化,也可以是提交5c8a74a

4. 運(yùn)行Carthage

保存并關(guān)閉Cartfile文件稳吮,回到終端缎谷,執(zhí)行以下命令:

carthage update --platform iOS

carthage會clone文件中對應(yīng)的git第三方庫,把每一個(gè)第三方庫編譯成二進(jìn)制文件的framework文件灶似。

其中--platform iOS命令是可選的列林,作用是保證只為iOS編譯framework,如果不指定平臺酪惭,會為全平臺編譯framework文件希痴。如果想要了解更多的命令,可以運(yùn)行carthage help update查看春感。

當(dāng)命令執(zhí)行完畢砌创,在Cartfile文件同級別的文件夾中生成一個(gè)名為“Carthage”文件夾和“Cartfile.resolved”文件。打開Carthage文件夾鲫懒,可以看到兩個(gè)文件夾BuildCheckouts嫩实。

Cartfile.resolved:這個(gè)文件是輔助Cartfile的,需要被提交到版本庫中窥岩,它有助于其他開發(fā)者使用和你相同版本的第三方庫舶赔。
Build:包含每一個(gè)第三方庫創(chuàng)建生成的framework,可以被集成到項(xiàng)目中谦秧,每一個(gè)framework都是依賴于源文件或者GitHub上的Releases版本竟纳。

Checkouts:這里包含的是轉(zhuǎn)換成framework之前的源文件,Carthage有自己的緩存機(jī)制疚鲤,所以不需要在不同的項(xiàng)目中對同一個(gè)的第三方庫clone多次锥累。

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

不要改變Checkouts文件夾中的內(nèi)容诲宇,因?yàn)槿绻褂?code>carthage update 或者 carthage checkout命令的話际歼,這個(gè)文件夾中的內(nèi)容可以隨時(shí)被復(fù)寫,那么改動工作就白費(fèi)了姑蓝。如果一定要改動的話鹅心,在使用carthage update命令時(shí),可以使用--use-submodules選項(xiàng)纺荧。如果加上這個(gè)選項(xiàng)的話旭愧,Carthage在添加每個(gè)依賴庫的時(shí)候就會作為一個(gè)字模塊颅筋。

如果其他人想要使用你的工程,你不需要在你的代碼中提交已經(jīng)編譯好的framework输枯,他們需要在check out你的工程之后執(zhí)行carthage bootstrap命令议泵。

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

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

[圖片上傳失敗...(image-f4dc58-1525225592330)]

注意, 如果遇到如下問題池充,解決方法如下:

*** Skipped downloading Alamofire.framework binary due to the error:
    "Bad credentials"

這個(gè)錯(cuò)誤的原因是carthage通過git向 Github API 發(fā)送請求時(shí),要先取得GitHub憑證缎讼。

解決辦法一

打開命令行工具terminal

  • 1.檢查gitosxkeychain helper是否已經(jīng)安裝
$ git credential-osxkeychain
# 如果出現(xiàn)以下提示說明已經(jīng)安裝收夸,進(jìn)入第3步
Usage: git credential-osxkeychain <get|store|erase>
# 如果出現(xiàn)以下提示說明未安裝,進(jìn)入第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上一份代碼下來夹纫,這個(gè)過程你有可能被提示輸入GitHub的用戶名和密碼來授權(quán)訪問OSX keychain咽瓷,此時(shí),你的用戶名和密碼就會被保存在keychain中了舰讹。
# 可以進(jìn)入系統(tǒng)桌面茅姜,創(chuàng)建一個(gè)臨時(shí)文件夾,用來clone代碼月匣,之后再刪除即可
$ cd
$ cd Desktop
$ mkdir tempdir
$ cd tempdir
$ git clone https://github.com/SVProgressHUD/SVProgressHUD.git

解決辦法二

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

5. 添加Frameworks到項(xiàng)目中

點(diǎn)擊"項(xiàng)目名稱"-> "target" -> "Gerneral",在最底部找到"Linked Frameworks and Libraries"萍悴。

打開Carthage文件夾头遭,進(jìn)入Build\iOS,拖拽SVProgressHUD.framework到Xcode的**Linked Frameworks and Libraries **中癣诱。

[圖片上傳失敗...(image-810d6d-1525225592330)]

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

下一步選擇菜單上的Build Phases撕予,并添加一個(gè)新的Run Script鲫惶,并添加以下命令:

/usr/local/bin/carthage copy-frameworks

點(diǎn)擊Input Files下面的+號為每一個(gè)framework添加條目。

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

嚴(yán)格來講嗅蔬,build phase對項(xiàng)目運(yùn)行來說不是必須的剑按,但是疾就,這巧妙的解決了APP因?yàn)槭褂玫膄rameworks包含二進(jìn)制圖像的iOS模擬器在提交APP Store時(shí)會被自動拒絕的問題澜术。

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

[圖片上傳失敗...(image-68731f-1525225592330)]

command + B編譯項(xiàng)目,比已成功之后就可以使用了鸟废。

import SVProgressHUD

升級指定Frameworks
carthage update SVProgressHUD --platform iOS

參考

參考1:https://github.com/Carthage/Carthage
參考2:https://www.raywenderlich.com/109330/carthage-tutorial-getting-started

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末猜敢,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子盒延,更是在濱河造成了極大的恐慌缩擂,老刑警劉巖,帶你破解...
    沈念sama閱讀 207,113評論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件添寺,死亡現(xiàn)場離奇詭異胯盯,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)计露,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,644評論 2 381
  • 文/潘曉璐 我一進(jìn)店門博脑,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人票罐,你說我怎么就攤上這事叉趣。” “怎么了该押?”我有些...
    開封第一講書人閱讀 153,340評論 0 344
  • 文/不壞的土叔 我叫張陵疗杉,是天一觀的道長。 經(jīng)常有香客問我蚕礼,道長烟具,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 55,449評論 1 279
  • 正文 為了忘掉前任奠蹬,我火速辦了婚禮净赴,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘罩润。我一直安慰自己玖翅,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,445評論 5 374
  • 文/花漫 我一把揭開白布割以。 她就那樣靜靜地躺著金度,像睡著了一般。 火紅的嫁衣襯著肌膚如雪严沥。 梳的紋絲不亂的頭發(fā)上猜极,一...
    開封第一講書人閱讀 49,166評論 1 284
  • 那天,我揣著相機(jī)與錄音消玄,去河邊找鬼跟伏。 笑死丢胚,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的受扳。 我是一名探鬼主播携龟,決...
    沈念sama閱讀 38,442評論 3 401
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼勘高!你這毒婦竟也來了峡蟋?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 37,105評論 0 261
  • 序言:老撾萬榮一對情侶失蹤华望,失蹤者是張志新(化名)和其女友劉穎蕊蝗,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體赖舟,經(jīng)...
    沈念sama閱讀 43,601評論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡蓬戚,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,066評論 2 325
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了宾抓。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片子漩。...
    茶點(diǎn)故事閱讀 38,161評論 1 334
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖洞慎,靈堂內(nèi)的尸體忽然破棺而出痛单,到底是詐尸還是另有隱情,我是刑警寧澤劲腿,帶...
    沈念sama閱讀 33,792評論 4 323
  • 正文 年R本政府宣布旭绒,位于F島的核電站,受9級特大地震影響焦人,放射性物質(zhì)發(fā)生泄漏挥吵。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,351評論 3 307
  • 文/蒙蒙 一花椭、第九天 我趴在偏房一處隱蔽的房頂上張望忽匈。 院中可真熱鬧,春花似錦矿辽、人聲如沸丹允。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,352評論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽雕蔽。三九已至,卻和暖如春宾娜,著一層夾襖步出監(jiān)牢的瞬間批狐,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 31,584評論 1 261
  • 我被黑心中介騙來泰國打工前塔, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留嚣艇,地道東北人承冰。 一個(gè)月前我還...
    沈念sama閱讀 45,618評論 2 355
  • 正文 我出身青樓,卻偏偏與公主長得像食零,于是被迫代替她去往敵國和親困乒。 傳聞我的和親對象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,916評論 2 344

推薦閱讀更多精彩內(nèi)容