iOS 新的依赖管理工具Carthage 使用

我们通常使用的依赖管理工具是CocoaPods,今天使用新的管理工具Carthage

为什么使用Carthage,非侵入性和去中心化

用过CocoaPods的都知道,CocoaPods对项目的侵入性较高,使用不便,而Carthage 轻耦合,更灵活.同是也是我的尝鲜之举

CocoaPods 是存在中心服务器的依赖管理工具,受限于中心服务器的稳定性和资源质量, 尤其是网络环境较差时比较明显(当然他的优势也很明显,资源丰富,维护人员众多,但是说实话,一个pod的创建还是比较麻烦的)而 Carthage 是去中心化,只依赖于github或者git地址.没有中心引起的另一个弊端就是: 需要自己去查找资源...

两种使用体验,两种思想体系,如何选择看自己.

Carthage介绍

Carthage 是由 Swift 语言写的，只支持动态框架，只支持 iOS8+。

工作流程:

1. 创建一个Cartfile文件,写好依赖哪些框架
2. 执行carthage update,拉取代码,并且编译成framework
3. 把编译好的.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 "[email protected]:/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