title: 拉起安卓实例 description: 按筛选条件或精确定位启动一个安卓实例，输出 android: 完整实例信息与类型、编号、名称、路径、分辨率等字段。

拉起安卓实例¶

用途¶

此节点用于启动一个本地安卓实例，等待它就绪后输出完整实例信息。它适合自动化入口；如果目标已经运行且只需发现它，使用查找运行中安卓实例更直接。

节点原名「拉起ADB安卓实例」；ADB 只是控制安卓实例的一种方式，大部分链路走高速截图与自有触控。

自有实例应先在组件页安装相应运行组件并创建实例；第三方实例需已在本机安装和配置。定位语法可识别某个类型，不代表对应组件已经安装或该版本已可用。

Shift+A → 自动化 → 拉起安卓实例

定位是一个字符串，字符串变量可以直接喂；连接值非空时覆盖节点属性。完整规则见目标描述：

android:gc9 / gc14 / ld9 / ld14 / mumu12 / mumu15：按类型（也认中文类型名，如 幽点安卓9）。
android:gc9#1、android:type=gc9,number=1：指定同类型的第几个。
android:name=名称、android:id=实例ID：继续收窄或精确定位。
android:path=实例路径：按实例目录，类型自动识别。
留空：依次尝试幽点安卓9 第一编号、幽点安卓14 第一编号，都没有则拉起失败。

多条件命中多个实例时按编号升序拉第一个。不符合目标描述语法的定位会报错，提示“目标描述格式不符合规范。”；请使用上面的标准写法。

执行到节点时，非空的连接值优先于节点属性。节点解析定位、启动或复用实例，并在同一超时期限内等待就绪。成功时输出 成功 = true；没有匹配实例、普通启动失败或就绪超时输出 false，两种结果都沿执行输出继续。可把“成功”接到分支，决定重试、跳过或结束流程。

格式错误、任务取消及资源清理失败仍按错误处理。

启动时显示只影响由本节点新启动的实例，已经运行的实例保持原窗口状态。

端口	类型	必填	说明
执行输入	执行	是	开始启动和就绪等待。
实例定位	字符串	否	上述定位写法；连接值非空时覆盖属性，留空按默认顺序查找。

端口	类型	说明
执行输出	执行	成功或普通失败后继续。
实例信息（索引 1，`adb_address`）	字符串	完整 `android:` 目标描述（`android:type=gc9,id=...,name=...,adb=...,route=...,status=ok`），可直接连截图、宏、目标点击与实例控制节点。
设备目标	捕获目标	可供支持捕获目标的后续节点使用。
实例 ID	字符串	解析后的稳定实例标识。
类型	字符串	`gc9`、`ld14` 等类型别名。
编号	数值	实例在同类型中的编号。
名称	字符串	实例显示名。
实例路径	字符串	实例目录。
分辨率	字符串	实例画面分辨率。
路由地址	字符串	实际连接地址（自有实例为 `ghostclick-instance:<实例ID>`，第三方/手动连接为 `127.0.0.1:5555`、`emulator-5554` 等 adb 地址）。
成功	布尔	是否已成功启动并确认就绪。

失败时部分输出仍可能包含定位或实例信息；后续截图、输入等操作应先判断“成功”。

属性	默认值	说明
模拟器	自动识别	根据实例定位判断运行环境；同时安装多种环境时建议明确选择。
实例定位	空	上述定位写法；留空按幽点安卓9 → 幽点安卓14 优先级。
超时	120 秒	包含实例启动与就绪等待的总期限。
启动时显示	开启	关闭时使用对应运行环境提供的原生隐藏能力。

开始 → 拉起安卓实例 → 普通查询节点

在节点中填写实例定位，执行后把 实例信息直接连接到后续节点。截图、输入、宏和实例控制读取同一份信息中的所需字段，不要手动提取或替换成裸 ADB 地址。若后续是高频触摸或持续视觉节点，需要满足该节点执行前准备资源的条件，可使用“查找运行中安卓实例”的直接输出。

实例信息的完整字段与回喂规则见目标描述，控制操作见安卓实例与窗口控制。