# 快速入门

# 运行环境

安装 Node.js 并且版本大于 8.0
基础库版本为 2.7.3 及以上
开发者工具版本为 1.02.1907232 及以上

# 安装

使用小程序自动化 SDK，直接执行以下命令：

npm i miniprogram-automator --save-dev

# 使用

首先开启工具安全设置中的 CLI/HTTP 调用功能。

必须开启以上选项，否则 SDK 将无法正常启动工具自动化功能。

然后直接引入 SDK 开始编写控制脚本，参考下边例子：

const automator = require('miniprogram-automator')

automator.launch({
  cliPath: 'path/to/cli', // 工具 cli 位置，如果你没有更改过默认安装位置，可以忽略此项
  projectPath: 'path/to/project', // 项目文件地址
}).then(async miniProgram => {
  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()
})

最后执行 node path/to/script 即可看到输出结果。

关于 SDK 提供的接口，更多详细用法可以参阅 Automator、MiniProgram、Page、Element。