【别再手动配置 Android 环境了:Mob 让 VS Code 的移动开发回到“打开项目就能跑”】

发布时间:2026/8/1 2:27:59
【别再手动配置 Android 环境了:Mob 让 VS Code 的移动开发回到“打开项目就能跑”】 移动端开发不该从安装多个 IDE、下载多套 SDK、配置环境变量开始。Mob 希望把 Android、iOS、HarmonyOS 的工具链、设备和运行流程收敛为 VS Code 中的一个入口当前 Android 已可用iOS 与鸿蒙正在接入。移动端开发的第一个障碍往往不是业务代码很多开发者使用 VS Code 写 Kotlin、Flutter 或 Kotlin Multiplatform。第一次真正运行 Android 项目时通常要依次处理 Android SDK 路径、compileSdk、Build Tools、JDK、ADB、模拟器镜像以及 Gradle 和环境变量之间的关系。切换到 iOS 或 HarmonyOS 后又会面对 Xcode/Simulator 或 DevEco/HDC 的另一套入口。Android Studio、Xcode 和 DevEco 都能覆盖其中的一部分环节但它们也让“安装和熟悉多个 IDE”变成开发前置条件。对于只需要编辑、构建、运行、调试和看设备画面的日常工作开发者需要的是一个统一入口而不是三套不同的环境配置方式。更现实的问题是 AI 开发。AI 可以生成界面和业务代码但如果它不知道当前机器有没有 API 34、哪个 JDK 能构建、设备是否在线最后仍然需要开发者回到终端手动排障。移动端缺的不是又一个代码生成器而是一套可以查询、执行并返回结构化结果的环境入口。Mob 的目标VS Code 一个入口完成移动端开发Mob 是移动开发环境管理 CLI定位接近nvm不是新的构建系统。它的长期目标是让开发者以 VS Code 为中心用一个入口完成 Android、iOS 和 HarmonyOS 的环境准备与日常工作流。它做的是发现并复用各平台已有的官方 SDK、工具链、设备桥接与模拟器。当前项目缺少官方组件时按需下载、校验并准备它们。根据项目配置选择工具链只向本次构建、运行或调试子进程注入环境。用统一设备模型连接真机、启动模拟器并把构建、运行、调试与设备检查收敛到同一组命令。为 VS Code、CI 与 AI 工具提供文本、JSON 和 JSON Lines 三种输出。目标不是让官方工具消失而是让开发者不再手工拼装 SDK、设备桥接、模拟器和环境变量。日常流程可以是VS Code Mob 项目自己的官方构建工具。项目仍然是标准项目Mob 不创建mob.yaml不改写build.gradle、Flutter 配置或.fvmrc。Android Studio 依然可以用于布局设计、Profiler 和专项诊断Xcode 与 DevEco 的官方要求也会被保留。Mob 的目标是让手工环境配置不再成为日常构建、运行和调试的必要前提。从一台新电脑到运行项目先安装 Mob。安装脚本下载经过校验的 Release 二进制不要求本机有 Goirmhttps://raw.githubusercontent.com/xy200303/MobBase/main/scripts/install.ps1|iexmob--version在 VS Code 打开一个 Android 项目后可以从 Mob 扩展点击操作也可以在集成终端执行mob doctor mob run--accept-licensesMob 识别当前项目后会调用它原本的官方构建入口。原生 Android 和 KMP Android 目标使用 Gradle WrapperFlutter Android 使用 Flutter 或 FVM。若缺少 SDK Platform、Build Tools、NDK、JDK、ADB 或模拟器Mob 会在开发者明确确认 Android SDK 许可后补齐可自动安装的组件。没有设备时它可以创建匹配项目 API 的默认 Android 模拟器并继续运行。第一次下载需要时间后续项目可以复用已有工具链与下载缓存。不同项目的 API、NDK、JDK 需求也不会靠覆盖全局JAVA_HOME或ANDROID_HOME来切换。多个项目不用反复改环境假设一个旧项目需要 API 27另一个新项目需要 API 35、NDK 和 JDK 17cd C:\work\legacy-api-27 mob run--accept-licenses cd C:\work\modern-api-35 mob debug--accept-licensesMob 从当前项目推导需求在启动 Gradle、Flutter 或设备命令时注入相应环境。这样旧项目和新项目可以同时存在不需要为了运行其中一个去破坏另一个。VS Code 不只是编辑器Mob for VS Code 是 CLI 的图形入口。它把工具链诊断、SDK 安装、模拟器、真机、构建、运行、日志和调试放进 Activity Bar但不在插件里重复实现 Android 工具管理。CLI 始终是唯一负责发现、下载、环境注入和命令执行的组件。扩展还可以在编辑器内打开 Android 真机或模拟器的实时预览。预览使用 H.264 视频流而非截图轮询支持点击、滑动、文本输入、返回、主页和最近任务操作。会话仅监听本机回环地址临时 token 和 ADB 转发会在关闭预览后回收。AI 如何参与完整开发流程Mob 的默认输出给人看机器接口给自动化工具看mob help run--format json mob status--json mob doctor--fix--accept-licenses--jsonevents mob run--accept-licenses--jsonevents mob device ui-tree android:emulator-5554--json--json返回一个终态对象--jsonevents在长任务中返回 JSON Lines 进度事件。AI 可以读取命令能力、检查当前环境、发现缺失工具链、请求用户确认许可证、执行构建与运行再通过截图或 UI 树检查结果。它不需要猜一段文本报错也不应绕过用户对许可证、设备授权和签名的确认。这也是 Mob 和“给 VS Code 再装一堆扩展”之间的区别CLI、插件、CI 和 AI 共享同一份工具链状态与命令契约。当前范围Android 现在可用跨平台持续接入Mob 当前完整支持 AndroidSDK、NDK、JDK、ADB、Emulator、真机、Flutter/FVM、构建、运行、调试、测试、日志、发布构建以及 VS Code 内的 Android 设备预览。iOS 和 HarmonyOS 已有统一的平台命名空间与设备协议设计完整的工具链、设备、签名和发布工作流正在接入。Mob 不会伪造 Xcode、DevEco、签名、设备控制或发布能力对应平台会以官方能力真实交付。获取项目GitHubhttps://github.com/xy200303/MobBaseReleasehttps://github.com/xy200303/MobBase/releasesVS Code Marketplacehttps://marketplace.visualstudio.com/items?itemNamexiaoyun.mob-vscode产品规范https://github.com/xy200303/MobBase/blob/main/docs/PRODUCT_PLAN.md手动验证清单https://github.com/xy200303/MobBase/blob/main/docs/MANUAL_VALIDATION.mdMob 从 Android 开始把“在 VS Code 中一键启用移动端开发环境”做成真实体验随后让 iOS 与 HarmonyOS 接入同一套工具链、设备和自动化入口。