Carthage是什么？
Carthage 使用于 Swift 语言编写，只支持动态框架，只支持 iOS8+的Cocoa依赖管理工具。
与现在流行的 CocoaPods 不同，Carthage编译你的依赖，并提供框架的二进制.framework文件，但你仍然保留对项目的结构和设置的完整控制，Carthage不会自动的修改你的项目文件或编译设置。是一个去中心化的Cocoa依赖管理工具
如何下载和安装Carthage？
使用Brew安装(建议)
- 安装Mac OSX流行的的软件包管理工具Homebrew之前要检查Mac中是否有Ruby环境,目前的版本基本都内置了Ruby,终端输入
ruby -v
显示类似 ruby 2.0.0p648 (2015-12-16 revision 53162) [universal.x86_64-darwin15]
brew -v
显示类似文本 Homebrew 0.9.9 (git revision 2f20; last commit 2016-05-15) 说明已经安装brew不需要再次安装
- 如果电脑中没有Homebrew,终端执行脚本安装即可
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
- 每次使用 Homebrew 进行安装Carthage 或者其他软件之前,习惯性的先对Homebrew进行更新一下, 不然可能会安装到比较老版本的Carthage等软件
brew update
提示 Already up-to-date....... 更新到最新啦!!
- 假如你在本地已经安装好Homebrew环境，那么下载和安装carthage将十分简单，只需要一行命令。
brew install carthage
PKG文件安装
直接下载pkg文件：https://github.com/Carthage/Carthage/releases 进行安装即可
如何使用Carthage？
包管理工具,不管是CocoaPods,还是Node 的NPM,配置依赖管理都是在工程目录,建立相应的配置文件,Carthage的配置文件即 Cartfile文件
添加 Cartfile 文件 (需要提交到 Git)
建立添加Cartfile（配置文件）文件在
通过终端或者文本编辑器 进入到项目所在的文件夹建立一个 空的Cartfile文件
现在只支持GitHub库(GitHub.com和GitHub企业),指定GitHub的关键字:
github "ReactiveCocoa/ReactiveCocoa" # GitHub.com
github "https://enterprise.local/ghe/desktop/git-error-translations" # GitHub Enterprise
或者是其他git源,指定git关键词:
git "https://enterprise.local/desktop/git-error-translations2.git"
其他可能的源在未来也会会被添加
版本指定
Carthage 支持以下几种版本指定方法:
-
>= 1.0代表 “最低 1.0版本” -
~> 1.0代表 “表示使用版本1.0以上但是低于2.0的最新版本，如1.5, 1.9” -
== 1.0代表 “必须是 1.0 版本” -
"some-branch-or-tag-or-commit"指定一个 Git 对象 (任何被git rev-parse允许的)
如果没有版本要求,任何版本的依赖是允许的。
版本好的兼容性是根据语语义化版本控制决定的。这意味着任何大于或等于1.5.1版本,但小于2.0,将认为与1.5.1“兼容”。
Cartfile示例
# Require version 2.3.1 or later 最低2.3.1版本
github "ReactiveCocoa/ReactiveCocoa" >= 2.3.1
# Require version 1.x 必须1.x版本
github "Mantle/Mantle" ~> 1.0 # (大于或等于 1.0 ，小于 2.0)
# Require exactly version 0.4.1 必须0.4.1版本
github "jspahrsummers/libextobjc" == 0.4.1
# Use the latest version 使用最新版本
github "jspahrsummers/xcconfigs"
# Use the branch 使用git分支
github "jspahrsummers/xcconfigs" "branch"
# Use a project from GitHub Enterprise 使用一个企业项目，在 "development" 分支
github "https://enterprise.local/ghe/desktop/git-error-translations"
# Use a project from any arbitrary server, on the "development" branch 使用一个私有项目，在 "development" 分支
git "https://enterprise.local/desktop/git-error-translations2.git" "development"
# Use a local project 使用一个本地的项目
git "file:///directory/to/project" "branch"
安装依赖 just do it
执行以下命令 拉取指定版本代码并编译为 .Framework 文件
内部工作流程即 carthage update => carthage checkout => checkout build
carthage update
只编译iOS平台的类库
carthage update --platform iOS
结果如下,(PS我只留了一个Mantle依赖)
Jakey-Pro:test jakey$ carthage update
*** Fetching Mantle
*** Checking out Mantle at "1.5.7"
*** xcodebuild output can be found in /var/folders/sm/b5fssgjx147b722vsgx20mg00000gn/T/carthage-xcodebuild.b3IHTG.log
*** Building scheme "Mantle Mac" in Mantle.xcworkspace
...balabala
工程目录多了以下文件
Cartfile.resolved (需要提交到 Git)
在执行 carthage update 命令后会在根目录创建一个 Cartfile.resolved 文件，这个文件是生成后的依赖关系，不能修改。
Cartfile.resolved 文件确保提交的项目可以使用完全相同的配置与方式运行启用。 跟踪项目当前所用的依赖版本号，保持多端开发一致,出于这个原因,强烈建议提交这个文件到版本控制中。
自动生成的Carthage目录 (不需要提交到 Git)
Carthage文件夹用来存放:
carthage checkout 从git拉取的依赖库源文件(Checkouts)
carthage build编译后的文件(Build),包含Mac 与 iOS对应的.framework
引入 .Framework 动态库的方法
1 . 手动拖拽Build中的所有依赖.framework到你的工程,本人的建议当然是在工程根目录建立"Vendor"类似文件夹,创建"Vendor" folder/group到工程,所有第三方 .Framework都拷贝到此目录下,然后继续以下操作
- 打开项目，点击project，选择target, 再选择上方的General，将需要的framework文件拖到 Embedded Binaries(动态库)内
注意:动态库拷贝到Embedded Binarie会同时自动加入到Linked Frameworks and Libraries,但是错误的拖入到Linked Frameworks and Libraries是不会自动增加到Embedded Binarie中的,会导致动态库加载失败
2 . 在对应 Target 中的 Build Setting 中的 Framework Search Path 项加入以下路径，Xcode 便会自动搜索目录下的 Framework：
$(PROJECT_DIR)/Carthage/Build/iOS
Git 中忽略不需要提交到版本库的文件与文件夹
则修改 .gitignore 文件，增加忽略 Carthage 文件夹就行了：
#Carthage
Carthage
总结
本人在实际项目中迟迟没有使用CocoaPods的原因就是,啰里啰嗦...对原有工程破坏性大(建立workspace,增加一堆乱七八糟的文件),侵入性太强,耦合太高,Carthage的出现的确是茉莉花香扑鼻而至!
