美文网首页
Carthage: Cocoa 新的依赖管理工具

Carthage: Cocoa 新的依赖管理工具

作者: coderTian | 来源:发表于2016-05-24 10:48 被阅读293次

    一. 简介

    我之前用过 CocoaPods,很大一部分原因就是因为麻烦,仅个人感觉,需要牵扯 XCode 项目文件;而 Carthage 就很好的解决了我之前的烦恼,轻耦合,更灵活;使用 xcodebuild工具来编译依赖项目成二进制 Framework,再引入到项目中去。
    Carthage是由 Swift 语言写的,只支持动态框架,只支持 iOS8+。
    **Carthage **的大致工作流程如下:

    创建一个 Cartfile
     文件,写好你要哪些依赖库
    执行 carthage update
     命令拉取源代码并编译为 Framework
    把编译后的 .framework
     拖到项目中去即可 (官方是这么说的,不过更好的办法是把 Carthage 编译的 Framework 路径加入到 Build Setting 中的 Framework Search Path,详情见后文)
    

    执行 update
    命令后,你的项目目录结构大致如下:


    Paste_Image.png

    Cartfile 文件用来标注你需要哪些依赖库,对应版本或者 Git 分支 (需要提交到 Git)
    Cartfile.resolved 文件用来跟踪项目当前所用的依赖版本号,为了保持多端开发一致 (需要提交到 Git)
    Carthage 文件夹用来存放依赖库的源文件和编译后的文件 (不需要提交到 Git)

    其实工作方式有点和 Cocoapods 大致相似,只不过 Cartfile 多了一个自动编译过程且与 Project 耦合更低

    二. 安装

    推荐使用 Homebrew 进行安装,简单方便,也便于维护:

    brew install carthage
    

    安装前最好先 update 一下,之前我就是因为没有 update,结果安装了老版本的 Carthage

    brew update
    

    三. 使用

    添加 Cartfile 文件

    类似于 CocoaPods 中的 Podfile文件,把需要的包写进去就行了,具体可参阅官方说明,如:

    #必须最低 2.3.1 版本
    github "ReactiveCocoa/ReactiveCocoa" >= 2.3.1
    
    # 必须 1.x 版本
    github "Mantle/Mantle" ~> 1.0 # (大于或等于 1.0 ,小于 2.0)
    
    # 必须 0.4.1 版本
    github "jspahrsummers/libextobjc" == 0.4.1
    
    # 使用最新的版本
    github "jspahrsummers/xcconfigs"
    
    # 使用一个私有项目,在 "development" 分支
    git "https://enterprise.local/desktop/git-error-translations.git" "development"
    

    暂只支持 GitHub 和 git 源,在执行carthage update命令后会在根目录创建一个Cartfile.resolved文件,这个文件是生成后的依赖关系,不能修改。

    Carthage导入第三方时候会显示编译OSX、Mac、iOS等很耗时,只选择一种(目前没试过)

    carthage build --platform iOS
    
    引入 Framework

    在项目中引入依赖的 Framkework,只需要在对应 Target 中的 Build Setting 中的 Framework Search Path 项加入以下路径,Xcode 便会自动搜索目录下的 Framework:

    $(SRCROOT)/Carthage/Build/iOS
    

    如果是 OSX 项目则把末尾的 iOS 改为 Mac

    我试过不用下面的方式也是可以直接运行成功,目前还在测试中

    在项目中选中Target -> Build Phases -> Link Library with Librarie点击+号,然后点击左下角的add Other.. 找到。framework添加就行

    Paste_Image.png

    添加脚本 在 Build Phases -> +(左上角) -> New Run Script Phase 然后,点开Run Script 添加脚本

    /usr/local/bin/carthage copy-frameworks
    

    最后添加"Input Files”

    $(SRCROOT)/Carthage/Build/iOS/Masonry.framework
    
    Paste_Image.png

    添加的脚本的作用 在App Store提交通用二进制触发bug时这个脚本将运行,保证在归档时必要的bitcode相关文件被拷贝。 This script works around an App Store submission bug triggered by universal binaries and ensures that necessary bitcode-related files are copied when archiving. 另外需要注意Carthage 支持OS X的各个版本,但是对于iOS只支持iOS 8及其以上 only officially supports dynamic frameworks. Dynamic frameworks can be used on any version of OS X, but only on iOS 8 or later.

    在项目中使用第三方库

    Paste_Image.png
    在 Git 中忽略

    如果不想把 Carthage 的依赖库 push 到 Git 仓库里,则修改 .gitignore 文件,增加忽略 Carthage 文件夹就行了:

    四. 基本命令

    archive: Archives a built framework into a zip that Carthage can use
    bootstrap: Check out and build the project's dependencies
    build: Build the project's dependencies
    checkout: Check out the project's dependencies
    copy-frameworks: In a Run Script build phase, copies each framework specified by a SCRIPT_INPUT_FILE environment variable into the built app bundle
    fetch : Clones or fetches a Git repository ahead of time
    help: Display general or command-specific help
    update: Update and rebuild the project's dependencies
    version: Display the current version of Carthage

    有什么问题可以直接回复我

    相关文章

      网友评论

          本文标题:Carthage: Cocoa 新的依赖管理工具

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