Carthage的用法及注意事项
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"
image.png
以上是具体的用法,下面介绍使用过程中可能会遇到的坑。
- 在执行Carthage update后,控制台可能会打印这样的错误。
unable to find utility 'xcodebuild, not a developer tool or in PATH'
image.png
原因是当git源码被checkout后,carthage会进行build。此时若是执行xcodebuild发生错误多半是因为在xcode中没有设置相应的编译工具选项。需要进到xcode的Preference中去设置Command Line Tools.
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或是以下图片之类的提示。
image.png
这个很好解决,删掉根目录下的Carthage文件,重新执行 Carthage update。
目前先介绍用法,有其他的新发现会回来更新文章或者发新文章说明。
建了一个Swift的QQ交流群 859978655,欢迎大家加入。
顺手写了英文版,感觉更习惯用英文去描述这些。https://www.jianshu.com/p/08d282d5b930