← AI 专题

app-builder:HTML/CSS/JS → 签名 Android APK

一句话:把任何单页 HTML/CSS/JS 转成可以直接安装的 Android APK。三重签名,Android 高版本不拒装。


能力


踩过的坑

坑 1:fetch() 对 file:// 无效

APK 内 WebView 用 file:// 协议加载页面,fetch() 请求全部失败。所有页面必须内联为单页 SPA。

坑 2:IndexedDB 不可用

Android WebView 不支持 IndexedDB,需改用 localStorage。涉及数据持久化的逻辑要提前适配。

坑 3:三重签名是必须的

只有 v1 签名 → Android 7+ 警告。只有 v1+v2 → Android 11+ 拒装。必须 v1+v2+v3 全覆盖。


构建流程

1. 接收 HTML/CSS/JS 源文件
2. 生成 Nitron 项目(Android WebView 壳)
3. 将源文件内联注入到 WebView 入口
4. Gradle 构建 release APK
5. uber-apk-signer 三重签名
6. 输出 signed-release.apk

与 hongmeng 的关系

app-builder 是 Android 路径,hongmeng 是鸿蒙路径。两者互补,覆盖双端。同一个 Web App 可以先打出 APK 快速分发测试,验证通过后再走鸿蒙流程上架 AppGallery。

frontend-design → app-builder
Web 设计 → APK 快捷分发


📥 下载安装

SKILL.md 放到 ~/.claude/skills/app-builder/SKILL.md,重启 Claude Code 即可使用。

⬇ 下载 SKILL.md(7 KB)