美文网首页
iOS 新的依赖管理工具Carthage 使用

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

作者: 契约工程师 | 来源:发表于2017-08-23 13:53 被阅读0次

    我们通常使用的依赖管理工具是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 "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 的 BuildSettingsPackaging 中 将 Produce Module NameProduce Name修改成需要的名字

    • 如果你的工程中包含分类,你需要在Build SettingsLinkingOther 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

    相关文章

      网友评论

          本文标题:iOS 新的依赖管理工具Carthage 使用

          本文链接:https://www.haomeiwen.com/subject/qmgkdxtx.html