Skip to main content

环境准备

安装 AScript 后，首次打开 App 会弹出模式选择弹窗。请根据选择的模式准备对应环境。

不确定选哪个？

查看 模式选择 了解两种模式的区别和推荐建议。

WDA 模式（经典方案）​

WDA 模式需要安装 WDA 框架并激活，共 2 步。

步骤 1：安装 WDA 框架​

  1. 手机浏览器 扫描二维码 安装 AScript-WDA

  2. 信任企业开发者

    设置 -> 通用 -> VPN与设备管理 点击 企业级APP中的不可信选项，点击信任

  3. 安装完成后不要直接打开，需要先激活（见下一步）

来自静态目录的图像

步骤 2：激活 WDA 框架​

激活须知
  1. 可激活 iOS 14.6+ 的所有设备
  2. 激活后可拔出 USB
  3. 关机后失效，需重新激活

使用 Windows 电脑激活​

  1. 电脑下载安装激活工具，点击激活，等待提示成功
  2. 点击手机上的 AScript-WDA。如果闪退，再次点击，重复直到出现 XCTest 页面，输入锁屏密码即可
  3. 屏幕上出现 Automation Running 则表示激活成功

iOS 需开启开发者模式：

开启开发者模式

使用激活工具：

激活工具

激活成功：

手动点击手机上的 AScript-WDA，出现 Automation Running

激活成功

使用 Mac 电脑激活​

  1. 设备 USB 连接电脑
  2. Mac 在 App Store 中搜索并安装 Xcode
  3. 开启 iPhone 的开发者模式（设置 > 隐私与安全性 > 开发者模式）
  4. 打开 Xcode，停留在欢迎页面（等待约 30 秒）
  5. 点击手机上的 AScript-WDA。如果闪退，再次点击，重复直到出现 XCTest 页面，输入锁屏密码即可
  6. 屏幕上出现 Automation Running 则表示激活成功。激活后可拔出 USB，关机后需重新激活

Xcode 示例

设备连接

开发者模式

激活成功

HID 模式（硬件方案）​

HID 模式无需安装 WDA、无需开发者模式，但需要准备 ESP32 硬件。

步骤 1：购买 ESP32 芯片​

前往 HID 外设 - 芯片选购 查看支持的芯片型号和购买方式。

推荐型号：

  • ESP32-C3（约 9 元）- 性价比最高
  • ESP32-S3（约 20 元）- 同时支持蓝牙和 USB

步骤 2：下载固件并烧录​

前往 HID 外设 - 开始使用 页面：

  1. 下载 ESP32 固件包
  2. 按照烧录教程将固件刷入芯片
  3. 烧录成功后手机蓝牙搜索到 AS_ 开头的设备即可

步骤 3：首次授权录屏​

HID 模式使用系统录屏（Broadcast Extension）进行截图，首次使用时：

  1. 打开 AScript，运行脚本
  2. 系统会弹出录屏授权请求，点击允许
  3. 授权一次后续无需重复操作
准备完成

环境准备好后，回到 AScript 首页选择对应模式，即可开始编写脚本。 两种模式的 API 调用方式基本一致，后续可随时在首页切换。