套件配置与运行
控制台里仍称「构建套件」；构建套件（Build） = 一次自动化执行的「配方」：脚本从哪来、装哪个 App、在哪些设备上跑、超时与并发怎么设。点「运行」后平台会生成 Job，再按设备拆成多个 Task。
Android 脚本里读 DEVICE_ID、ADB 在容器里怎么连宿主机，见 Android 自动化实践。
先想清楚三件事
- 脚本入口：Git 每次拉最新，还是上传固定压缩包？入口文件（如
runtest.sh/pytest）是否与环境镜像一致？ - 设备范围：固定几台机做回归，还是用「Android + 某最低版本」让平台自动挑空闲机？后者适合资源池，前者适合必现机型。
- 执行模式：每台机跑全量用例，还是把用例集拆到多机（Distribute）？见下表。
执行模式怎么选
| 模式 | 行为 | 典型用途 |
|---|---|---|
| Replicate | 每台被选中的设备都跑同一套完整用例 | 兼容性矩阵：同一脚本在 N 台不同机型各跑一遍 |
| Distribute | 用例集在多台设备间拆分执行 | 缩短总时长：大用例集并行分摊（需脚本/框架支持拆分） |
并行 / 串行、并发数 控制的是「同时占几台设备」，避免一次把机房里机器全占满。
脚本来源
绑定仓库 URL（GitHub / GitLab / Gitee 等），指定分支与目录。若开启「构建时自动同步」，每次运行前会拉最新提交；关则使用上次拉取快照，适合锁版本复现。
私有仓库需在项目集成里配置凭据，见 集成。
被测应用
- 选项目里已上传的包，或本页上传新版本。
- 安装后自动打开：适合依赖启动页的用例。
- 已安装同版本则跳过：缩短环境准备时间；若必须覆盖安装，关闭此项。
目标设备
- 指定列表：精确到
device_id，适合固定回归集。 - 过滤条件：按平台、厂商、系统版本等；运行时会从满足条件且空闲的设备中分配。过滤过宽可能导致 Task 跑到未预期的机型，上线前应用固定列表或收紧条件。
执行与超时
| 配置项 | 建议 |
|---|---|
| Job 超时 | 整次作业上限；多机并行时按「最慢那台」估算 |
| Task 超时 | 单机任务上限；单用例拖死会在这里被切断 |
| 环境变量 | 传入 API 地址、账号、开关等；不要覆盖平台注入的 DEVICE_ID 等（见 Android 实践文） |
通知
配置成功/失败通知到邮件或项目里绑定的渠道（如飞书）。用于无人值守跑完后的第一时间告警。
列表上的操作
运行 生成新 Job；复制 快速分叉变体；编辑 改配置后下次运行生效；删除 仅删套件不删历史报告。
接到流水线里
套件保存后，在控制台获取 API / CLI / GitHub Actions 等触发方式（具体入口以当前版本为准）。与 集成 中的代码托管、CI 说明一起用。