用途:在多种设备配置下反复运行同一 Android 应用,找出崩溃、无响应或布局失效的配置单元(cell)。它同时回答两类问题:布局是否在 320dp 到 840dp、横屏、200% 字体、深色模式、刘海下保持可用;应用声明为可选的功能与权限缺失后是否仍能运行。
主要能力:通过 scripts/devmatrix.py 提供 profiles、plan、capabilities、run、restore、doctor 等子命令。run 会逐单元应用配置、冷启动应用、等待前台、按需旋转、回读验证、截图与快照、检测问题并撤销改动,存在硬失败时以非零退出。capabilities 把能力面分为可立即运行时测试、需自建 AVD(输出 config.ini 行)和已缺失三类。
使用方式:以 python3 "${CLAUDE_SKILL_DIR}/scripts/devmatrix.py" <cmd> 运行;例如 devmatrix.py run com.example.app --profile quick --out ./matrix。档案为 JSON,可先 devmatrix.py profiles --dump thorough > my-matrix.json 再编辑。单元键均可选,如 size、density、rotation、font_scale、night、cutout、deny(airplane、wifi、data、location、permission:<NAME>、appops:<OP>)。
限制:wm size/wm density 只重映射单台模拟器面板的逻辑尺寸,无法伪造未启用的刘海、真机宽高比、铰链或厂商皮肤,通过仅代表适配该矩形。硬件特性无法运行时移除,需真实 AVD 的单元只给出配方。文本截断不检测。依赖 adb 与 android-ui-driver;aapt2 可选但推荐,缺失时能力面报告 UNKNOWN。
适用场景:多尺寸与密度适配验证、深色模式与字体缩放检查、权限或无线电能力缺失的降级测试。
不适用:触摸目标与无标签控件(用 android-ux-audit)、完整书面评审(android-app-review)、启动与卡顿内存(android-app-profiling)、读取清单本身(android-apk-analysis)、网页响应式断点。
输出:<out>/report.json 为机器可读契约,<out>/cells/<id>.json 为每单元快照,<out>/cells/<id>.png 为截图,另含判定行与恢复日志。