我们通常使用的依赖管理工具是CocoaPods,今天使用新的管理工具Carthage
为什么使用Carthage,非侵入性和去中心化
用过CocoaPods的都知道,CocoaPods对项目的侵入性较高,使用不便,而Carthage 轻耦合,更灵活.同是也是我的尝鲜之举
CocoaPods 是存在中心服务器的依赖管理工具,受限于中心服务器的稳定性和资源质量, 尤其是网络环境较差时比较明显(当然他的优势也很明显,资源丰富,维护人员众多,但是说实话,一个pod的创建还是比较麻烦的)而 Carthage 是去中心化,只依赖于github或者git地址.没有中心引起的另一个弊端就是: 需要自己去查找资源...
两种使用体验,两种思想体系,如何选择看自己.
Carthage介绍
Carthage 是由 Swift 语言写的,只支持动态框架,只支持 iOS8+。
工作流程:
- 创建一个
Cartfile
文件,写好依赖哪些框架 - 执行
carthage update
,拉取代码,并且编译成framework - 把编译好的
.framework
放到项目中,具体怎么放,后文详述
目录结构:
Cartfile
Cartfile.resolved
Carthage
- Build
- iOS
- Alamofire.framework
- Mac
- Alamofire.framework
- Checkouts
- Alamofire
- ...
xxx.xcodeproj
...
开始使用
- 进入指定目录下,创建一个工程,工程名称为abc
- 在根目录创建一个Cartfile 文件
touch Cartfile
- 在Cartfile 文件中写入
# 最低版本 2.0.3
# github "Mantle/Mantle" >= 2.0.3
# 大于或等于 2.0.3 ,小于 最大版本
# github "realm/realm-cocoa" ~> 2.0.3
# 必须是2.0.3版本
# github "realm/realm-cocoa" == 2.0.3
# 默认使用最新版本
# github "realm/realm-cocoa"
# 使用一个私有项目,在 "development" tag中,可以指定git地址,加上指定的tag,引申一下,如果某个工程没有打tag,是无法使用Carthage的
git "git@10.0.50.71:/home/git/zzjs.git" "ZZContainerPODv2.0.3"
使用
carthage update
更新资源,类似于pod install
在根目录下产生/Carthage/Build/iOS 中的.framework就是我们需要的
下面到工程中引用这个打好的framework,只需要在对应 Target 中的 Build Setting 中的 Framework Search Path 项加入以下路径,Xcode 便会自动搜索目录下的 Framework:
$(SRCROOT)/Carthage/Build/iOS
- 这时运行应该会崩溃,提示信息: image not found,有经验的同学都知道出现这个问题是因为动态库, 只有引用找不到代码导致的,我们在
Build Prases
左上角的+
号,添加New Run Script Phases
,添加内容/usr/local/bin/carthage copy-frameworks
, 在Input Files
中添加$(SRCROOT)/Carthage/Build/iOS/xxx.framework
,运行即可
git 忽略
.gitignore 文件,增加忽略 Carthage 文件夹就行了
使用心得/出现的问题
- 如何进入framework内部进行 单步调试
和framework 同时生成的还有符号文件.dYSM,我们先将文件拷贝到根目录,然后在Build Phases
不是所有的github库支持
如何自己寻找可用的库
首先使用pod search寻找到自己需要的库,到github上,找到对应的库,输入github [github账号名]/[对应仓库名] [tag]
例如AFN, 就是github "AFNetworking/AFNetworking"
我自己的库 就是github "JXwilliamJi/MyCarthage"
如何让自己的工程支持Carthage
创建一个工程,github 创建一个远程仓库,或者在其他git远程仓库上创建
创建一个打包framework的 target,名称就是需要的名称
Build Phases
中的Compile
中添加所有的.m
文件,在header
中添加.h,调整需要暴露的到public 中到 framework target 的
BuildSettings
的Packaging
中 将Produce Module Name
和Produce Name
修改成需要的名字如果你的工程中包含分类,你需要在
Build Settings
的Linking
的Other Linker Flags
里加上-all_load
选择
Manager Schemes
, 选择对应打包framework的target后面的share的勾勾上,如果不打勾,使用Carthage会提示你,没有分享的target错误测试,到Cartfile 同级目录 输入
carthage build --no-skip-current
,产生framework 即成功将framework 放到一个新的工程测试,如果一切没有问题
最后一步,通过git 推送到远程仓库中,以后就可以使用了
具体请参考https://github.com/JXwilliamJi/MyCarthage
参考文档
http://blog.csdn.net/u014599371/article/details/52801263
http://www.cnblogs.com/theswiftworld/p/carthage.html
http://www.isaced.com/post-265.html