安装与快速开始

1准备工作

• 一台 iPhone，以及一根可以传输数据的数据线。
• 一台 Windows 10 或 Windows 11 电脑，用来运行设备管理工具。
• 云点iOS 控制台账号。
• 安装包：Windows 设备管理工具，以及 WebDriverAgent 和云点iOS App 的 IPA 安装包，在下方直接下载。
• 签名证书：每台设备一份 .p12 证书和对应的 .mobileprovision 描述文件。已越狱并装有 AppSync Unified 的设备可以免签名安装，不需要证书。

描述文件里要包含设备的 UDID。还没有证书的话，先完成下一步导出 UDID，再用它申请证书。

2连接设备，导出 UDID

1. 1

   打开设备管理工具

   解压下载的 ios-manager 压缩包，双击运行里面的 ios-manager.exe。

2. 2

   连接并信任电脑

   用数据线连接 iPhone。手机上弹出「要信任此电脑吗？」时点「信任」，并输入锁屏密码。

3. 3

   刷新设备列表

   在工具里点「刷新设备」，设备会出现在列表中，显示设备名、UDID 和系统版本。

4. 4

   复制或导出 UDID

   点设备卡片上的 UDID 可以一键复制；设备较多时，用「导出UDID」把所有已连接设备的 UDID 保存成一个 .txt 文件。

3配置签名方式

在工具里点「签名设置」，二选一：

• 证书签名：选择证书目录。目录下每台设备一个文件夹，文件夹名就是设备的 UDID，里面放 .p12 证书、.mobileprovision 描述文件，证书有密码时再放一个写着密码的 .txt 文件（文件名不限，如「密码.txt」「password.txt」）。
• 越狱设备免签名：设备已越狱并装有 AppSync Unified 时选这一项，直接安装原始 IPA，不需要证书。

证书目录/
├── 00008110-001A2B3C4D5E6F7A/     ← 以设备 UDID 命名
│   ├── xxx.p12                     ← 证书
│   ├── xxx.mobileprovision         ← 描述文件
│   └── 密码.txt                    ← 证书密码（任意 .txt，文件名不限）
└── 00008030-000B1C2D3E4F5A6B/
    └── …

设置会保存在工具目录下的 settings.json 里，下次打开不用重新选择。

4安装 WebDriverAgent 和 App

1. 1

   选择安装包

   点「选择IPA」，选中下载好的 WebDriverAgent.ipa。

2. 2

   签名并安装

   在设备卡片上点「安装IPA」。多台设备可以点「全部安装」，工具会依次为每台设备签名并安装，进度显示在底部状态栏。

3. 3

   再装一次 App

   用同样的方法安装云点iOS App 的安装包（CloudClick iOS-版本号.ipa）。

提示「未找到设备的证书」时，检查证书目录里的文件夹名是否与这台设备的 UDID 完全一致。

5开启开发者模式并激活

1. 1

   开启开发者模式（iOS 16 及以上）

   在 iPhone 上打开「设置 → 隐私与安全性 → 开发者模式」，打开开关，按提示重启手机，重启后在弹窗中确认开启。

2. 2

   激活设备

   保持手机解锁，回到设备管理工具，在设备卡片上点「立即激活」，多台设备可以点「全部激活」。工具会自动挂载开发者磁盘映像并启动 WebDriverAgent，状态变为「已激活」即完成。

激活前必须先装好 WebDriverAgent，否则会提示「该设备未安装WDA，无法激活」。

6在 App 中登录

1. 1

   允许定位权限

   在 iPhone 上打开云点iOS App，按提示允许定位。App 靠后台定位保持运行，建议选择「始终允许」。

2. 2

   接入官方服务器

   进入「设置」页，连接方式选「官方服务器」，点「点击接入官方服务器」。

3. 3

   输入账号口令

   填写控制台的账号和口令，点「接入」。账号口令只用来换取本机的接入密钥，不会保存在手机上。

4. 4

   确认连接状态

   回到「状态」页，服务器连接显示「已连接」、WDA 状态显示「运行中」，就说明接入成功了。

7在控制台确认设备

打开控制台 https://developer.wtscript.com，设备列表里出现这台设备并显示在线，就可以开始投屏和运行脚本了。

手机重启后，如果控制台显示 WDA 未连接，用数据线连上电脑，在设备管理工具里重新激活一次即可。