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

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

Carthage和CocoaPods相比，輕量級(jí)一些，在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 // 目前的版本號(hào)為0.25.0

3. 使用Carthage

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

此時(shí)項(xiàng)目文件夾中會(huì)有一個(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://，或者是本地資料庫地址。
依賴版本號(hào) 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會(huì)clone文件中對(duì)應(yīng)的git第三方庫，把每一個(gè)第三方庫編譯成二進(jìn)制文件的framework文件。

其中--platform iOS命令是可選的，作用是保證只為iOS編譯framework，如果不指定平臺(tái)，會(huì)為全平臺(tái)編譯framework文件。如果想要了解更多的命令，可以運(yùn)行carthage help update查看。

當(dāng)命令執(zhí)行完畢，在Cartfile文件同級(jí)別的文件夾中生成一個(gè)名為“Carthage”文件夾和“Cartfile.resolved”文件。打開Carthage文件夾，可以看到兩個(gè)文件夾Build和Checkouts。

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

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

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

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

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

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

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

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

注意, 如果遇到如下問題，解決方法如下：

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

這個(gè)錯(cuò)誤的原因是carthage通過git向 Github API 發(fā)送請(qǐng)求時(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上一份代碼下來，這個(gè)過程你有可能被提示輸入GitHub的用戶名和密碼來授權(quán)訪問OSX keychain，此時(shí)，你的用戶名和密碼就會(huì)被保存在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下面的+號(hào)為每一個(gè)framework添加條目。

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

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

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

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

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

import SVProgressHUD
升級(jí)指定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)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡書系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容