教程｜使用 TeamCity 为 Android 项目构建 CI/CD 管道

本文是 draft.dev 的 kumar harsh 撰写的客座文章。

如果您经常发布 android 应用，您可能已经了解定义明确的构建、测试和部署工作流的价值。如果没有灵活的自动化 devops 工作流，就很难维持高速发布。通过持续集成和持续部署 (ci/cd) 自动执行这些工作流可以让您的工作变得更加轻松，让您更早地发现 bug，更快地发布产品。

jetbrains teamcity 是一个用于构建可靠管道的 ci/cd 平台。它可与流行的 android 开发工具无缝集成，并具有人性化界面来配置构建和测试的各个阶段。

本文将向您介绍如何使用 jetbrains teamcity 为您的 android 项目设置 ci/cd 管道。您将探索 android ci/cd 管道的关键组件，并深入了解如何使用 teamcity 配置一些示例管道。

android 开发的有效 ci/cd 管道包含标准 devops 管道中的所有步骤，并通过附加流程（如工件签名和自动部署到 google play 商店的内部轨道）对其进行了增强。下面是典型 android ci/cd 管道中涉及的所有步骤的快速概览：

1. 代码签出和版本控制集成：管道会先从您的版本控制系统（vcs，如 git）获取最新的代码更改。如果您在使用 teamcity，您将受益于它与流行的版本控制工具的集成以及在代码提交或合并时自动触发管道的功能。

2. 使用 gradle 实现构建自动化：android 项目的标准构建工具 gradle 是这一步的核心。teamcity 会执行 gradle 命令来编译您的代码、汇集资源并生成构建工件。teamcity 的构建运行程序提供了与不同 gradle 版本的兼容性和可自定义的构建配置环境。

3. 针对多个 android 版本/平台的单元和集成测试：下一步包括运行验证个别代码模块的单元测试和检查不同组件如何交互的集成测试（包括 ui 测试）。teamcity 允许您配置多个测试运行程序和框架（例如 junit、espresso），并使用模拟器或设备实验室针对各种 android 版本和平台执行测试。

4. 静态代码分析（以 jetbrains qodana 为特色）和代码覆盖率报告：静态代码分析有助于尽早识别潜在的 bug、安全漏洞和代码样式不一致。teamcity 与 jetbrains qodana 集成，后者是一款静态代码分析工具，具有代码异味检测、复杂代码分析以及与各种编程语言集成等功能，可以确保全面的代码质量检查。此外，teamcity 可以生成代码覆盖率报告，指示单元测试执行了代码的哪些部分。这有助于开发者重点关注覆盖率较弱的区域。

5. 工件生成和签名（apk 和 aab）：成功构建和测试后，下一步涉及创建可部署工件。对于 android 应用，这通常涉及生成已签名的 android package kits (apk) 或 android app bundles (aab)。teamcity 允许您使用构建步骤在管道内自动执行签名流程。

6. 部署到内部测试和生产环境（google play，beta 渠道）：ci/cd 管道可以将应用自动部署到各种环境。teamcity 允许配置部署到内部测试平台或直接部署到 google play 上的生产渠道。

7. 持续监控和反馈循环：可靠的 ci/cd 管道不会随着部署而结束。teamcity 集成了监控工具，使您能够跟踪应用性能、识别崩溃，以及收集用户反馈。此反馈循环使开发者能够对问题做出快速反应，并持续提高应用质量。

现在，您已经了解一般的 ci/cd 管道结构，我们来使用 teamcity 构建一个管道。以下各部分将指导您设置 teamcity、创建针对您的 android 项目量身定制的构建配置、运行集成自动化测试，以及最后配置应用的打包和部署。

为了简单起见，本教程使用云托管版本的 teamcity，该版本提供 14 天的免费试用。您可以使用 github、gitlab、bitbucket 或 google 账号注册，也可以使用老式的电子邮件地址和密码组合注册。在进入下一步之前，请务必激活试用版或订阅。

不过，您也可以使用 teamcity cloud 和自托管构建代理，甚至 teamcity on-premises 来实现本教程的目的。请记住，使用自托管构建代理或 teamcity on-premises 需要您在代理上单独安装 android sdk。

访问 teamcity cloud 实例后，您看到的初始视图将如下所示：

要开始处理 android 项目，请点击页面中间的 create project…（创建项目…）。然后，系统会要求您提供项目源代码的链接。如果您使用 git 托管服务提供商（如 github 或 bitbucket cloud）注册，请随时查看其相应部分，并使用专门的项目创建流程。

不过，如果您有仓库 url，可以直接在 from a repository url（从仓库 url）标签页中使用。teamcity 会自动检测 git 托管服务提供商，并从中拉取项目。

如果您手头没有 android 项目，可以使用以下仓库学习本教程：

bash
https://github.com/krharsh17/android-app-teamcity

如果您要访问的仓库是私有仓库，或使用用户名和密码组合进行了加密，您可以在此处提供相应的用户名和密码组合，以便 teamcity 能够访问该仓库。输入仓库 url（以及所需的其他详细信息）后，点击 proceed（继续）。

在下一页上，teamcity cloud 将验证与 vcs 仓库的连接。验证成功后，teamcity 将拉取一些与项目相关的元数据，例如名称、默认分支等。您可以在将这些值存储到 teamcity 项目之前对其进行修改。

确认此页面上的信息正确无误后，点击 proceed（继续）按钮。然后，teamcity 将开始根据仓库中的可用配置文件自动检测适用于该仓库的任何构建步骤。由于此仓库中具有基于 gradle 的配置文件，teamcity 会自动建议一组 gradle 任务（在本例中为 clean 和 build）。

选中 gradle 构建步骤旁边的复选框，然后点击 use selected（使用所选）：

完成后，会出现一个小横幅，上面写着您现在可以运行项目中的第一个构建。点击右上角的 run（运行）开始第一个构建：

点击按钮后，构建将加入队列，等待构建代理变得可用。您可以点击顶部导航窗格中的 projects（项目），然后选择正在运行的构建，以查看其属性和状态：

构建大约 5-6 分钟即可完成。恭喜！您已使用 teamcity 设置了第一个 android ci/cd 管道。此外，由于您使用了 vcs 仓库 url 来设置此管道，它已被配置为以固定的时间间隔自动轮询仓库 url，以查看是否有新的更改被推送到仓库。如果发现新的更改，管道会自动拉取最新的提交，并再次运行构建。

您还可以通过设置针对特定平台的 web 挂钩来进一步增强此功能。例如，您刚刚设置的仓库托管在 github 上。teamcity 允许您方便地安装 github web 挂钩，这样每次仓库有活动时，github 就会自动向 teamcity 发送通知：

如果愿意，您可以进行以上操作。不过，在本教程中并不需要这样做。

您设置的仓库包括两种版本（free 和 paid）。这两种版本各有两种构建变体（debug 和 release）。这意味着 build 任务的结果将包括四个二进制文件，每种可能的版本和变体组合对应一个文件。我们来配置管道，以便在管道运行结束后提取这些工件并使其可供访问。

为此，请点击顶部导航窗格中的 projects（项目），然后点击 android app teamcity （android 应用 teamcity）下的 build（构建），打开标题为build（构建）的构建配置的详细信息页面：

在这里，点击屏幕右上角的 edit configuration（编辑配置）按钮：

您可以在这里配置构建配置的常规设置。您会注意到在列表的底部有一个标题为 artifact paths（工件路径）的字段。您需要在这里定义希望在构建完成运行后提取和保留工件的路径：

app/build/outputs/apk/*/*/* => output

=> 是 ant 样式路径的一个特征，用于分隔输出和输入目录。output 是存储最终二进制文件的文件夹名称。

添加完成后，点击页面底部的 save（保存）按钮。您将看到一个黄色横幅，显示您的更改已保存：

现在，您可以使用页面右上角的 run（运行）按钮再次尝试运行管道，以查看构建完成后生成的工件：

现在，您已经设置一个管道，每次有提交推送到仓库的 main 分支时，管道就会被触发。此管道会为项目中的所有版本-变体组合生成未签名的构建工件，运行单元测试，并使构建工件可供查看。

接下来，您将学习如何自定义测试。

如前所述，gradle 任务 build 还负责对所有生成的构建工件运行单元测试。不过，在某些情况下，您可能只想在应用的几个变体上运行测试。在这种情况下，您需要将 clean build 任务替换为适合您的用例的任务。

例如，如果您要为应用的免费版本的 release 变体创建一个未签名的 apk，并对其运行单元测试，则应将 clean build 替换为 assemblefreerelease testfreereleaseunittest。为此，请点击顶部导航窗格中的 projects（项目），然后点击 android app teamcity（android 应用 teamcity）下的 build（构建）。在下一个页面上，与上一步的操作一样，点击右上角的 edit configuration（编辑配置）按钮。

您应该已进入构建配置的 general settings（常规设置）页面，您之前访问过该页面来配置工件路径。在左侧导航窗格中，点击 build step: gradle（构建步骤: gradle）。

这将打开 build steps（构建步骤）页面，您可以在该页面中修改此构建配置的构建步骤。点击第一个构建步骤（标题为 gradle）右侧的 edit（编辑）：

现在，您可以更新 gradle tasks（gradle 任务）字段，以更改将作为此构建的一部分执行的任务。将 clean build 替换为 assemblefreerelease testfreereleaseunittest：

现在，点击底部的 save（保存）。保存更改后，点击右上角的 run（运行）按钮。这将触发此构建配置的另一次运行。

构建运行完成后，您可以在构建运行详细信息页面的 tests（测试）标签页中查看 teamcity 生成的报告：

您可以查看每个单元测试的运行时间，以及测试完成后是否留下了任何堆栈跟踪。您还可以点击测试最右侧的三个点，然后选择 show test history（显示测试历史记录），将当前测试运行的性能与过去的运行进行比较：

您可以将测试的调查指派给团队成员，并通过 teamcity 本身跟踪其调查历史记录。如果愿意，您还可以点击测试概览页面上的 download（下载）链接下载测试结果。

此仓库中的测试数量很少，因此几分钟内就完成了构建运行。不过，在实际项目中，通常会有成百上千个单元测试。在这种情况下，在同一个运行程序代理上一个接一个地运行所有这些测试将耗费大量时间。要解决这个问题，您可以使用 teamcity 的并行测试构建功能。

teamcity 能够通过将测试运行拆分到多个构建代理来并行处理，从而帮助您最大限度地减少运行所有测试所需的总时间。要进行设置，请点击构建运行详细信息页面上的 edit configuration（编辑配置）按钮，然后点击左侧导航窗格上的 build features（构建功能）：

在 build features（构建功能）页面上，点击 + add build feature（+ 添加构建功能）按钮。在打开的对话框中，从下拉菜单中选择 parallel tests（并行测试）：

您需要输入并行执行测试的最大批次数。输入介于 4 和 8 之间的值可从并行化中获得最大收益。

完成后，点击 save（保存）按钮。现在，您可以尝试为具有大量测试用例的仓库运行测试，亲眼看看性能上的差异！

由于此应用有多种版本和变体，有必要利用 teamcity 提供的矩阵构建功能，将每种变体-版本组合拆分为其自己的运行实例，从而加快管道构建速度。此外，这还允许您构建应用程序的特定组合，而不必构建所有或单个变体-版本组合。

为此，您需要创建一个新的构建配置。点击顶部导航窗格中的 projects（项目），然后点击 android app teamcity（android 应用 teamcity）。在项目详细信息页面上，点击右上角的 edit project…（编辑项目…）按钮：

在 general settings（常规设置）页面上，点击 build configurations（构建配置）部分下方的 + create build configuration（+ 创建构建配置）按钮：

这将带您进入 create build configuration（创建构建配置）向导。在 repository url（仓库 url）字段中输入与之前相同的仓库 url (https://github.com/krharsh17/android-app-teamcity)，然后点击 proceed（继续）：

将下一页上的 build configuration name（构建配置名称）设置为 matrix builds（矩阵构建），并在所有其他字段中保留默认值。然后，点击 proceed（继续）按钮：

teamcity 将通知您已找到类似的 vcs 根。点击以下对话框中的 use this（使用）按钮：

这将确保 teamcity 对这两种构建配置只轮询一次 vcs url，以避免额外的性能开销。

构建配置完成后，您应该会收到确认其已创建的通知：

这一次，不需要设置 clean build gradle 任务，因此不要勾选此页面上的任何复选框。点击表上方的 configure build steps manually（手动配置构建步骤）链接。

您将进入 new build step（新建构建步骤）页面，您可以在该页面上为构建步骤选择首选运行程序：

从此列表中选择 gradle。在打开的下一个页面上，在 gradle tasks（gradle 任务）字段中输入 clean test%env.flavor%%env.variant%：

这将确保运行程序首先清理构建文件夹，然后为环境变量提供的版本和变体运行测试任务。例如，对于免费应用的 release 变体，任务将被称为 clean testfreerelease。

向下滚动并点击 save（保存）按钮。然后，您将返回 build steps（构建步骤）页面：

点击 + add build step（+ 添加构建步骤）按钮，添加另一个 gradle 构建步骤，任务为 assemble%env.flavor%%env.variant%。此步骤将为应用的给定版本和变体生成构建工件。

完成后，您的 build steps（构建步骤）页面应该会列出您创建的两个基于 gradle 的构建步骤，以及将作为其中一部分运行的 gradle 任务的快速摘要：

接下来，您还需要做两件事：定义您使用过的两个环境变量的值，以及配置工件路径。

您已经知道如何为构建配置设置工件路径。对于此构建配置，将 artifact paths（工件路径）字段设置为 app/build/outputs/apk/*/*/* => output，与上一个配置相同。

要为版本和变体字段设置矩阵值，请点击左侧导航窗格中的 build features（构建功能）。在 build features（构建功能）页面上，点击 + add build feature（+ 添加构建功能）按钮，并在对话框的下拉菜单中搜索 matrix build（矩阵构建）：

从下拉列表中选择 matrix build（矩阵构建）选项后，系统将要求您提供矩阵构建的形参及其值。提供形参名称 env.flavor，值为 free。添加另一个形参 env.variant，它的两个值为 release 和 debug。

接下来，点击 save（保存）按钮。至此，此管道上的矩阵构建设置完毕。您可以点击页面右上角的 run（运行）按钮进行测试。

现在，您可以分别查看每次运行的结果，以及单独的构建工件和测试结果。

您可以点击 dependencies（依赖项）标签页，查看每个运行的构建运行详细信息：

正如您之前看到的，您可以将每个条目作为独立的完整构建运行来探索。

android ci/cd 管道的一个关键部分是向 google play 推送发行版二进制文件，以便向用户发布。您也可以使用 teamcity 和 gradle play publisher (gpp) 自动执行此操作。

在开始此流程之前，有一些先决条件：

1. 确保您已将 android 项目的第一个 apk/aab 手动上传到 google play 管理中心。

2. 您必须拥有有效的签名配置。

3. 您需要在 google cloud platform 上创建一个服务账号，以便能够使用 google play developer api 并检索其 json 凭据文件。为此，请按照以下步骤操作，然后再进行下一步。

完成上述链接中的详细步骤后，您需要在 android 项目中安装和配置 gpp。为此，请将以下代码行添加到应用级 build.gradle.kts 文件中的插件块中：

kt
id("com.github.triplet.play") version "3.9.1"

然后，在此文件的根级添加一个 play {} 块，内容如下：

kt
play {
    serviceaccountcredentials.set(file("play_config.json"))
    track.set("internal")
    releasestatus.set(releasestatus.draft)
    defaulttoappbundles.set(true)
}

这会将 gpp 配置为使用名为 play_config.json 的文件中的服务账号凭据，在将二进制文件推送到 play 管理中心时将轨道设置为 internal，并将发布状态设置为 draft，并默认使用应用捆绑包代替 apk。

您的 android 项目的必要配置步骤到此完成。在继续之前，将这些更改提交并推送到 github 仓库。

现在，您将在 teamcity 中创建一个新的构建配置，用于将二进制文件推送到 google play。按照与之前相同的步骤创建新的构建配置。将第一个构建步骤设置为使用 gradle 作为运行程序，并将 bundlefreerelease 作为要运行的 gradle 任务：

在此构建配置中添加另一个步骤，但这次要选择 command line（命令行）作为构建运行程序：

命令行运行程序的新构建步骤页面将会打开。您需要提供自定义脚本，用于签署应用捆绑包并将其发布到 google play。在 custom script（自定义脚本）字段中输入以下代码：

# create the keystore file from the environment variables
echo %env.android_keystore_file% > keystore.jks.b64
base64 -d -i keystore.jks.b64 > app/keystore.jks

# sign the aab using the keystore and credentials retrieved from the environment variables
jarsigner 
-keystore app/keystore.jks 
-storepass %env.keystore_store_password% 
-keypass %env.keystore_key_password% 
-signedjar release.aab 
app/build/outputs/bundle/freerelease/app-free-release.aab 
%env.keystore_key_alias%

# create the gcp service account credentials file from the environment variables
echo %env.play_config_json% > play_config.json.b64
base64 -d -i play_config.json.b64 > app/play_config.json

# use gpp to publish the app bundle
./gradlew publishfreebundle --artifact-dir release.aab

代码中的内联评论解释了每一行的作用。完成后，点击页面底部的 save（保存）按钮：

您还需要定义以下环境变量，以便为脚本提供正确的凭据来签署和发布应用：

bash
android_keystore_file
keystore_key_alias
keystore_key_password
keystore_store_password
play_config_json

点击左侧导航窗格中的 parameters（形参），转到可以定义这些环境变量的页面。您会看到 teamcity 已经在此页面上为您填充了所需变量的列表：

对于 keystore_key_alias、keystore_key_password 和 keystore_store_password，请随意点击 edit（编辑）并在相应的对话框中提供它们的值：

对于 android_keystore_file 和 play_config_json，您首先需要使用 openssl 等工具将文件转换为 base64，然后将 base64 编码的内容粘贴到这些变量的值字段中。

这将设置管道来构建和发布应用程序的免费版本的签名发布版。您可以尝试点击页面右上角的 run（运行）按钮，触发运行并查看运行情况。

运行成功后，您将在日志中看到 build successful 消息：

以下是您的应用的最新版本，可在google play 管理中心的内部轨道上查看，并随时供您编辑和推广：

您会注意到，新版本的名称 (“2.0”) 与上一版本面向开发者的名称相同。这是因为没有在 gpp 配置中指定名称。您可以查看 gpp 文档，了解如何自行完成该操作。

现在，您可以使用 teamcity 为 android 设置自己的管道，以下是您可以考虑实施的一些关键最佳做法，以确保您的管道高效快速：

1. 版本控制和版本管理做法：高效的 ci/cd 管道在很大程度上依赖于强大的版本控制系统 (vcs)，如 git。确保您的团队坚持明确的版本管理做法，并实施一致的分支策略（如功能分支）。例如，为不同的分支开发自定义的管道，确保不会在 wip 代码上运行不必要的步骤。

2. 明确的通过/失败标准和阈值：明确定义什么是成功的构建和测试运行。这可能涉及为单元测试覆盖率设置阈值，为其他代码检查亮起绿灯等。您应该针对管道的每个阶段为 teamcity 配置通过/失败标准，以确保构建的可靠性，并鼓励开发者编写更好的代码。

3. 利用 teamcity 通知和警报：teamcity 提供了详细的通知系统，可以帮助通知用户跨 web 浏览器、电子邮件、slack 和 ide 的管道事件。确保为构建失败和关键测试失败设置警报，以便让开发团队及时了解情况并迅速解决问题。

4. 协作和反馈循环：高效的 ci/cd 管道可以促进开发团队内部的协作。您应该在 teamcity 中使用构建管道可视化，为开发者提供整个构建和测试流程的清晰概况。您还可以直接在 teamcity 内使用测试和构建调查来指派调查和协作处理调查，以了解构建或测试失败的原因。同时，鼓励团队成员审查构建失败和代码覆盖率报告，以确定需要改进的地方。这有助于培养代码质量和持续改进的文化。

5. 安全措施（代码签名和访问控制）：确保为 teamcity 实例配置适当的访问控制，限制只有需要访问信息的用户才能访问签名密钥等敏感信息。您应该考虑使用类似 hashicorp vault 的工具来管理和轮换您在构建过程中可能使用的所有敏感凭据。您可以在这里查看 teamcity 的其他一些关键安全建议。

在本文中，您了解了如何使用 jetbrains teamcity 为 android 开发项目构建和管理详细的 ci/cd 管道。您探索了 android ci/cd 管道从代码迁出和版本控制集成到签名、部署和监控等各个关键阶段。您了解了 teamcity 如何促进每个阶段并简化开发工作流。最后，您还将学习一些关键的最佳做法，以确保您的管道高效运行。

通过使用 teamcity 来设置 android 管道，您可以大大提高工作流效率。这直接带来更快的发布周期、更少的 bug，最终高效交付高质量的 android 应用。因此，请迈出更简化开发流程的第一步，立即开始构建您的 ci/cd 管道吧！

本博文英文原作者：olga bedrina

teamcity 相关阅读

关于 teamcity

teamcity 是一款强大的持续集成和部署服务器，面向以 devops 为中心的团队提供开箱即用的测试智能、构建问题的实时报告以及无与伦比的可扩展性。安装和部署 teamcity，几分钟之内即可开始构建您的 devops 管道。teamcity 提供本地部署和基于云的版本。

进一步了解 teamcity

⏬ 戳「阅读原文」了解更多信息