Armada测试体系揭秘:50+测试脚本与just check如何守护发行版质量
Armada测试体系揭秘:50+测试脚本与just check如何守护发行版质量
Armada 是一个类似 SteamOS 的 ARM 掌机 Linux 发行版,它为 Steam、FEX、Proton 和完整的桌面环境提供了开箱即用的 ARM64 体验。而支撑这份"开箱即用"的,正是它仓库中 tests/ 目录下 57 个测试脚本与一条 just check 命令。本文带你快速看懂 Armada 的测试体系是如何守护每一张可刷写镜像的质量的。
🎯 为什么一个发行版需要 50 多个测试脚本?
普通软件测试的是"功能对不对",而发行版测试的是整个系统装配得对不对。
Armada 由三层构成:
- 系统文件层:system_files/ 里的 systemd 服务、udev 规则、Armada Control 面板脚本
- 软件包层:packages/ 下对 mesa、gamescope、lepton、steam 等数十个上游组件的定制构建
- 镜像层:bootc 容器 + bootc-image-builder 生成的 raw/qcow2/iso 磁盘镜像
任何一层的"一个字符"错误(比如 systemd 单元名拼错、固件文件名少一个下划线)都可能导致掌机变砖。50 多个测试脚本就是为这些"拼命的细节"而存在的。
📂 测试都放在哪里?一份按模块分类的清单
所有测试集中在 tests/ 目录,命名统一为 <模块>-<功能>-test.<扩展名>,一眼就能看出它守护的是哪块地盘:
| 测试主题 | 代表脚本 | 守护内容 |
|---|---|---|
| 安装器 | installer-test.sh | 内部存储安装、GUID 分区、磁盘镜像生成 |
| 系统更新 | update-migration-test.sh | 镜像注册表/频道引用解析、OTA 升级 |
| 底屏(Flip 机型) | run-bottom-test.sh | 底部游戏屏的 gamescope 会话与触控映射 |
| 电源键/休眠 | powerbuttond-test.sh | 电源键守护进程、休眠钩子 |
| ABL 引导加载器 | abl-update-test.sh | 高通引导分区的备份/刷写安全策略 |
| Armada Store | armada-store-test.sh | 应用商店目录、安装器、Steam 快捷方式 |
| Decky 插件 | decky-sync-test.sh | 风扇/RGB/性能曲线面板同步 |
| 硬件输入 | input-calibration-test.sh | 摇杆校准、按键映射 |
| 发布流水线 | channel-image-publication-test.sh | stable/beta/preview 频道镜像发布与保留策略 |
其中 armada-* 系列有 13 个脚本,覆盖了 Armada 自家的几乎每个用户可见功能——Store、Control 面板、Steam 集成、系统工具 UI,每个功能都有一把"质量锁"。
⌨️ 一条命令的质量闸门:just check
Armada 的开发体验围绕 just 中:
just check # 运行完整测试套件 + 校验 just 配方格式
拆开来看,just check 实际做了两件事(见 Justfile):
- 遍历执行:把 tests/ 下所有
*-test.sh脚本按顺序逐个bash运行,任何一个失败立即中断(脚本内部启用了set -euo pipefail严格模式) - 格式校验:用
just --fmt --check检查所有*.just文件和 Justfile 本身是否格式化规范
💡 注意一个巧妙细节:Python、Node.js、Java 写的测试也能被这条 shell 流水线驱动,因为它们的
.sh入口脚本只是几行的"包装纸"。例如 installer-test.sh 全文 4 行,真正逻辑委托给 installer-test.py。
🧪 测试是如何"不碰真机"的?
Armada 硬件是掌机,CI 不可能人手一台。测试体系采用了三个通用技巧:
1. 用假文件冒充设备树和硬件
boot-hotkeys-test.sh 在临时目录里伪造 /dev/input/eventN 输入设备和 capabilities 位图,让启动热键脚本以为自己面对的是真实的掌机按键设备——完全不需要 systemd 和硬件。
2. 用 Python 生成"假固件"验证安全策略
abl-update-test.sh 生成 6 个不同标签的假 ABL 固件镜像(旧版本、新版本、错误 SoC、截断文件……),然后验证 abl/ 目录下的刷写脚本在每一种危险场景下都拒绝操作或正确降级。
3. Mock 外部命令,只测决策逻辑
Python 测试普遍用 unittest.mock.patch 拦截 subprocess.run 和真实命令。比如 armada-os-test.py 用一个内存中的"快照"模拟 bootc 系统状态,验证系统更新、回滚、频道切换的每一步决策,连网络都不用。
🌐 多语言测试矩阵:57 个脚本,4 种语言
tests/ 目录的构成反映了 Armada 组件本身的多样性:
- 39 个 Bash 脚本(
*.sh):主力军,测试 shell 写的系统组件 - 15 个 Python 脚本(
*.py):单元测试 + UI 渲染测试(如 armada-tools-ui-test.py 会真的初始化 GTK 并截图验证工具窗口) - 2 个 Node.js 脚本(
*.cjs):验证 decky/armada-store/ 的 TypeScript 前端逻辑 - 1 个 Java 脚本(aurora-search-test.java):校验 Google Play 搜索接口的设备特征伪造是否正确
每种语言对应它要测试的组件类型——Store 前端是 TS,就写 cjs 测试;Aurora 助手是 Java 库,就写 Java 测试。测试代码与目标代码"同源同语言",是这套体系最容易上手的约定。
🔍 代码风格也被纳入检查:lint 与 format
除了功能测试,Justfile 还提供两道静态检查:
just lint:对仓库里所有.sh文件(包括 57 个测试脚本自身)跑 shellcheckjust format:用 shfmt 统一 Shell 脚本缩进与风格
也就是说,测试脚本本身也是被"测试"的对象——质量闸门是自我引用的闭环。
🚀 普通用户和贡献者如何利用它?
- 想验证仓库完整性:clone 后执行
just check,全绿即说明你手上的代码处于健康状态(仓库地址:https://gitcode.com/gh_mirrors/armada5/armada) - 想给某个功能提 bug:先找到对应的
-test.sh文件,理解该功能的"正确行为"是如何被定义的,issue 描述会更精准 - 想提交补丁:
just check全绿是提交前的硬性自查——CI 跑的就是同一套脚本
小结
Armada 的测试体系可以概括为一句话:57 个脚本按功能模块分工,一条 just check 命令统一驱动,用模拟硬件和 Mock 命令让掌机发行版在普通机器上也能被完整验证。这正是开源发行版能给玩家"敢刷砖机也不怕"的信心来源。