# 快速入门

## 运行环境

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

## 安装

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

```bash
npm i miniprogram-automator --save-dev
```

## 使用

首先开启工具安全设置中的 [CLI](/miniprogram/dev/devtools/cli)/[HTTP](/miniprogram/dev/devtools/http) 调用功能。

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

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

```javascript
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](automator)、[MiniProgram](miniprogram)、[Page](page)、[Element](element)。