Carthage的用法及注意事项

Carthage与CocoaPods类似,都是用于在iOS/OS X环境下管理第三方的工具。平时用CocoaPods用的比较多,近期用到Carthage发现也挺有意思,在此记录下。

Carthage不会像CocoaPods那样创建一个workspace。而是直接提供了一种去中心化的依赖管理系统,不提供中心化的项目列表,使用者可以自行添加类库,对项目的侵入性也较少。可以理解为只帮你下载和更新第三方依赖,怎么用看你自己。

安装Carthage:
推荐使用HomeBrew进行安装(没用过的自行百度,傻瓜式)
$ brew install carthage

使用Carthage
1.先进入到项目所在文件夹
$ cd 项目路径

  1. 创建一个空的Carthage文件
    $ touch Cartfile

3.编辑cartfile文件,添加依赖框架
github "Alamofire/AlamofireImage"
github "https://github.com/AFNetworking/AFNetworking"
git "xxx"

4.保存并关闭cartfile文件,进行安装
$ carthage update --no-use-binaries --platform ios

Carthage的用法及注意事项_第1张图片
1011536118484_.pic_hd.jpg

安装完之后根目录会出现一个叫Carthage的文件夹,里面包含Build和Checkouts两个文件夹。

Build中/iOS路径下的就是framework包,需要自行引用进来。

Checkouts是从Github上获取来的源码,所以理论上来说你在这个文件夹里对源码进行任何的修改,再次执行 carthage build 就会根据这里的源码打包出相应的framework出来。

但需要注意的是当每次执行carthage update后这里的源码又被覆盖了。所以你有特别需要修改的地方可以加例外防止覆盖!!!! 重要

5.项目Target -> Build Setting -> Search Paths -> Framework Search Paths添加
$(PROJECT_DIR)/Carthage/Build/iOS

6.项目Target -> Build Phases -> '+' -> New Run Script Phase,
添加脚本 /usr/local/bin/Carthage copy-frameworks
添加"Input Files" $(SRCROOT)/Carthage/Build/iOS/AFNetworking.framework
(这一步一般来说都是需要做的,但有些框架会明确指出不需要加这句脚本,就不用加了)

Carthage的用法及注意事项_第2张图片
image.png

7.项目Target -> General最底下的Linked Frameworks and Libraries里手动添加需要用的framework.

8.在需要使用的地方import "xxx"


Carthage的用法及注意事项_第3张图片
image.png

以上是具体的用法,下面介绍使用过程中可能会遇到的坑。

  1. 在执行Carthage update后,控制台可能会打印这样的错误。
    unable to find utility 'xcodebuild, not a developer tool or in PATH'
    Carthage的用法及注意事项_第4张图片
    image.png

原因是当git源码被checkout后,carthage会进行build。此时若是执行xcodebuild发生错误多半是因为在xcode中没有设置相应的编译工具选项。需要进到xcode的Preference中去设置Command Line Tools.


Carthage的用法及注意事项_第5张图片
1001536113669_.pic_hd.jpg

2.最新版本0.30.1在使用facebooksdk过程中会失败。在carthage的github issue中也被提出来了。
https://github.com/Carthage/Carthage/pull/2507
原因出在FBSDKIntegrationTests这个Target中。
解决方法两个:
1.降级使用0.29版本的Carthage。
2.在Checkouts中对facebooksdk中的FBSDKIntegrationTests进行忽略,上面的链接里有具体操作步骤。

3.网络问题,有时候会遇到checkout执行了很长时间(超过30分钟)。基本上可以判定出现了网络问题,命令行中一般会出现time out或是以下图片之类的提示。


Carthage的用法及注意事项_第6张图片
image.png

这个很好解决,删掉根目录下的Carthage文件,重新执行 Carthage update。

4.单独更新某一个框架
例如我新加了这两个框架,只需要更新它们,其他不需要更新。
github "Alamofire/Alamofire" github "ReactiveX/RxSwift"
则可以只执行这句
carthage update Alamofire
或者指定更新多个框架,空格隔开即可。
carthage update Alamofire RxSwift
当执行完后在命令行log中会发现依旧去fetch其他框架,不用担心,并不会重新CheckOut。只会CheckOut和build指定的依赖。

19年2月28日更新:
项目中有使用到NVActivityIndicator。近期在全局更新后发现运行不了了,会提示
Found bundle at /Users/user/Library/Developer/XCTestDevices/EDE1D09E-7C8A-4A03-B122-55BA26CA34CA/data/Library/Caches/com.apple.mobile.installd.staging/temp.7eRVwf/extracted/Payload/AppName.app/Frameworks/NVActivityIndicatorViewAppExtension.framework with the same identifier (me.vinhis.NVActivityIndicatorView) as bundle at /Users/user/Library/Developer/XCTestDevices/EDE1D09E-7C8A-4A03-B122-55BA26CA34CA/data/Library/Caches/com.apple.mobile.installd.staging/temp.7eRVwf/extracted/Payload/AppName.app/Frameworks/NVActivityIndicatorView.framework
多方查阅资料后找到了原因。https://github.com/ninjaprox/NVActivityIndicatorView/issues/265
这个框架在之前的使用过程中需要引用两个framework NVActivityIndicatorViewAppExtension.framework

NVActivityIndicatorView.framework
但近期貌似改了,只需要引用 NVActivityIndicatorViewAppExtension即可
这也是一个很典型的感觉不如CocoaPods方便的地方。

目前先介绍用法,有其他的新发现会回来更新文章或者发新文章说明。

建了一个Swift的QQ交流群 859978655,欢迎大家加入。

顺手写了英文版,感觉更习惯用英文去描述这些。https://www.jianshu.com/p/08d282d5b930

你可能感兴趣的:(Carthage的用法及注意事项)