Carthage 包管理工具

谁践踏了优雅 2022-07-16 10:11 255阅读 0赞

说起 iOS 开发的包管理，大家就不由得会想起 CocoaPods, 它确实是一个强大的工具。但这次咱们来关注另外一个包管理工具 Carthage，如果说 CocoaPods 像一个航母，一应俱全，坚实稳固。那么 Carthage 就像一艘巡洋舰，机动灵活，攻击迅速。

## Carthage 和 CoaoaPods 的区别 ##

CoaoaPods 是一套整体解决方案，我们在 `Podfile`中指定好我们需要的第三方库。然后 CocoaPods 就会进行下载，集成，然后修改或者创建我们项目的 `workspace`文件，这一系列整体操作

相比之下，`Carthage`就要轻量很多，它也会一个叫做 `Cartfile`描述文件，但 `Carthage`不会对我们的项目结构进行任何修改，更不多创建 `workspace`。它只是根据我们描述文件中配置的第三方库，将他们下载到本地，然后使用 `xcodebuild`构建成 `framework文件`。然后由我们自己将这些库集成到项目中。`Carthage`使用的是一种**非侵入性**的哲学。

所谓**非侵入性**哲学，其实可以这么理解。我想使用过 CocoaPods  
的同学们，可能都会经历过这样一种体验，尤其是在最开始使用它的时候 - 我们精心在 Podfile中配置好我们所需的第三方库，并且按照 CocoaPods的指定步骤，输入命令，然后等待这些第三方库乖乖的集成到项目中。但总有那么几次，会事与愿违，比如运行完pod update命令，看似一切顺利，workspace也成功的更新了。但当我们真正编译构建项目的时候，某些莫名其妙的错误出现了，类似于这种：

diff: /../Podfile.lock: No such file or directory
 diff: /Manifest.lock: No such file or directory

遇到这种问题后，我们只能经过一系列的搜索，然后解决这些问题。本来我们使用包管理，就是为了集成第三方库的时候更加方便，迅速。结果处理这些包管理的错误却又浪费了我们很多时间。

如果使用 `Carthage`我们就不必让这些问题困扰了，因为 `Carthage`本身不会对我们的项目结构进行任何改动，类似 `CocoaPods`产生的这些附加问题，就不会发生了。

但是 `Carthage` 就没有 `CocoaPods` 的集成操作能力了，作为开发者，必须在 `Carthage` 将第三方库构建完成后，手动的关联到项目中。

另外 `Carthage` 除了**非侵入性**，它还是**去中心化**的，它的包管理不像 `CocoaPods` 那样，有一个中心服务器(<a href="http://cocoapods.org" target="\_blank" rel="external">cocoapods.org</a>)，来管理各个包的元信息，而是依赖于每个第三方库自己的源地址，比如 `Github`。这样也是有利有弊，好处就是我们对包管理不再依赖中心服务器，不会受中心服务器信息量和稳定性的限制(尤其是在我们这里的网络访问状况问题)，弊端嘛，就是我们想查找第三方库的时候，也没有一个中心服务器来帮助我们进行索引，而是必须从网络上自行查找。

两种哲学，产生了两个产品 `Carthage` 和 `CocoaPods` 各有优劣，如何选择，就要看各位自己的需求了。

### 开始使用 Carthage ###

`Carthage` 的基本情况介绍完了，接下来咱就来看一下怎样使用 `Carthage` 来进行包管理吧。

首先我们需要安装 `Carthage` 环境，可以在它的 **Github** 主页上，找到下载地址：[https://github.com/Carthage/Carthage/releases][https_github.com_Carthage_Carthage_releases]:

**Carthage** 目前最新版本是 1.2.0，下载 Carthage.pkg 包就可以，下载成功后，双击安装。

安装成功后，我们就可以在项目中配置  Cartfile 文件了，可以在我们项目的根目录中，使用任何一个你熟悉的文件编辑器，建立这个文件：

$ vim Cartfile

在 Cartfile 文件中，引入一个第三方库，比如 SwiftyJSON ：

github "SwiftyJSON/SwiftyJSON"

然后我们保存文件，回到命令行界面，再次输入命令:

$ carthage update

紧接着，Carthage 就会开始抓取并使用 **xcodebuild** 构建第三方库:

*** Cloning SwiftyJSON
 *** Checking out SwiftyJSON at "2.3.0"*** xcodebuild output can be found in /var/folders/08/sys7159s6zjfd52t3p35qrbc0000gq/T/carthage-xcodebuild.yqDOKU.log
 *** Building scheme "SwiftyJSON OSX" in SwiftyJSON.xcworkspace
 *** Building scheme "SwiftyJSON iOS" in SwiftyJSON.xcworkspace
 *** Building scheme "SwiftyJSON watchOS" in SwiftyJSON.xcworkspace

update 操作完成后，会在项目的根目录中生成一个 **Carthage** 目录。这个目录中又包含了两个目录 **Build** 和 **Checkout**。

**Build** 中存放的是构建好的 **framework** 包：

![SouthEast][]

**Checkouts** 中存放的是签出的第三方库项目源文件：

![SouthEast 1][]

接下来，我们回到项目设置，进入  **General** 选项卡，在最下方的 **Linked Frameworks and Libraries** 中，将  **Carthage/Build/iOS** 中的 **framework** 文件添加到项目中：

![SouthEast 2][]

然后在 **Build Phrases** 中，点击左上角的 + 号，添加一个 **New Run Script Phrase**:

![SouthEast 3][]

然后在脚本区域输入：

/usr/local/bin/carthage copy-frameworks

最后将 **SwiftyJSON** 的路径添加到 Input Files 中。

$(SRCROOT)/Carthage/Build/iOS/SwiftyJSON.framework

最终结果如下：

![SouthEast 4][]

添加这个 **Run Script** 的作用是为了让运行时能够找到这个动态库。这点 **Carthage** 官方文档中没有太明确的说明。我实际的实验过，如果不添加这个 copy-frameworks  
脚本，那么项目在运行的时候会因为找不到这个动态库而在启动的时候崩溃。

还可以将 Carthage所集成的第三方库生成的符号文件添加到项目中，这样我们在调试的时候，就可以步入第三方库内部的代码啦。

具体步骤，还是进入 **Build Phrases** ，然后在右上角点击 **New Copy Files Phrase**，然后将**Carthage/Build/iOS** 目录中的 **SwiftyJSON.framework.dSYM** 符号文件拖动进来：

![SouthEast 5][]

这样，我们项目运行后，就可以在断点中步入 **SwiftyJSON** 内部的代码啦。

关于这个符号文件，还有一点大家要注意的，如果你使用的是 Xcode 7 以上的版本，有可能在加入了符号文件后，造成编译出错。那么可能是因为一个构建选项引起的。

这时，可以在 **Build Settings** 中，找到  **Strip Debug Symbol During Copy** 这个选项，确保这个选项的值设置为**NO**。

![SouthEast 6][]

然后再重新编译，一般就可以正常通过了。这个编译选项是指定在 Copy 符号文件的时候是否对符号表进行处理，在新版的 Xcode 上这个选项默认是 **YES** 的，所以咱们需要把它设置为 **NO**。这个问题也是官方文档中没有提到的，我在调试的时候，遇到过这个问题，经过一番搜索才找到原因，困扰了我好半天~

好啦，经过一番折腾，我们通过 **Carthage** 将  **SwiftyJSON** 库顺利的集成到项目中啦。

水平有限，这里也只是对 Carthage进行了初步的介绍。希望借助这个文章，与大家进行一个交流分享，希望能够作为抛砖引玉，相信屏幕前的你有着更多的聪明才智，也欢迎大家一起讨论自己更深入研究的经验。

Carthage在 **GitHub** 上的主页：[https://github.com/Carthage/Carthage][https_github.com_Carthage_Carthage]

[https_github.com_Carthage_Carthage_releases]: https://github.com/Carthage/Carthage/releases
[SouthEast]: /images/20220716/7b4d199a3fdf4b45882cee8d84ec64d1.png
[SouthEast 1]: /images/20220716/eb1fc67d93374a169f8bb2f672a92143.png
[SouthEast 2]: /images/20220716/7e95746686ba44ae8b089e48b5edf83b.png
[SouthEast 3]: /images/20220716/81f0ab5268bf4c54a3cace0de2e07bb1.png
[SouthEast 4]: /images/20220716/c04f3d03977648b0b423c1dc737ddcca.png
[SouthEast 5]: /images/20220716/091faac2cd5b4a4c9ba87c5cdb4c35d8.png
[SouthEast 6]: /images/20220716/942fb349f44a402da807ccb4fe5a1a50.png
[https_github.com_Carthage_Carthage]: https://github.com/Carthage/Carthage