Armada测试体系揭秘:50+测试脚本与just check如何守护发行版质量

原创2026-10-10 13:44:562,256 阅读

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):

  1. 遍历执行:把 tests/ 下所有 *-test.sh 脚本按顺序逐个 bash 运行,任何一个失败立即中断(脚本内部启用了 set -euo pipefail 严格模式)
  2. 格式校验:用 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 个测试脚本自身)跑 shellcheck
  • just 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 命令让掌机发行版在普通机器上也能被完整验证。这正是开源发行版能给玩家"敢刷砖机也不怕"的信心来源。

登录后查看全文
armada