Carthage与CocoaPods类似,都是用于在iOS/OS X环境下管理第三方的工具。平时用CocoaPods用的比较多,近期用到Carthage发现也挺有意思,在此记录下。
Carthage不会像CocoaPods那样创建一个workspace。而是直接提供了一种去中心化的依赖管理系统,不提供中心化的项目列表,使用者可以自行添加类库,对项目的侵入性也较少。可以理解为只帮你下载和更新第三方依赖,怎么用看你自己。
安装Carthage:
推荐使用HomeBrew进行安装(没用过的自行百度,傻瓜式)
$ brew install carthage
使用Carthage
1.先进入到项目所在文件夹
$ cd 项目路径
- 创建一个空的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的文件夹,里面包含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
(这一步一般来说都是需要做的,但有些框架会明确指出不需要加这句脚本,就不用加了)
7.项目Target -> General最底下的Linked Frameworks and Libraries里手动添加需要用的framework.
8.在需要使用的地方import "xxx"
以上是具体的用法,下面介绍使用过程中可能会遇到的坑。
- 在执行Carthage update后,控制台可能会打印这样的错误。
unable to find utility 'xcodebuild, not a developer tool or in PATH'
原因是当git源码被checkout后,carthage会进行build。此时若是执行xcodebuild发生错误多半是因为在xcode中没有设置相应的编译工具选项。需要进到xcode的Preference中去设置Command Line Tools.
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文件,重新执行 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