Carthage

Posted on | In | Visitors:
Words count in article: 1k words | Reading time ≈ 4 minutes

背景

随着公司的业务发展，移动端项目的功能也越来越多，很多相同功能模块存在于多个应用当中。因此我们对原有项目的架构做了一次优化，将这些公用模块独立出去开发，以此来减轻单个项目的体积，减少项目编译时间，提高小伙伴们开发效率。公司是多个项目并行开发，以 Objcetive-C 语言为主，部分项目采用 Swift 语言开发。

CocoaPods 和 Carthage

CocoaPods 是已存在很长时间的 Cocoa 依赖管理器，那么为什么要创建 Carthage 呢？

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

CocoaPods 最终目标是（参考:README）:

为提高第三方开源库的可见性和参与度，创建一个更中心化的生态系统。

Carthage 创建的是去中心化的依赖管理器。它没有总项目的列表，这能够减少维护工作并且避免任何中心化带来的问题。不过，这样也有一些缺点，就是项目的发现将更困难，用户将依赖于Github的趋势页面或者类似的代码库来寻找项目。

CocoaPods 项目同时还必须包含一个 podspec 文件，里面是项目的一些元数据，以及确定项目的编译方式。Carthage使用xcodebuild来编译依赖，而不是将他们集成进一个 workspace，因此无需类似的设定文件。不过依赖需要包含自己的 Xcode 工程文件来描述如何编译。

我们创建 Carthage 是想要一种尽可能简单的工具，而不是取代部分Xcode的功能，或者需要让框架作者做一些额外的工作。CocoaPods 提供的一些特性很棒，但由于附加的复杂性，它们将不会被包含在Carthage当中。

所以我们最终选择了 Carthage。

Carthage 使用

具体使用请参考官方文档

看不懂好吧请参考Carthage介绍(译)

还是不行，自己 Google 一下吧。

脚本工具配置

因为自己电脑没有配置 Carthage 的环境变量，每次进行项目更新的过程是痛苦的，首先你需要进入到项目指定目录下，其次全路径执行更新命令： XCODE_XCCONFIG_FILE=../carthage.xcconfig Carthage update, 而且新同事入职后如果以前没配置过 Carthage 也需要一顿操作。因此我用python写了一个执行脚本，只需要将脚本放到项目对应的目录中，不管你是不是第一次配置都可以在任意位置执行脚本。脚本内容如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
"""
迦太基更新执行脚本
执行环境: python3
可选配置参数项:
    GIT_SOURCE: git地址
    GIT_VERSION: 版本
执行命令:
python3 cartfile.py
"""
import os

# GIT 地址
GIT_SOURCE = 'git@xxx.git'
# GIT 版本
GIT_VERSION = '1.0.70'
BASE_DIR = os.path.abspath(os.path.dirname(__file__))
XCCONFIG_PATH = BASE_DIR + '/Build/carthage.xcconfig'
XCCONFIG_CONTENT = 'PLATFORM_NAME=iphoneos\nSUPPORTED_PLATFORMS=iphoneos'


def config_carthage_file():
    os.chdir(BASE_DIR)
    build_path = os.path.join(BASE_DIR, 'Build')
    if not os.path.exists(build_path):
        os.makedirs(build_path)
    with open(XCCONFIG_PATH, 'w') as f:
        f.write(XCCONFIG_CONTENT)
    print('****carthage.xcconfig config success****')

    cart_file = os.path.join(BASE_DIR, 'Cartfile')
    if os.path.exists(cart_file):
        print('*********Cartfile file exist, content: ************')
        with open(cart_file, 'r') as f:
            print(f.readline())
    else:
        print('*********Create Cartfile file************')
        content = 'git "{}""{}"'.format(GIT_SOURCE, GIT_VERSION)
        print('content: {}'.format(content))
        with open(cart_file, 'w') as f:
            f.write(content)
    print('***************************************************')


def start_update():
    # 进入到文件指定目录下
    os.chdir(BASE_DIR)
    cmd = 'XCODE_XCCONFIG_FILE={} Carthage update'.format(XCCONFIG_PATH)
    print(cmd)
    # 执行更新命令
    os.system(cmd)

if __name__ == '__main__':
    config_carthage_file()
    start_update()

特别说明： 以上配置只适用于公司内部项目，其他可参照修改

以上内容参考以下文章

Carthage：去中心化的Cocoa依赖管理器
Carthage介绍(译)