Carthage的安裝和使用

Carthage和CocoaPods相比，輕量級一些，在swift中使用很方便，它本身就是swift寫的。

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 // 目前的版本號爲0.15.2

3. 使用Carthage

進入項目所在文件夾

cd ~/路徑/項目文件夾

創建一個空的carthage文件

touch Cartfile

此時項目文件夾中會有一個名字爲Carthage的文件

使用Xcode打開該文件

open -a Xcode Cartfile

編輯Cartfile

github "SVProgressHUD/SVProgressHUD" ~> 1.0

Cartfile格式說明

依賴源 Dependency origin

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

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

依賴版本號 Dependency Version

告訴Carthage使用哪個版本，這是可選的，不寫默認使用最新版本

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名稱，意思是使用特定的分支/標籤/提交，比如可以是分支名master，也可以是提交5c8a74a。

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多次。

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

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

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

多人協作時，往往用到的.framework庫不會上傳，在check out工程後，可以通過執行$ carthage bootstrap命令，來根據 Cartfile.resolved文件下載和編譯依賴庫的精確版本。而不應該用 carthage update命令，這會更新項目中的第三方庫的最新的編譯版本，改變Cartfile.resolved文件，可能造成衝突。

建議使用：carthage bootstrap --platform iOS --no-use-binaries  //（或者 carthage bootstrap --platform iOS 這個命令有時候會有問題 ，建議加上 --no-use-binaries）

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"，在最底部找到"Linked Frameworks and Libraries"。

打開Carthage文件夾，進入Build\iOS，拖拽SVProgressHUD.framework到Xcode的**Linked Frameworks and Libraries **中。

目的是告訴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命令剔除了額外的框架。

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

import SVProgressHUD

升級指定Frameworks

carthage update SVProgressHUD --platform iOS

作者：牧曉逸風
鏈接：https://www.jianshu.com/p/a734be794019
來源：簡書
簡書著作權歸作者所有，任何形式的轉載都請聯繫作者獲得授權並註明出處。