iOS提升持续化集成首页投稿（暂停使用，暂停投稿）

Facebook xctool 的使用

2016-08-02  本文已影响1473人  冷漠叻荭颜

Facebook xctool readme 原文链接

xctool

xctool 相比苹果的 xcodebuild，可以更加简单方便地编译构建和测试 iOS、Mac 项目，对可持续集成 CI 尤其有用。

特点

xctool 在 xcodebuild 的基础上添加了一些额外的功能：

使用必备条件

安装

xctool 可以从 homebrew 安装

$ brew install xctool

也可以下载后运行 xctool.sh 命令。

使用

xctool 的命令和选项是 xcodebuild 的一个扩展，在大多数情况下，你只需要替换 xcodebuild 为 xctool，会如期运行，但有更具吸引力的输出。

可以通过如下命令获取帮助和完整的配置列表：

path/to/xctool.sh -help

编译

使用 xctool 编译项目和使用 xcodebuild 是一样的。

如果是使用 workspaces 和 schemes ：

path/to/xctool.sh \
    -workspace YourWorkspace.xcworkspace \
    -scheme YourScheme \
    build

如果使用的是 projects 和 schemes：

path/to/xctool.sh \
    -project YourProject.xcodeproj \
    -scheme YourScheme \
    build

常见配置比如 -configuration，-sdk，-arch 和 xcodebuild 是相同的。

注意：xctool 不支持使用 -target 来编译 targets，必须使用 schemes。

单元测试

xctool 的 test 命令，可以配置 scheme 中如何编译和运行测试。也可以限制哪些单元测试运行，或者指定运行的 SDK 版本。

使用如下命令，编译运行所有单元测试：

path/to/xctool.sh \
    -workspace YourWorkSpace.xcworkspace \
    -scheme YourScheme \
    test

在指定的 target 上编译运行单元测试，使用 -only 配置：

path/to/xctool.sh \
    -workspace YourWorkSpace.xcworkspace \
    -scheme YourScheme \
    test -only SomeTestTarget

可以进一步配置只运行特定的单元测试类：

path/to/xctool.sh \
    -workspace YourWorkSpace.xcworkspace \
    -scheme YourScheme \
    test -only SomeTestTarget:SomeTestClass

甚至只运行某个单元测试类的某个方法：

path/to/xctool.sh \
    -workspace YourWorkSpace.xcworkspace \
    -scheme YourScheme \
    test -only SomeTestTarget:SomeTestClass/testSomeMethod

也可以指定匹配前缀的类和方法：

path/to/xctool.sh \
    -workspace YourWorkSpace.xcworkspace \
    -scheme YourScheme \
    test -only SomeTestTarget:SomeTestClassPrefix*,SomeTestClass/testSomeMethodPrefix*

也可以在指定 SDK 版本上运行单元测试：

path/to/xctool.sh \
    -workspace YourWorkSpace.xcworkspace \
    -scheme YourScheme \
    test -test-sdk iphonesimulator5.1

编译单元测试

当编译和运行单元测试时，有时不需要运行只是编译，可以使用 build-tests 指令，例：

path/to/xctool.sh \
    -workspace YourWorkSpace.xcworkspace \
    -scheme YourScheme \
    build-tests

可以使用 -only 指定在某个 target 上编译：

path/to/xctool.sh \
    -workspace YourWorkSpace \
    -scheme YourScheme \
    build-tests -only SomeTestTarget

运行单元测试

如果已经使用 build-tests 编译，使用 run-tests 就可以直接运行单元测试。这样的作用是只需编译一次，便可运行在不同 SDK 版本上。

运行所有单元测试，你将使用：

path/to/xctool.sh \
    -workspace YourWorkSpace.xcworkspace \
    -scheme YourScheme \
    run-tests

和 test 指令一样，可以通过 -only 来限制哪些单元测试运行，也可以使用 -test-sdk 运行在指定的 SDK 版本上。

可以选择在运行单元测试时指定 -testTimeout。当某个独立的测试到了超时时间，会被认为失败而不是无限等待，可以防止测试任务因为发生错误而导致死锁。

默认情况下，模拟器启动程序单元测试等待最多 30s，可以使用 -launch-timeout 指令来修改超时时间。

并行运行单元测试

xctool 可以配置并行运行单元测试，以便更好地利用空闲的多核 CPU。

若要允许多个测试任务同时运行，使用 -parallelize 指令：

path/to/xctool.sh \
    -workspace YourWorkSpace.xcworkspace \
    -scheme YourScheme \
    run-tests -parallelize

上面给出的并行，仍限制于最慢的测试任务。比如，两个测试任务（'A' 和 'B'），'B' 因为包含 10 倍多测试需要花费 10 倍的时间来运行，这样上述并行运行帮助并不大。

可以使用 -logicTestBucketSize 指令将测试任务分为几个 bucket ：

path/to/xctool.sh \
    -workspace YourWorkSpace.xcworkspace \
    -scheme YourScheme \
    run-tests -parallelize -logicTestBucketSize 20

上面将测试任务分为每个 bucket 20 个测试用例，这些测试将同时运行，如果测试包比其他大得多，这样可以加快整体测试运行速度。

可持续集成（CI）

对于可持续集成服务器比如 Travis CI 或者 Jenkins 来运行单元测试，xctool 是不错的选择。为了在可持续集成环境中运行单元测试，必须为应用的 target 创建一个 Shared Schemes target，同时确保所有依赖已经正确添加到 Scheme 中（比如 CocoaPods）。参照如下步骤：

  1. 选择 Product > Schemes > Manage Schemes 菜单，打开 Manage Schemes。

  2. 在列表中找到应用的 target，确保在右手边的 Shared 复选框已经选中。

  3. 如果应用或者单元测试的 target 包含跨项目的依赖比如 CocoaPods，还需要确保它们已经正确配置。可参照如下步骤：

    • 选中应用的 target，点击 Edit 按钮打开 Scheme 编辑弹窗。
    • 在 Scheme 编辑器里面点击左手边的 Build 选项。
    • 点击 + 号按钮为项目添加所有依赖，CocoaPods 将以名字为 Pods 的静态库出现。
    • 拖动依赖到应用的 target 下方，方便应用的 target 优先编译。

现在，在工程项目里的 xcshareddata/xcschemes 目录下会有一个文件，这就是刚刚配置好的 Shared Scheme，在 git\svn 仓库中添加该文件，xctool 将在下一次 CI 编译时，找到并执行单元测试。

Travis CI 配置示例

Travis CI 是一个非常流行的，免费提供给开源项目的可持续集成系统，它集成于 Github，并且对于 Objective-C 工程，Travis CI 默认使用 xctool 作为编译和测试工具。按照上面的步骤设置好 Shared Schemes 后，还需要配置 .travis.yml 文件。

如果是使用 workspace，.travis.yml 文件内容格式如下：

language: objective-c
xcode_workspace: path/to/YourApp.xcworkspace
xcode_scheme: YourApp

如果是使用 projects，.travis.yml 文件内容格式如下：

language: objective-c
xcode_project: path/to/YourApp.xcodeproj
xcode_scheme: YourApp

.travis.yml 文件还可以灵活配置怎样安装 Travis 和调用 xctool：

language: objective-c
before_install:
    - brew update
    - brew install xctool
script: xctool -workspace MyApp.xcworkspace -scheme MyApp test

你可以在 About OS X Travis CI Environment 这份文档中学到更多有关 iOS 和 OSX 应用的 Travis CI 环境，通过查阅 Getting Started 找到配置项目的详细文档。

日志样式

xctool 以不同的样式输出编译构建和测试结果日志，如果不指定日志样式，xctool 默认使用 pretty 和 user-notifications，xctool 也有如下规则：

可以通过 -option 选项来选择自己的日志输出样式：

path/to/xctool.sh \
  -workspace YourWorkspace.xcworkspace \
  -scheme YourScheme \
  -reporter plain \
  build

默认情况下，日志是标准输出，但是也可以直接在日志样式选项后追加 :OUTPUT_PATH 来指定日志输出到文件中：

path/to/xctool.sh \
  -workspace YourWorkspace.xcworkspace \
  -scheme YourScheme \
  -reporter plain:/path/to/plain-output.txt \
  build

只要喜欢，可以使用尽可能多的日志样式，只需多次使用 -reporter 选项。

包含的日志样式

实现自己的日志样式

你也可以使用任何你喜欢的语言来实现自己的日志样式，在 xctool 中，日志样式是独立可执行的，从 STDIN 读取 JSON 对象，格式化结果写入到 STDOUT。

你可以通过 -reporter 选项指定完整路径调用自定义日志样式：

path/to/xctool.sh \
  -workspace YourWorkspace.xcworkspace \
  -scheme YourScheme \
  -reporter /path/to/your/reporter \
  test

例如，下面是用 Python 写的一个简单的日志样式，每次测试通过输出一个句号 .，失败则输出一个感叹号 !。

#!/usr/bin/python

import fileinput
import json
import sys

for line in fileinput.input():
    obj = json.loads(line)

    if obj['event'] == 'end-test':
        if obj['succeeded']:
            sys.stdout.write('.')
        else:
            sys.stdout.write('!')

sys.stdout.write('\n')

如果你用 Objective-C 写日志样式，你会发现 Reporter 类比较有帮助，见 Reporter.h。

配置（****.xctool-args****）

如果你在命令行中经常需要通过很多参数来使用 xctool，可以设置 ****.xctool-args**** 文件来加快工作流程。如果 xctool 在当前目录中发现 ****.xctool-args**** 文件，它会自动在参数那里预填充。

格式是一个 JSON 数组的参数配置：

[
  "-workspace", "YourWorkspace.xcworkspace",
  "-scheme", "YourScheme",
  "-configuration", "Debug",
  "-sdk", "iphonesimulator",
  "-arch", "i386"
]

通过命令行配置的任何额外参数优先于它们在 .xctool-args 文件中的配置。

上一篇下一篇

猜你喜欢

热点阅读