# 真机自动化

小程序自动化除了能够控制开发者工具中的小程序模拟器,也支持通过远程调试控制真机,以达到在真机上进行自动化测试的目的。

# 运行环境

  • 确保目标机器上的基础库版本为 2.7.3 及以上

# 使用方式

在编写完测试用例并且在工具模拟器上测试成功之后,假如想要在真机上跑自动化,可以通过以下两种方法实现。

# 通过 SDK 启动

你可以在测试脚本开头使用 miniProgram.remote 接口启动工具的真机调试功能,调用成功后脚本会在控制台打印二维码。使用目标机器扫码成功连接后,脚本会继续在真机上执行下去。

脚本示例:

const automator = require('miniprogram-automator')

const miniProgram = automator.launch({
  cliPath: 'path/to/cli', 
  projectPath: 'path/to/project',
}).then(async miniProgram => {
  await miniProgram.remote() // 扫码登录连接真机,在真机上执行后续测试脚本

  const page = await miniProgram.reLaunch('/page/component/index')
  await page.waitFor(500)
  const element = await page.$('.kind-list-item-hd')
  console.log(await element.attribute('class'))
  await element.tap()

  await miniProgram.close()
})

# 手工启动

如果工具是打开常驻并且使用 automator.connect 接口进行连接,那么可以先手工启用工具的真机调试功能后再运行测试脚本,这样就可以将在真机上测试小程序了。