#开始使用：Android · Midscene Test · ChatGPT 订阅

本页是在 Android 上使用 Midscene Test、通过 ChatGPT 订阅接入模型的配置步骤。如需其他组合，请修改下方的选择，或查看全部配置路径。

第 1 步

#安装 Node.js

安装 Node.js ^20.19.0 || ^22.12.0 || >=24.0.0，并确认终端中可以执行 node -v。

下文命令使用 pnpm。如果尚未安装，请运行 npm install -g pnpm。

第 2 步

#连接 Android 设备

运行 Midscene 的电脑需要通过 adb 连接目标 Android 设备，支持 USB 和无线 adb 两种连接方式。如果已安装 adb 并连接好设备，可直接跳至确认设备连接。

#安装 adb

• 通过 Android Studio 或独立的 Android 命令行工具安装 adb。
• 在终端运行以下命令，验证 adb 是否安装成功：

adb --version

输出类似以下内容即表示安装成功：

Android Debug Bridge version 1.0.41
Version 34.0.4-10411341
Installed as /usr/local/bin/adb
Running on Darwin 24.3.0 (arm64)

• 参考 Android 环境变量文档配置 ANDROID_HOME 环境变量，并检查是否生效：

echo $ANDROID_HOME

输出应指向本机安装的 Android SDK 目录，例如：

/Users/your_username/Library/Android/sdk

#开启调试并连接设备

以下以 USB 连接为例；如果设备已通过无线 adb 连接，可继续使用现有连接。

1. 在手机系统设置的「开发者选项」中开启 USB 调试（若同时存在 USB 调试（安全设置），请一并开启，以确保支持触控事件注入）。
2. 使用支持数据传输的 USB 数据线将手机连接到电脑。
3. 保持手机解锁亮屏，在手机弹出的授权窗口中勾选并允许 USB 调试。

#确认设备连接

在终端运行以下命令检查连接状态：

adb devices -l

输出中设备状态显示为 device 即表示连接就绪：

List of devices attached
s4ey59	device usb:34603008X product:cezanne model:M2006J device:cezan transport_id:3

如果同时连接了多台设备，请记录目标设备所在行第一列的设备 ID（如上例中的 s4ey59），以便后续在 Playground 或项目配置中指定该设备。

若未显示目标设备或状态不是 device，请按以下情况排查：

• 列表为空：USB 连接请检查数据线（需支持数据传输）、USB 连接模式和 USB 调试开关；无线连接请检查网络及 adb connect 连接状态。
• unauthorized：请解锁手机屏幕，在手机弹出的授权窗口中勾选并允许 USB 调试。
• offline：请重新建立 USB 或无线 adb 连接，必要时重启 adb 服务。请确认设备状态变为 device 后再继续后续步骤。

第 3 步

#创建测试项目

pnpm dlx @midscene/test create my-tests \
  --platform android \
  --package-manager pnpm
cd my-tests

该命令会生成项目文件、安装依赖并生成 Node 说明书，不会运行测试。生成的文件说明请参阅项目结构。

第 4 步

#使用 ChatGPT 订阅登录

首先，在终端运行：

pnpm dlx @midscene/cli model siwc login

按照终端提示，在浏览器中登录 ChatGPT 并授权使用订阅额度。授权时可以自行设置 Agent 名称；完成后，可在 ChatGPT 的使用情况页面查看已授权的 Agent。

命令会将凭据保存到 ~/.midscene/siwc.json。首次使用前需要手动完成这一步登录。

然后在 my-tests 目录中，将 .env.example 复制为 .env：

cp .env.example .env

MIDSCENE_MODEL_BASE_URL 和 MIDSCENE_MODEL_API_KEY 留空。设置 MIDSCENE_MODEL_NAME 和 MIDSCENE_MODEL_FAMILY，并添加 MIDSCENE_MODEL_AUTH_MODE：

MIDSCENE_MODEL_AUTH_MODE="siwc"
MIDSCENE_MODEL_NAME="gpt-6-sol"
MIDSCENE_MODEL_FAMILY="gpt-6"

可用模型以你的 ChatGPT 账号为准。凭据与额度说明请参阅使用 ChatGPT 订阅。

第 5 步

#验证模型并完成配置

运行以下命令，检查模型能否连通、是否与 Midscene 兼容。该命令只读取当前目录下的 .env，不需要浏览器或设备：

pnpm exec midscene-test model verify

如果验证失败，请参阅验证模型连接。

如果连接了多台设备，请在 .env 中将 ANDROID_DEVICE_ID 设置为 adb devices -l 输出中的设备 ID。

第 6 步

#运行示例并查看报告

示例会在设备浏览器中打开 React TodoMVC，并先检查列表为空。请保持设备解锁。如果列表中留有之前运行产生的待办事项，请切换到 All 并删除全部事项（包括已完成的事项）。

pnpm test

终端会输出测试结果和 Report: 报告路径。打开 HTML 报告，选择用例和步骤即可查看截图、输入输出和错误信息。报告默认保存在 midscene_run/report/ 目录下。

用例通过即表示模型、运行环境和项目都已正常工作。运行参数请参阅运行测试。

第 7 步

#下一步

• 查看更多案例：案例展示收录了各平台的演示视频和完整执行报告。

• 测试自己的应用：在 cases/todo.yaml 中，将 beforeEach 里的 TodoMVC 初始化步骤替换为打开应用的 launch Node：

  beforeEach:
    - launch: com.example.app
  
  cases:
    - name: 打开首页
      steps:
        - aiAssert: 应用首页已显示

  Android 使用包名，iOS 使用 Bundle ID，HarmonyOS 使用 bundle name。其他系统操作请参阅各平台预置 Node。

• 编写和组织用例：编写 YAML 用例介绍了输入、变量、标签和 hooks。
• 在 CI 中运行：请参阅在 GitHub Actions 中运行。

想尝试其他平台或使用方式？回到顶部修改选择。