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命令。

bootstrap命令会根据Cartfile.resolved文件下载和编译依赖库的精确版本。另一方面，carthage update命令会更新项目中的第三方库的最新的编译版本，这是不可取的。

在"Carthage/Build/iOS"文件夹中会生成.framework文件。

注意, 如果遇到如下问题，解决方法如下：

*** 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

参考

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