SuperAPI AI 工具集

orca-emulator-android

测试与质量

查看项目

更新于 10-15 23:33

技能介绍

用途:在 Orca 应用内驱动通过 adb 连接的 Android 模拟器或设备,覆盖列出/启动 AVD、点击、滑动、输入文字、硬件按键(含返回与最近任务)、旋转、应用安装与启动、运行时权限、无障碍树以及 logcat。跨平台支持 Windows、Linux、macOS,并与 orca-emulator(iOS)和 orca-cli 技能互补。

使用方式:先为当前会话确定可执行文件并全程复用。若设置了环境变量 ORCA_CLI_COMMAND,使用其值(Orca 会为受管 WSL 会话导出);否则在暴露 ORCA_DEV_REPO_ROOT 的开发检出中使用 orca-dev;否则在非 Orca 管理的 Linux 终端使用 orca-ide,切勿在 Orca 终端之外直接运行裸 orca,因为那里通常解析为 GNOME Orca 屏幕阅读器(/usr/bin/orca)并启动语音;其余情况使用 orca。下文 ORCA 为占位符,运行前需替换,不要创建 shell 变量或直接运行 ORCA 字面量。若所选可执行文件无法运行,报告其确切错误并停止,不要回退到其他可执行文件。

运行命令前先加载完整指南:ORCA skills get orca-emulator-android,它会打印与将处理后续命令的确切二进制版本匹配的完整指南。不要凭记忆或缓存的旧副本猜测子命令与参数,它们会随 Orca 版本变化。可用 ORCA status --json 确认应用已启动(必要时用 ORCA open --json 启动),面向智能体的调用优先使用 --json。

若旧版 Orca 不识别 skills get:仅当所选二进制明确报告 skills get 为未知命令时使用回退方案,其他失败不能证明是旧版,应报告而非猜测或更换可执行文件。对确认的旧版二进制,仅使用以下有界只读引导:ORCA status --json 与 ORCA emulator devices --json,然后告知用户更新 Orca 即可通过 ORCA skills get orca-emulator-android 恢复完整指南;除此之外应询问用户,不要猜测该旧版可能不支持的命令面。

限制:本文件仅为发现存根,不是使用指南;完整且版本匹配的参考由 orca 二进制自身提供,以避免与将实际运行命令的二进制产生偏差。