ios依赖管理工具:Carthage

dowhilenet

Cocoa的依赖管理器,我们已经有了CocoaPods,非常好用,那么为什么还要创建这样一个项目呢?

首先,CocoaPods默认会自动创建并更新你的应用程序和所有依赖的Xcode workspace。Carthage使用xcodebuild来编译框架的二进制文件,但如何集成它们将交由用户自己判断。CocoaPods的方法更易于使用,但Carthage更灵活并且是非侵入性的。

创建Carthage的原因是想要一种尽可能简单的工具——一个只关心本职工作的依赖管理器,而不是取代部分Xcode的功能,或者需要 让框架作者做一些额外的工作。CocoaPods提供的一些特性很棒,但由于附加的复杂性,它们将不会被包含在Carthage当中。

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

安装Carthage

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

brew install carthage

安装前最好先 update 一下,

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 文件,这个文件是生成后的依赖关系,不能修改。

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

artfile
Cartfile.resolved
Carthage
    - Build
        - iOS
            - Alamofire.framework
        - Mac
            - Alamofire.framework
    - Checkouts
        - Alamofire
        - ...
xxx.xcodeproj
...

在这个过程当中,Carthage将创建一些build artifacts,其中最重要的是Cartfile.resovled文件,里面将列出每个框架的具体版本,确保你提交了这个文件到版本控制工具里面(如Git、SVN),因为每个用到项目的人都需要它来编译相同版本的框架。

  • Cartfile 文件用来标注你需要哪些依赖库,对应版本或者 Git 分支 (需要提交到 Git)

  • Cartfile.resolved 文件用来跟踪项目当前所用的依赖版本号,为了保持多端开发一致 (需要提交到 Git)

  • Carthage 文件夹用来存放依赖库的源文件和编译后的文件 (不需要提交到 Git)

build了这么多平台实在太慢了,所以可以指定平台:

carthage build --platform iOS

如果你只是想更新一个或者某几个,只要用空格隔开就可以了。

carthage upate Box

引入 Framework

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

$(SRCROOT)/Carthage/Build/iOS

或者

在你的应用程序target的General设置标签中的Embedded Binaries区域,将框架从Carthage.build文件夹拖拽进去。

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

在 Git 中忽略

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

#Carthage
Carthage

完成上面的步骤并提交你的修改,项目的其他用户就只需要获取该仓库并执行carthage bootstrap就能使用你所添加的框架。

可用命令

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

阅读 4.6k

这块显卡有点冷
迷茫的程序员的成长之路
654 声望
10 粉丝
0 条评论
654 声望
10 粉丝
文章目录
宣传栏