Mobilerun Portal：安卓自动化服务

项目简介

Mobilerun Portal 是 Mobilerun 框架的 Android 端配套应用，以无障碍服务形式运行，为屏幕上的 UI 元素提供实时可视化反馈与数据采集。它会创建交互式覆盖层，高亮可点击、可勾选、可编辑、可滚动和可聚焦的元素，可用于 UI 测试、自动化开发和无障碍评估。

主要功能

• 交互式覆盖层，标记可操作元素
• 本地控制 API：HTTP socket 服务（默认 8080）、WebSocket JSON-RPC（默认 8081）与 ContentProvider（ADB 命令）
• 反向 WebSocket 连接，用于云端控制
• WebRTC 屏幕串流，支持自动接受
• 从 URL 安装 APK（包括 split APK），可选自动接受
• 通知事件流，可按事件开关
• 本地无无障碍模式，可在不启用 AccessibilityService 时运行本地服务器（部分需要无障碍的接口仍会失败）

安装与使用

1. 在 Android 设备上安装应用。
2. 打开系统设置 → 无障碍 → Mobilerun Portal，启用无障碍服务。
3. 按提示授予悬浮窗权限。
4. 可选：在应用 Settings 中启用本地服务器或反向连接。

本地 HTTP 与 WebSocket 访问需要认证 token，可在应用主界面复制，或通过 ADB 查询：
adb shell content query --uri content://com.mobilerun.portal/auth_token

若要让本地服务器在后台保持可达，可在 Settings → Permissions 中开启 Unrestricted Battery，或执行：
adb shell dumpsys deviceidle whitelist +com.mobilerun.portal

更多接口说明见 Local API、Reverse Connection 和 Triggers and Events。

注意事项

• 截图、UI 树提取、手势与覆盖层操作依赖 AccessibilityService。
• 本地无无障碍模式只适用于不需要无障碍能力的接口。
• 文件操作（files/*）要求 Android 11+；Android 8 属于兼容层级，核心控制、截图和反向串流支持 API 26+。
• 反向连接保存的凭据可在重启后继续使用；如需重启或应用更新后自动重连，需在 Settings > Reconnect After Restart 中开启（默认关闭）。

本作品整理自 GitHub 开源项目 droidrun/mobilerun-portal，原作者 @droidrun。中文介绍由 AI 根据项目 README 整理，以原仓库为准。