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.
錯誤,就執(zhí)行以下命令sudo chown -R $(whoami):admin /usr/local
,再更新胯甩。
其他 brew命令
brew install git // 使用brew安裝軟件
brew uninstall wget // 使用brew卸載軟件
brew search /wge*/ // 使用brew查詢軟件啃沪,其中/wge*/是個正則表達(dá)式粘拾,需要包含在/中
brew list // 列出已安裝的軟件
brew home // 用瀏覽器打開brew的官方網(wǎng)站
brew info // 顯示軟件信息
brew deps // 顯示包依賴
2.安裝 Carthage
安裝brew之后,就可以安裝Carthage了创千。
brew install carthage
安裝Carthage之后缰雇,查看版本
carthage version
3.使用 Carthage
進(jìn)入項(xiàng)目所在文件夾
cd ~/Path/Project // 進(jìn)入項(xiàng)目所在文件夾
創(chuàng)建一個空的carthage文件
touch Cartfile // 此時(shí)你的項(xiàng)目文件夾里會創(chuàng)建一個名為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 關(guān)鍵字后面跟的是資料庫的地址爸业,可以是遠(yuǎn)程的URL地址,使用git://, http://, ssh://河泳,或者是本地資料庫地址沃呢。
4. 運(yùn)行 Carthage
保存并關(guān)閉Cartfile文件,回到終端拆挥,執(zhí)行以下命令:
carthage update --platform iOS
carthage會clone文件中對應(yīng)的git第三方庫薄霜,把每一個第三方庫編譯成二進(jìn)制文件的framework文件。
其中--platform iOS
命令是可選的纸兔,作用是保證只為iOS編譯framework惰瓜,如果不指定平臺,會為全平臺編譯framework文件汉矿。如果想要了解更多的命令崎坊,可以運(yùn)行carthage help update
查看。
當(dāng)命令執(zhí)行完畢洲拇,在Cartfile
文件同級別的文件夾中生成一個名為“Carthage”文件夾和“Cartfile.resolved”文件奈揍。打開Carthage
文件夾曲尸,可以看到兩個文件夾Build和Checkouts。
Cartfile.resolved:這個文件是輔助Cartfile
的男翰,需要被提交到版本庫中另患,它有助于其他開發(fā)者使用和你相同版本的第三方庫。
Build:包含每一個第三方庫創(chuàng)建生成的framework蛾绎,可以被集成到項(xiàng)目中昆箕,每一個framework都是依賴于源文件或者GitHub上的Releases
版本。
Checkouts:這里包含的是轉(zhuǎn)換成framework之前的源文件租冠,Carthage有自己的緩存機(jī)制鹏倘,所以不需要在不同的項(xiàng)目中對同一個的第三方庫clone多次。
對于是否把Build
和Checkouts
文件夾提交到版本庫取決于你顽爹,這不是必須的纤泵。如果提交的話,其他人clone了你的資料庫就可以使用這兩個文件中的內(nèi)容话原。
不要改變Checkouts
文件夾中的內(nèi)容夕吻,因?yàn)槿绻褂?code>carthage update 或者 carthage checkout
命令的話,這個文件夾中的內(nèi)容可以隨時(shí)被復(fù)寫繁仁,那么改動工作就白費(fèi)了涉馅。如果一定要改動的話,在使用carthage update
命令時(shí)黄虱,可以使用--use-submodules
選項(xiàng)稚矿。如果加上這個選項(xiàng)的話,Carthage在添加每個依賴庫的時(shí)候就會作為一個字模塊捻浦。
如果其他人想要使用你的工程晤揣,你不需要在你的代碼中提交已經(jīng)編譯好的framework,他們需要在check out你的工程之后執(zhí)行carthage bootstrap
命令朱灿。
bootstrap
命令會根據(jù)Cartfile.resolved
文件下載和編譯依賴庫的精確版本昧识。另一方面,carthage update
命令會更新項(xiàng)目中的第三方庫的最新的編譯版本盗扒,這是不可取的跪楞。
在"Carthage/Build/iOS"文件夾中會生成.framework
文件。
注意, 如果遇到如下問題侣灶,解決方法如下:
*** Skipped downloading Alamofire.framework binary due to the error: "Bad credentials"
這個錯誤的原因是carthage通過git
向 Github API 發(fā)送請求時(shí)甸祭,要先取得GitHub憑證
。
解決辦法一
打開命令行工具terminal
1.檢查git
和osxkeychain 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
上一份代碼下來赊抖,這個過程你有可能被提示輸入GitHub的用戶名和密碼來授權(quán)訪問OSX keychain
,此時(shí)寨典,你的用戶名和密碼就會被保存在keychain
中了熏迹。# 可以進(jìn)入系統(tǒng)桌面,創(chuàng)建一個臨時(shí)文件夾凝赛,用來clone代碼,之后再刪除即可$ cd$ cd Desktop$ mkdir tempdir$ cd tempdir$ git clone https://github.com/SVProgressHUD/SVProgressHUD.git
5.再次進(jìn)入項(xiàng)目所在目錄坛缕,執(zhí)行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到項(xiàng)目中
點(diǎn)擊項(xiàng)目名稱-> target -> Gerneral -> Builf Phases
毙沾,找到Linked Frameworks and Libraries
。
再點(diǎn)擊+ -> Add Other... -> Build/iOS SVProgressHUD.framework
目的是告訴Xcode鏈接你的app到這個framework宠页,允許你在代碼中使用左胞。
下一步選擇菜單上的Build Phases
,并添加一個新的Run Script
举户,并添加以下命令:
/usr/local/bin/carthage copy-frameworks
點(diǎn)擊Input Files下面的+號為每一個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
命令剔除了額外的框架供填。
command + B
編譯項(xiàng)目拐云,比已成功之后就可以使用了。
import SVProgressHUD
升級指定Frameworks
carthage update SVProgressHUD --platform iOS