Carthage的安装和使用

为什么要使用Carthage

CocoaPods是已存在很长时间的Cocoa依赖管理器, 那么为什么要创建Carthage呢?

1. CoaoaPods是一套整体解决方案，我们在Podfile中指定好我们需要的第三方库。然后CocoaPods就会进行下载，集成，然后修改或者创建我们项目的workspace文件，这一系列整体操作。
2. 相比之下，Carthage就要轻量很多，它也会有一个叫做Cartfile描述文件，但Carthage不会对我们的项目结构进行任何修改，更不多创建 workspace。它只是根据我们描述文件中配置的第三方库，将他们下载到本地，然后用xcodebuild构建成framework文件。然后由我们自己将这些库集成到项目中。

Carthage和Cocoapods比较

Cocoapods有如下优点：

① 使用方便，除编写Podfile以外，其他几乎都是自动完成；

② 软件包数量多，主流支持；

③ 支持 iOS 8 Framework，当然也支持旧的静态编译；

但是 CocoaPods 作为一个有中心仓库的解决方案，缺点也比较明显：

① 每次更新环境都需要连接到中心仓库，比较耗时；

② 开发者使用比较简单，但是如果创建兼容 CocoaPods 的库，就会相对繁琐一些（尽管有了命令行）；

③ 每次干净编译都会把所有第三方库都重新编译一次；

Carthage的优点：

① 使用Carthage的话，所有的第三方库依赖，除非是更新的需要，不然平常干净编译Project，它是不需要再次编译的，大大加快平常编译及Archive 的时间；

② 它是去中心化的，没有中心服务器. 这意味着每次配置和更新环境，只会去更新具体的库，而不会有一个向中心服务器获取最新库的索引这么个过程，如此又省了很多时间；

③ CocoaPods无缝集成！一个项目可同时使用两套包管理工具, 当前 CocoaPods管理主要Framework的配置下, 将少量其他Framework交给了Carthage管理, 二者可以和谐地共存;

Carthage的不足：

① 库不如CocoaPods丰富：尽管很多库不需要声明并改造就直接可以被 Carthage用，但依然有大量CocoaPods能用的库不支持；

② 只支持Framework，所以是 iOS 8 Only了，随着时间推移，这个也不会是问题；

③ 无法在Xcode里定位到源码：如果你在写代码过程中，想跳转到一个第三方库去看具体的实现，这是无法办到的，Carthage的配置只能让你看到一个库的头文件

Carthage的安装

1. 安装brew
   
   安装Carthage之前，需要安装brew，进入官网有详细安装步骤。

   • 获取Homebrew

     打开终端，输入以下命令：

     /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 version
   

Carthage的使用

• 进入项目所在文件夹

cd ~/路径/项目文件夹

• 创建一个空的Cartfile文件

touch Cartfile

• 使用Xcode打开该文件

open -a Xcode Cartfile

• 编辑Cartfile（ps:本篇以导入RxSwift3.0为例子）

github "ReactiveX/RxSwift" ~> 3.0

• Cartfile格式说明

  • 依赖源Dependency origin

    Carthage支持两种类型的源，一个是github，另一个是git。

    github表示依赖源，告诉Carthage去哪里下载文件。依赖源之后
    
    跟上要下载的库，格式为Username/ProjectName``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.1，1.7

• 运行Carthage

  保存并关闭Carfile文件，回到终端，执行以下命令:

  carthage update
  

  当命令执行完毕，在Cartfile文件同级别的文件夹中生成一个名为
  
  Carthage文件夹和Cartfile.resolved文件。打开Carthage
  
  文件夹，可以看到一个文件夹Build。

  

  注意：此处如果失败，可以查找相关解决办法。

• 添加Frameworks到项目中

  点击项目名称->target->General,在最底部找到Linked Frameworks and Libraries。将上一步运行完之后的framework添加进来。
  
  

  目的是告诉Xcode链接这个framework到项目中，允许你在代码中使用。

  下一步选择菜单上的Build Phases，并添加一个新的Run Script，并添加以下命令：

/usr/local/bin/carthage copy-frameworks

点击Input Files下面的 + 号为每一个framework添加条目。

$(SRCROOT)/Carthage/Build/iOS/RxSwift.framework
$(SRCROOT)/Carthage/Build/iOS/RxBlocking.framework
$(SRCROOT)/Carthage/Build/iOS/RxCocoa.framework
$(SRCROOT)/Carthage/Build/iOS/RxTest.framework

严格来讲，build phase对项目运行来说不是必须的，但是，这巧妙的解决了APP因为使用的frameworks包含二进制图像的iOS模拟器在提交APP Store时会被自动拒绝的问题。

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

command + B编译项目，编译成功之后就可以愉快地使用了。

import RxSwift
import RxCocoa

致谢

如果发现有错误的地方，欢迎评论，谢谢！

参考链接：Carthage