uni-automator是uni-app官方推荐的App端自动化测试方案，必须配合真机或模拟器通过WebSocket通信执行，Jest无法替代；需使用自定义基座、正确平台标识和上下文切换，nvue页面有特殊选择器与数据规则。
App端自动化测试在uni-app里不是“能不能做”，而是“必须用uni-automator + 真机/模拟器通信方式来做”——Jest单独跑test文件根本测不到App渲染层和原生能力。
uni-automator必须配合真机或模拟器启动
uni-automator底层依赖WebSocket连接App运行时环境，program.reLaunch()、page.$()这些API实际是向已启动的App进程发指令。本地Jest环境里直接require页面组件，测的只是Vue逻辑，不触发onLoad、拿不到plus.navigator、也查不到uni.getSystemInfoSync()返回值。
- Android需先制作并安装自定义基座（标准基座禁用调试通道）
- iOS仅支持模拟器（真机需额外签名+profile，且
UNI_PLATFORM=app-ios才生效） - 启动命令必须带平台标识：
UNI_PLATFORM=app-android npm run test，否则program对象为空 - 首次运行失败常见报错：
Error: connect ECONNREFUSED 127.0.0.1:9999→ 检查App是否已启动、是否弹出“允许USB调试”提示（Android）、模拟器是否已选中（iOS）
page.$()选择器失效的三个高频原因
page.$()查不到元素，90%不是选择器写错，而是时机或上下文不对。
- 没等页面真正挂载：不能只靠
await page.waitFor(3000)，应改用await page.waitFor('view')或await page.waitFor(() => page.data('loaded') === true) - nvue页面不支持CSS类选择器：nvue里
page.$('.title')永远返回null，必须用page.$('title')（标签名）或page.$('[data-testid="my-title"]')（属性选择器） - 页面跳转后未切换上下文：从A页
reLaunch到B页，page引用仍指向A页实例，需重新调用await program.currentPage()
Android真机调试时console.log不输出的硬性条件
HBuilderX控制台不显示日志，不是配置问题，是物理链路没通。
- 手机USB模式必须设为“文件传输”（MTP），设成“仅充电”或“MIDI”会导致ADB静默失败
- 开发者选项里“USB调试”和“USB调试（安全设置）”两个开关都要打开（HarmonyOS/MIUI常默认关后者）
- 自定义基座未安装成功：检查HBuilderX控制台是否有
INSTALL_SUCCESS，没有就说明APK没推过去 - 代码里没启用WebView调试：
plus.webview.getCurrentWebview().setStyle({ debug: true })这行必须执行，否则chrome://inspect看不到任何内容
test文件里调用uni API返回undefined
测试环境里uni.showToast、uni.downloadFile这类API不是被mock掉，而是根本没注入。
- uni-automator测试中，所有
uni.xxx调用实际由App进程代理执行，但前提是测试脚本通过program启动了对应页面 - 直接在
.test.js里import { uni } from '@dcloudio/uni-app'没用，该模块在测试环境里不绑定真实实现 - 正确做法：用
page.callMethod('downloadImage')触发页面内已定义的方法，再通过page.data('jest_result')读取结果 - 若要测原生能力（如蓝牙、地图），必须确保自定义基座已集成对应原生插件，且
uni.getProvider({service: 'bluetooth'})返回非空数组
最易被忽略的是nvue页面的测试隔离性：nvue不走Vue编译流程，data()返回的是JSON而非响应式对象，断言时别用toEqual深比较整个data，优先查单个字段如page.data('list').length。另外，iOS模拟器对page.screenshot()支持不稳定，截图为空白图时别急着改代码，先换Android真机跑一遍确认是不是平台限制。
