拉起ADB安卓实例¶
用途¶
此节点用于启动一个明确指定的本地 Android 实例，并等待它的 ADB 地址可连接。它适合自动化入口；如果目标已经运行且只需发现地址，使用查找运行中ADB安卓实例更直接。
添加路径¶
Shift+A → 自动化 → 拉起ADB安卓实例
执行行为¶
执行到节点时，已连接的 实例定位 优先于节点属性。节点根据所选类型解析实例，启动或复用该实例，并在同一超时期限内等待 ADB 精确地址就绪。成功后才写出三个数据输出并继续；定位无效、启动失败或超时会终止当前路线。
启动时显示只影响由本节点新启动的实例，已经运行的实例保持原窗口状态。
输入端口¶
| 端口 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 执行输入 | 执行 | 是 | 开始启动和就绪等待。 |
| 实例定位 | 字符串 | 是 | 稳定实例 ID 或实例目录；连接值非空时覆盖属性。 |
输出端口¶
| 端口 | 类型 | 说明 |
|---|---|---|
| 执行输出 | 执行 | 实例与 ADB 均就绪后继续。 |
实例信息（索引 1，adb_address） | 字符串 | android: 前缀加完整 JSON，包含稳定实例身份与 ADB/捕获连接信息。消费 API 自动读取所需字段。 |
| 设备目标 | 捕获目标 | 可供支持捕获目标的后续节点使用。 |
| 实例 ID | 字符串 | 解析后的稳定实例标识。 |
属性¶
| 属性 | 默认值 | 说明 |
|---|---|---|
| 类型 | 自动识别 | 根据实例定位判断运行环境；同时安装多种环境时建议明确选择。 |
| 实例定位 | 空 | 实例 ID、实例目录，或运行环境支持的“安装目录 + 实例序号”表示。 |
| 超时 | 120 秒 | 包含实例启动与 ADB 就绪等待的总期限。 |
| 启动时显示 | 开启 | 关闭时使用对应运行环境提供的原生隐藏能力。 |
最小示例¶
开始 → 拉起ADB安卓实例 → 普通查询节点
在节点中填写稳定实例定位，执行后把 实例信息直接连接到后续节点。截图、输入、宏和实例控制读取同一份信息中的所需字段，不要手动提取或替换成裸 ADB 地址。若后续是高频触摸或持续视觉节点，需要满足该节点执行前准备资源的条件，可使用“查找运行中ADB安卓实例”的直接输出。
2026-09-09 开发候选保留数据端口 ID adb_address，显示名称改为“实例信息”；capture_target（索引 2）和 instance_id（索引 3）继续存在，避免破坏已有蓝图。输出 JSON 的字段包括 kind、version、provider、instanceId、adbAddress，以及按实际实例提供的 instanceName、instancePath、captureTargetId、status、androidVersion、externalIdentity。使用节点真实输出，不自行伪造身份字段。完整信息的规则见截图，控制操作见安卓实例与窗口控制。
常见错误¶
- 把 ADB 程序路径当作实例定位：程序路径不能指出要启动哪一个实例；应填写实例 ID 或实例目录。
- 自动识别选错环境：同时安装多种运行环境时，在“类型”中明确选择。
- 超时后才看到窗口出现：启动与 ADB 就绪共用同一个超时，冷启动时需要增加数值。
- 关闭“启动时显示”却仍看到窗口：该选项不改变已经运行实例的当前窗口状态。