This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.
使用 TesterArmy
编辑页面
了解如何使用 EAS Build 和 EAS Workflows,在每次 push 和 pull request 时使用 TesterArmy 测试 Expo 应用。
TesterArmy 是一个使用 AI 代理测试应用的托管测试平台。代理会打开应用,像用户一样点击完成流程,并检查结果。TesterArmy 会在云端 Android Emulators 和 iOS Simulators 上运行已保存的测试和探索代理。
本指南介绍如何使用 EAS Build 构建应用,并通过 EAS Workflows 在每次 push 和 pull request 时运行 TesterArmy 测试。要使用 TesterArmy 的开源 e2e 框架在本地模拟器上运行测试,请参阅使用 TesterArmy 的 e2e。

使用 EAS Workflows 构建或重新打包应用,并让 TesterArmy 代理在云端模拟器上测试每个 pull request。
3 requirements
3 requirements
1.
在 tester.army 注册并创建移动项目。至少向测试组添加一个测试,并从 TesterArmy 控制台运行一次测试,确认它可以正常工作。
2.
EAS Workflows 会响应来自 GitHub 的 push 和 pull request 事件。请参阅将 GitHub 仓库链接到 Expo 项目。
3.
在 TesterArmy 项目的 Integrations 标签页中连接仓库。没有此集成,TesterArmy 无法在 pull request 上发布检查或评论。
在 EAS Workflows 上运行 TesterArmy 测试
1
添加构建配置文件
TesterArmy 运行 Android APK(.apk)和 iOS Simulator 构建(.app)。它不接受 .aab 或 .ipa。Android 构建还需要在应用配置中设置 android.package。将两个构建配置文件添加到 eas.json:
2
添加环境变量
工作流从 EAS 项目的 preview 环境读取以下变量:
在 EAS 控制台或使用 EAS CLI 中创建变量。将 TESTERARMY_API_KEY 的可见性设置为 Secret,不要为它添加 EXPO_PUBLIC_ 前缀。
3
添加工作流
使用以下工作流创建 .eas/workflows/testerarmy-mobile-tests.yml。它会响应 main 分支的 push 和 pull request 事件,也支持手动运行。对于每个平台,它会运行以下 job:
buildjob 使用 TesterArmy 构建配置文件创建应用。- 上传 job 使用
eas/download_build下载应用,并运行npx testerarmy upload-app。 - 测试 job 使用测试组运行
npx testerarmy ci。工作流在 pull request 上运行时,TesterArmy 会在 pull request 上发布 GitHub check 和评论;在 push 到main时运行,则会在提交上发布 GitHub check。
要在没有 push 的情况下启动工作流,请运行:
4
使用 fingerprint 和 repack 跳过原生构建
每次运行都进行完整原生构建会很慢。如果更改只涉及 JavaScript,工作流可以复用现有构建。将以下 job 添加到 build job 之前:
- 一个
fingerprintjob 为每个平台计算应用原生代码的哈希值。 - 对于每个平台,一个
get-buildjob 会查找具有相同哈希和构建配置文件的现有构建。 - 如果构建存在,
repackjob 会将当前 JavaScript bundle 添加到该构建中。否则,buildjob 会运行并创建新构建。
随后,上传 job 会在创建构建的 repack 或 build job 之后运行。请确保 fingerprint job 的 environment 与构建配置文件使用的环境相同。
fingerprint job 仅支持 Continuous Native Generation(CNG)。如果提交了 android 和 ios 目录,请使用上一步的工作流。
5
使用探索代理测试 pull request
探索代理只在 pull request 上运行。它会读取 pull request 的标题、描述和更改,并自行编写测试步骤。它在已上传的应用上运行这些步骤,然后使用每个步骤的结果和视频更新 pull request 评论。
将这些 job 添加到第 3 步或第 4 步的工作流中。它们会使用上传 job 发送给 TesterArmy 的应用:
运行开始前,TesterArmy 会检查更改。pull request 可能没有用户可见的更改,例如文档或配置更改。此时 check 会显示 Tests skipped 及原因。TesterArmy 会针对每个平台分别做出判断。默认情况下,TesterArmy check 不会阻止合并。
如果由编码代理编写 pull request,请将 TesterArmy 测试说明添加到 AGENTS.md 或 CLAUDE.md。这样,代理会在每个 pull request 描述末尾添加探索代理可以遵循的步骤。
其他资源
在 EAS Workflows 上运行 TesterArmy 平台测试,使用 fingerprint 和 repack、探索代理,以及面向编码代理的设置提示。
包含 TesterArmy 构建配置文件和工作流的 Expo 应用。