PakePlus-Android：网页转 APK 的云端编译模板

PakePlus-Android 不是给普通用户下载的 App，而是 PakePlus 客户端在打包 Android 应用时使用的原生工程模板：一个 Gradle 工程（Kotlin DSL + Kotlin WebView 宿主 + 内置 Lua 运行时的 assets），配上仓库自带的 GitHub Actions 流水线，在你自己的仓库里把网页编译成可直接安装的 debug APK。README 复用了主仓的说明，所以看起来和主仓几乎一样，实际定位完全不同。

它是什么

• GitHub Actions 一键触发（workflow_dispatch），跑在 ubuntu-latest；
• 环境：JDK 17（Temurin）+ Android SDK platform-tools + Node 22 + pnpm 10 + ImageMagick；
• 流程：pnpm install && pnpm pp:worker 注入项目配置 → ./gradlew assembleDebug → APK 上传到你自己仓库的 Release；
• app/src/main/assets/ 里是 app.json（应用名、网址、颜色等配置）、custom.js（注入脚本）、vConsole.js（调试面板）、pppwd.html；
• app/src/main/java 是 Kotlin 的 WebView 宿主；packages/fuap 是套壳用的运行时资源（也解释了为什么仓库的 GitHub 语言统计里 Lua 占比最高，实际宿主是 Kotlin）。

怎么用

1. 用 PakePlus 客户端（或网页版）新建 Android 项目，填网址、图标、应用名/包名；
2. 客户端会把本模板 fork 到你账号并触发 Actions；
3. 在仓库 Actions 里看进度，完成后到 Releases 下载 APK；
4. 手动跑更简单：仓库 Actions → Android Build → Run workflow。

注意事项

• 产出的是 debug APK（assembleDebug），能直接安装、适合自用与内部分发，但不适合上架；要上架得自己补 release 签名；
• 依赖你的 GitHub Token 权限（Actions、Contents、Administration 等），Token 存本地；
• 体验上限取决于被套的网页：没有移动端适配的站点，套出来就是「手机上的网页」；
• 仓库里没有主项目的 UI 逻辑，它是编译模板，别指望在这里改客户端界面。

与主仓的关系

二开建议

• 配置与注入：app/src/main/assets/app.json、custom.js；
• 换图标与启动图：app-icon.png、launch.jpg；
• 要 release 签名：在 workflow 里加 keystore 步骤，密码用 GitHub Secrets 存；
• 想脱离官方协议：整仓 fork 后自己维护 build.yml。

一句话总结

PakePlus-Android 是「网页 → APK」的那半台机器：一个 Kotlin/Gradle 模板加一条 Actions 流水线，云端出一只 debug APK，自用和内部分发都够，上架还得自己补签名。