说到 iOS 的依赖管理工具，大家一定首先想到的是CocoaPods，不错，CocoaPods 确实是一个很好依赖管理工具，已然成为了 Cocoa 依赖管理的标准，丰富的支持库、文档等等，CocoaPods 相关的文章有很多，这里就不一一赘述了。

今天要介绍的是一款新的依赖管理工具，名曰 “Carthage”，名字有点难理解，简单方便，完全独立，不修改 XCode 项目文件或配置。

简介

我之前很少用 CocoaPods，很大一部分原因就是因为麻烦，仅个人感觉，需要牵扯 XCode 项目文件；而 Carthage 就很好的解决了我之前的烦恼，轻耦合，更灵活；使用xcodebuild工具来编译依赖项目成二进制 Framework，再引入到项目中去。

Carthage 是由 Swift 语言写的，只支持动态框架，只支持 iOS8+。

Carthage 的大致工作流程如下：

  1. 创建一个Cartfile文件，写好你要哪些依赖库
  2. 执行carthage update命令拉取源代码并编译为 Framework
  3. 把编译后的.framework拖到项目中去即可 （官方是这么说的，不过更好的办法是把 Carthage 编译的 Framework 路径加入到 Build Setting 中的 Framework Search Path，详情见后文）

执行update命令后，你的项目目录结构大致如下：

Cartfile
Cartfile.resolved
Carthage
    - Build
        - iOS
            - Alamofire.framework
        - Mac
            - Alamofire.framework
    - Checkouts
        - Alamofire
        - ...
xxx.xcodeproj
...
  • Cartfile文件用来标注你需要哪些依赖库，对应版本或者 Git 分支 (需要提交到 Git)
  • Cartfile.resolved文件用来跟踪项目当前所用的依赖版本号，为了保持多端开发一致 (需要提交到 Git)
  • Carthage文件夹用来存放依赖库的源文件和编译后的文件 (不需要提交到 Git)

其实工作方式有点和 Cocoapods 大致相似，只不过 Cartfile 多了一个自动编译过程且与 Project 耦合更低，Cartfile 利用 xcode-select 命令来编译 Framework，如果你想用测试版的 Xcode 进行编译，执行下面这条命令，把 xcode-select 的路径改为另一版本 Xcode 就可以了

sudo xcode-select -s /Applications/Xcode-beta.app/Contents/Developer

其中Xcode-beta.app就是对应你的 Xcode 版本，你也可以改成其他版本的 Xcode

注：写完才发现，原来 Xcode -> Preferences -> Locations 中已经有切换 Command Line Tools 版本的选项...

安装

推荐使用Homebrew进行安装，简单方便，也便于维护：

brew install carthage

安装前最好先 update 一下，之前我就是因为没有 update，结果安装了老版本的 Carthage

brew update

使用

添加 Cartfile 文件

类似于 CocoaPods 中的Podfile文件，把需要的包写进去就行了，具体可参阅官方说明，如：

# 必须最低 2.3.1 版本
github "ReactiveCocoa/ReactiveCocoa" >= 2.3.1

# 必须 1.x 版本
github "Mantle/Mantle" ~> 1.0    # (大于或等于 1.0 ，小于 2.0)

# 必须 0.4.1 版本
github "jspahrsummers/libextobjc" == 0.4.1

# 使用最新的版本
github "jspahrsummers/xcconfigs"

# 使用一个私有项目，在 "development" 分支
git "https://enterprise.local/desktop/git-error-translations.git" "development"

暂只支持 GitHub 和 git 源，在执行carthage update命令后会在根目录创建一个Cartfile.resolved文件，这个文件是生成后的依赖关系，不能修改。

引入 Framework

在项目中引入依赖的 Framkework，只需要在对应 Target 中的 Build Setting 中的 Framework Search Path 项加入以下路径，Xcode 便会自动搜索目录下的 Framework：

$(SRCROOT)/Carthage/Build/iOS

如果是 OSX 项目则把末尾的 iOS 改为 Mac

在 Git 中忽略

如果不想把 Carthage 的依赖库 push 到 Git 仓库里，则修改 .gitignore 文件，增加忽略 Carthage 文件夹就行了：

#Carthage
Carthage

可用命令

archive: Archives a built framework into a zip that Carthage can use
bootstrap: Check out and build the project's dependencies
build: Build the project's dependencies
checkout: Check out the project's dependencies
copy-frameworks: In a Run Script build phase,copies each framework specified by a SCRIPT_INPUT_FILE environment variable into the built app bundle
fetch: Clones or fetches a Git repository ahead of time
help: Display general or command-specific help
update: Update and rebuild the project's dependencies
version: Display the current version of Carthage