Carthage | 最优秀的Swift第三方库管理工具

Carthage

2018-03-09更新

如果要让你自己的framework支持Carthage的build编译，只需要在工程的对应target的scheme勾上shared选项即可

Manage Schemes

Shared

iOS第三方库管理工具

• CocoaPods

相信CocoaPods对很多经常使用OC开发的人来说已经很熟悉了，它是基于Ruby语言编写的一个管理工具，它的使用我这里不再赘述，详见：https://github.com/CocoaPods/CocoaPods

• Swift Package Manager

Swift Package Manager业内简称为SPM，是苹果官方在Swift3.0时集成在系统里的第三方库管理工具（库），用它可以自动downloading、compiling和linking第三方库，使用起来也十分简洁高效，不过缺点是目前只支持mac OS。
详见：https://swift.org/package-manager

• Carthage

Carthage是一个用Swift语言编写的开源的，专为Swift工程中第三方库的管理而产生的一个工具，使用起来十分简单，下面重点介绍它的用法和注意的地方。
详见：https://github.com/Carthage/Carthage

Carthage

Carthage和CocoaPods对比

• CocoaPods在集成和发布库的过程都有着很繁琐的维护过程；

• CocoaPods在集成时，会基于当前xcodeproj文件生成一个新的xcworkspace文件，完全改变了原有项目的层级结构，使得很不安全；

• CocoaPods所有的库都是集中化管理的，这使得其中一个库不可用时，调试起来会很繁琐。

• Carthage对你的xcodeproj文件做任何操作，也不会强制你使用xcworkspace文件；

• Carthage不会给你做一些比较隐形的操作，让你无法手动控制它的库管理过程，因为它是将编译生成framewrok文件交给你，让你手动加入工程中来使用的；

• Carthage使用动态链接库，所以系统要求最低为iOS8.0。

Carthage和SPM对比

• SPM侧重于将一些Swift代码片段分享给别人使用，而Carthage则侧重于整个完整framework的分享集成，因为framework里也可能包含一些图片等资源，但SPM则不会。

安装

• 使用GitHub上官方提供的release版本的.pkg安装包：https://github.com/Carthage/Carthage/releases（目前2017-12-15最新的是0.27.0）
• 用Homebrew命令行安装：

brew install carthage

如果提示brew: command not found，表示你的电脑还未安装Homebrew，安装方法为终端运行/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

更新

brew update
brew upgrade carthage

或者

brew update
brew uninstall carthage
brew install carthage

集成

• 和CocoaPods类似，Carthage的集成使用也需要一个固定名为Cartfile的无后缀文本文件；
• 在该文件里写很简单的命令，指明需要集成的第三方库路径和版本等信息，如：

github "Alamofire/Alamofire" == 4.5
# 或
github "Alamofire/AlamofireImage" ~> 3.2

• Cartfile

  • Cartfile文件格式是基于OGDL(Ordered Graph Data Language)标准来组织的，这种格式支持3种类型的数据源：github和git、binary；

  • 对于github关键字指明Carthage会自动去github上找相应的库文件，用法为：github Username/ProjectName；

  • 对于git关键字，则表明从指定的git服务器或本地仓库去搜索下载相应的库文件，用法为git "https://xxx.git"；

  • binary关键字只支持framework二进制文件；

  • 关于库文件的版本指定有3种类型：==、>=、~>。

== 毫无疑问是说必须为指定版本，如果没有，就不下载编译；
>= 使用大于或等于指定版本的库，如果有最新，则使用最新的；
~> 则是一个开区间，如“~>1.1.0”则会返回“1.1.1~1.9.9”之间的版本，不包括1.1.0和2.0.0；

编译

Carthage默认是调用XcodeBuilder工具将下载好的project编译成framework的，所以编译前的第一步工作是指定要编译库得Xcode版本：

xcode-select --print-path
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer 

注意：有些第三方库是用Swift4.0编写的，所以你集成时必须用Xcode9+编译，不然会报错。

• 如果上述工作已经准备好了，接下来就简单执行一行代码：

cd `你的Cartfile文件所在目录`
carthage update --platform iOS

注意：如果你不指定--platform iOS的话，默认Carthage会编译成mac OS、tv OS、iOS三个平台的framework，很明显，前两者编译用不着，却占用了编译时间，所以建议加上此命令。

• 如果上述命令无误的话，就会打印出下面的过程：

*** Fetching Alamofire
*** Checking out Alamofire at "4.5.0"
*** xcodebuild output can be found in /var/folders/cn/tknd724s0fv8pbdcbkg2sb6w0000gn/T/carthage-xcodebuild.no8ytB.log
*** Building scheme "Alamofire iOS" in Alamofire.xcworkspace

• 编译完成后，Carthage默认会在当前Cartfile目录下创建一个文件夹Carthage，你打开文件夹，就可以看到如下的文件结构：

Carthage/

• 在iOS文件夹下面，就是编译好的framework库，直接可以拖到工程里用了：

  
  
  

  Carthage/Build/iOS

• 而Checkouts文件夹下，则是刚才下载到本地的库原工程文件，目的是下次再编译时提高效率：

image.png

• 如果你注意到的话，在Cartfile的同级目录，还会生成一个Cartfile.resolved的文件，没错，这个文件就是下次编译时Carthage用来做参考的，如果没有变动，则不会重新执行编译过程，打开该文件，你会发现其实和刚才的Cartfile没有多大区别，只是没有了版本过滤符号“==，>=，~>”等，而是具体的某个版本号：

Cartfile.resolved

也可以用Xcode打开Cartfile.resolved文件：open -a Xcode Cartfile.resolved

注意：如果别人想用你的工程，或在多人协作工作时，只需要将Cartfile.resolved添加到版本控制中，不需要将Carthage文件夹下的任何文件添加，当别人拿到你的工程时，只需要执行命令[carthage bootstrap]就可以编译到特定的库。

• 关于Carthage的其他一些复杂的命令用法，可以参考官网：https://github.com/Carthage/Carthage

链接

• 关于Carthage编译后的库使用起来十分简单，可以手动将Carthage/Build目录下的framework文件拖到项目中：

手动嵌入framework

• 也可以用脚本自动在每次编译的时候，将framework拷贝到工程中：
  

  

  动态拷贝framework
  
  注意：在写framework拷贝路径时一定要写正确，默认是工程根目录/Carthage/Build/iOS/； 还有需要注意的是，在AppStore上传时，这个脚本会被审核报错，所以不推荐使用这种方式； 另外在Xcode9+中，会出现实时编译的问题，导致系统CPU飞转，严重耗能，慎用。

• 至此，用Carthage集成第三方库就算完成了，在代码中使用也很简单，然后Command+R运行工程，如果不报错，那么恭喜你已经成功了。

import Alamofire

相关链接

• Carthage
• Ruthlessly Simple Dependency Management
• Swift Package Manager
• How To Use CocoaPods With Swift

如果对你有帮助，别忘了给个哦，有问题欢迎在下面留言讨论。