Flutter自动化命令行工具插件auto_cli的使用

Auto Cli 是一个可以回放 Auto 文件并输出测试报告的命令行工具，同时可以与自动化系统（如 Jenkins）集成。

安装

1. 安装 Auto Cli

$ dart pub global activate auto_cli   #(需要 Dart SDK，版本 >= 2.12.0-0)

或者

从 Releases 页面 下载。

2. 安装 Auto Util

详见 Auto Util。

使用

运行以下命令查看帮助信息：

$ auto_cli --help

输出如下：

exitCode: 0(OK) 2(ERROR)
-a, --auto=<test/test.auto>                     Auto 文件路径
-o, --out=<test/test.autor>                     输出文件路径
-h, --host=<127.0.0.1>                          主机地址
-p, --port=<7001>                               端口号
                                                (默认值为 "7001")
    --android-package=<com.example.auto>        Android 包名
    --[no-]android-restart                      播放前重启应用（需要 ADB）
    --android-serialno=<emulator-5554>            使用指定序列号的设备
-f, --[no-]force                                强制开始播放
-t, --threshold=<0.8>                           图像匹配阈值
                                                (默认值为 "0.8")

示例 Demo

以下是一个完整的示例，展示如何使用 auto_cli 工具。

步骤 1: 创建 Auto 文件

创建一个名为 example.auto 的文件，内容如下：

# example.auto
tap(x: 100, y: 200) # 点击坐标 (100, 200)
sleep(seconds: 2)   # 等待 2 秒
type(text: "Hello World") # 输入文本 "Hello World"

步骤 2: 运行 Auto Cli

运行以下命令来播放 example.auto 文件，并将结果保存到 output.autor 文件中：

$ auto_cli --auto=example.auto --out=output.autor --host=127.0.0.1 --port=7001

参数说明：

• --auto=example.auto: 指定要播放的 Auto 文件。
• --out=output.autor: 指定输出文件路径。
• --host=127.0.0.1: 指定主机地址。
• --port=7001: 指定端口号。

示例代码解释：

tap(x: 100, y: 200) # 点击屏幕上的坐标 (100, 200)
sleep(seconds: 2)   # 等待 2 秒钟
type(text: "Hello World") # 在当前焦点输入框中输入 "Hello World"

步骤 3: 查看输出结果

运行完成后，output.autor 文件会包含测试结果。例如：

{
  "status": "success",
  "steps": [
    {
      "action": "tap",
      "x": 100,
      "y": 200,
      "result": "success"
    },
    {
      "action": "sleep",
      "seconds": 2,
      "result": "success"
    },
    {
      "action": "type",
      "text": "Hello World",
      "result": "success"
    }
  ]
}