在 VS Code 中一键启用移动端开发环境。
不再手工配置 SDK、NDK、JDK、设备桥接、模拟器和环境变量。
快速开始 · 为什么选择 Mob · AI 与自动化接口 · VS Code 扩展 · 参与贡献 · 产品规范 · 手动验证
移动端项目不该因为换了一台电脑、换了一个 SDK 版本或换了一个平台，就重新经历 IDE 安装、工具链下载、环境变量配置和设备连接。Mob 的目标是让开发者在 VS Code 中使用一个 CLI 或一个插件，完成 Android、iOS 与 HarmonyOS 的环境准备、设备管理、构建、运行和调试。
你不需要记住 SDK 在哪里、哪个 JDK 能构建、如何创建匹配 API 的模拟器，或如何把 AI 生成的代码真正运行到设备上。打开项目后，点击 Run 或执行：
mob run --accept-licensesMob 读取项目已有配置，准备匹配的官方工具链，选择真机或模拟器，并调用项目原本的构建器。它不创建私有项目格式，不替代 Gradle、Flutter/FVM、Xcode 或 DevEco。
Android 是当前完整交付的平台。 iOS 与 HarmonyOS 正在按各自官方工具链接入。Android Studio 仍可用于布局编辑、Profiler 等高级功能，但不再是 Android 日常环境配置与运行项目的前置。未来 iOS 与 HarmonyOS 仍将遵循 Xcode、DevEco、账号、签名和宿主系统的官方要求。
| 常见问题 | Mob 的处理方式 |
|---|---|
| 新电脑上没有 SDK、ADB、JDK 或模拟器 | 从官方目录按需准备缺失组件，并在许可确认后继续工作流。 |
| VS Code 需要手动设置 SDK 路径、PATH 与环境变量 | CLI 与扩展共用 Mob 管理的工具链；构建时只向子进程注入环境。 |
| 一个项目用 API 27，另一个项目用 API 35 或不同 NDK/JDK | 从当前项目的 Gradle 配置推导需求，按项目选择工具链。 |
| Android、iOS、HarmonyOS 的工具与设备入口彼此割裂 | 使用统一的平台命名空间、设备模型和工作流；平台适配按官方能力逐步交付。 |
| AI 编程工具只能猜测本机环境和命令结果 | 使用稳定的 --json、--json=events、错误码和 UI 自动化命令。 |
Mob 不会创建 mob.yaml，不会改写 build.gradle、Flutter 配置或 .fvmrc，也不会永久设置 JAVA_HOME、ANDROID_HOME、ANDROID_SDK_ROOT。它管理自己的目录，默认位于 ~/.mob。
| 平台 | 状态 | 当前能力 |
|---|---|---|
| Android | 已交付 | SDK、NDK、JDK、ADB、Emulator、真机、Flutter/FVM、构建、运行、调试、测试、日志、发布构建与 VS Code 设备预览。 |
| iOS | 正在接入 | 统一命令和设备协议已预留；将基于 macOS、Xcode、Simulator 与 Apple 官方服务逐项实现。 |
| HarmonyOS | 正在接入 | 统一命令和设备协议已预留；将基于 DevEco、HarmonyOS SDK 与 HDC 官方能力逐项实现。 |
现在就可以用 Mob 在 VS Code 中完成 Android 开发；后续平台不会复用 Android 工具链或绕过 Xcode、DevEco、账号、签名和宿主系统的官方要求。
安装脚本下载并校验对应宿主机的 Release 二进制，不要求先安装 Go。默认安装到 ~/.mob/bin，并将该目录加入当前用户的 PATH。
irm https://raw.githubusercontent.com/xy200303/MobBase/main/scripts/install.ps1 | iexcurl -fsSL https://raw.githubusercontent.com/xy200303/MobBase/main/scripts/install.sh | bash确认安装：
mob --version
mob help安装特定 Release 或自定义目录时，先下载脚本再传参：
irm https://raw.githubusercontent.com/xy200303/MobBase/main/scripts/install.ps1 -OutFile install-mob.ps1
.\install-mob.ps1 -Version latest -InstallDir D:\tools\mob\bincurl -fsSLO https://raw.githubusercontent.com/xy200303/MobBase/main/scripts/install.sh
bash install.sh --version latest --install-dir "$HOME/.local/bin"已验证的下载会缓存到 ~/.mob/cache/releases。安装脚本见 PowerShell 与 Bash。
Android 已完整可用。
安装 Mob 后，在 VS Code 打开项目目录。可以使用 Mob 扩展的工具链与设备视图，也可以直接在集成终端运行：
mob doctor
mob run --accept-licensesmob run 会识别当前项目。对于原生 Android，它调用项目 Gradle Wrapper；对于 Kotlin Multiplatform/KUIKLY Android 项目，它定位唯一的 Android 应用模块并执行 :<module>:installDebug，随后通过 ADB 启动该模块的 applicationId；对于 Flutter Android 目标，它调用项目的 Flutter 或 FVM 工作流。缺少 SDK Platform、Build Tools、NDK、JDK、ADB 或 Emulator 时，Mob 会在许可确认后准备可自动安装的组件。没有可用设备时，默认可创建与项目 API 匹配的 Mob 托管 AVD。
mob android create notes --language kotlin --ui compose --min-sdk 24
cd notes
mob run --accept-licenses生成的是标准 Gradle 工程。Mob 创建项目时会优先复用系统 Gradle；没有时会下载经过校验的 Gradle 发行版以生成 Wrapper。之后 mob build、mob run、mob test 与 mob release 使用项目自己的 Gradle Wrapper。
cd C:\work\legacy-api-27
mob run --accept-licenses
cd C:\work\modern-api-35
mob debug --accept-licensesMob 按当前项目选择 SDK、Build Tools、NDK 和 JDK，仅对本次子进程注入环境。运行旧项目不会破坏新项目的环境，反之亦然。
mob device list
mob device use android:emulator-5554
mob run无线 Android 设备：
mob android device pair 192.168.1.20:37123 --code 123456
mob android device connect 192.168.1.20:5555
mob device use android:192.168.1.20:5555
mob run --mirror点击即可运行。
Mob for VS Code 是 CLI 的可视化入口。扩展不会自行扫描 SDK 或直接调用 ADB、Emulator；所有环境、设备和工作流仍由同一个 mob CLI 处理。
在 Activity Bar 的 Mob 视图中可以：
- 查看 Android SDK、JDK、Flutter 与设备诊断结果。
- 创建标准 Android 或 Flutter 项目。
- 安装 SDK/NDK/系统镜像，创建、启动与停止 Android 模拟器。
- 运行、构建、测试、调试、查看日志与创建发布产物。
- 配对无线真机，选择默认设备，并在编辑器中打开设备预览。
设备预览是 H.264 实时视频流，不是截图轮询。Android 真机与模拟器都可以在 VS Code 中显示，并支持点击、滑动、文本输入、返回、主页和最近任务。会话只监听 127.0.0.1，使用短期 token；关闭面板会回收临时 ADB 转发和辅助进程。
扩展安装后未找到 CLI 时，设置 mob.path 为 mob 命令或可执行文件的绝对路径。详细行为见 插件文档。
给 AI 一个能真正运行项目的接口。
Mob 面向人提供可读的终端输出，也面向 AI、编辑器扩展和 CI 提供机器接口。工具无需解析一段不稳定的报错文字，即可判断当前环境、进度与下一步动作：
mob help run --format json
mob status --json
mob catalog --platform android --json
mob run --accept-licenses --json=events| 模式 | 用途 | stdout 契约 |
|---|---|---|
| 默认文本 | 人在终端中执行 | 人类可读结果；阶段与进度输出到 stderr。 |
--json |
查询或有限工作流 | 一个终态 JSON 对象，含 schemaVersion、event、ok 与 data 或 error。 |
--json=events |
build、run、debug、logs 等长任务 | JSON Lines 事件流；不混入进度条与外部工具原始输出。 |
AI 开发 Android 项目时，可以先读取帮助契约和当前状态，再准备环境、构建、运行、调试与检查设备 UI。随着 iOS 和 HarmonyOS 平台适配器交付，同一接口会扩展到对应平台，而不是让 AI 学习另一套环境变量与设备命令：
mob doctor --fix --accept-licenses --json=events
mob run --accept-licenses --json=events
mob device screenshot android:emulator-5554
mob device ui-tree android:emulator-5554 --json错误对象包含稳定错误码和修复建议。例如 MOB_LICENSE_REQUIRED 表示需要开发者显式同意 Android SDK 许可，AI 或插件可以据此请求确认，而不是擅自接受许可证。
如需调用项目的特殊官方命令，可用 -- 转发。Mob 仍负责平台检查、设备选择和本次环境注入：
mob run --device android:emulator-5554 -- .\gradlew.bat installDebug完整的事件与错误码契约见 产品规范。设备预览协议见 设备会话协议。
| 目标 | 命令 |
|---|---|
| 查看版本和帮助 | mob --version、mob help、mob help <command> --format json |
| 查看状态与诊断 | mob status、mob doctor、mob doctor --fix --accept-licenses |
| 查看可安装组件 | mob catalog --platform android、mob android sdk available、mob android ndk available |
| 管理 Android SDK | mob android sdk list、mob android sdk install managed --api 35 --accept-licenses |
| 管理模拟器 | mob android emulator image available、mob android emulator create、mob android emulator start |
| 管理设备 | mob device list、mob device use <platform:native-id> |
| 日常项目工作流 | mob build、mob run、mob debug、mob test、mob logs --follow |
| 发布 Android 产物 | mob release --platform android --artifact aab |
| 设备检查与自动化 | mob device screenshot、mob device ui-tree --json、mob device wait --idle |
- Android SDK 许可证必须通过
--accept-licenses显式确认。 - Mob 只删除
MOB_HOME内由自己托管的组件；发现或导入的外部工具链始终只读。 mob support bundle只生成脱敏的 Mob 诊断信息，不包含项目文件、密钥、环境变量、代理设置或原始主机路径。- iOS 与 HarmonyOS 不是当前完整交付能力，Mob 不会伪造跨平台构建、签名、设备控制或发布结果。
go test ./... -count=1 -timeout 60s
go test -race ./... -count=1 -timeout 120s
go vet ./...
cd extensions/vscode-mob
npm ci
npm run compile真实 Android 环境的验证步骤见 手动验证清单，已执行的验证和未覆盖风险见 测试报告。
- 扩充真实 Android 项目、模拟器、真机、企业网络与签名发布验证。
- 持续完善 Android 项目类型的识别与工具链兼容性。
- 在 macOS 上基于 Xcode 接入 iOS 工具链和设备工作流。
- 基于 DevEco 和公开官方 SDK 接入 HarmonyOS 工具链和设备工作流。
欢迎提交 Bug 报告、设备兼容性反馈、项目识别案例和文档改进。提交代码前请阅读贡献说明；本项目采用 MIT License。