概览
@zhz8888/dsh-android-emulator-helper
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义;完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- **本机没有全局 Gradle 时,生成的工程无法构建。** `android_create_app` 不写 `gradlew`, 而 `android_build_app` 只能借助 `PATH` 里的 `gradle` 生成 wrapper;没有就会明确报错。 请先装一次 Gradle,或自己在工程根目录跑 `gradle wrapper`。 - **Linux 不支持**,与原插件一致;`android_preflight` 会明确报告。 - `android_start_emulator` 永远启动新模拟器,从不复用已有目标(原插件语义)。复用请把 `serial` 传给其他工具。 - `android_create_avd` 对 `avdmanager` 的确认提示固定回答 `no`,绝不静默触发数 GB 的镜像下载;请先用 `sdkmanager` 装好镜像。 - UI 自动化依赖设备端的 `uiautomator`;不可用时 `android_ui_status` 会报告,构建 / 运行 / 截图链路不受影响。 - 配置页的「已安装系统镜像」列表来自 SDK 目录扫描,而不是 `sdkmanager --list_installed`(后者在受限环境下会失败,且输出夹带大量弃用提示)。 - 配置页的两条路由由插件提供并在真实 profile 中挂载,但它们的 HTTP 响应无法在 GUI 之外验证:桌面端对每个请求做鉴权,未带浏览器会话的 `curl` 访问 `/api/android-emulator-helper/status` 会在进入 handler 之前返回 `403 forbidden`。配置页的间距、暗色主题与窄屏换行仍建议在 GUI 中人工核对。 - 插件不触碰凭据:不读取、不转发任何含 key/token/secret 的环境变量。
