企业官网建设流程全解析

如何从源码构建WebToApp：JDK 17到Gradle编译部署的完整指南

WebToApp 是安卓端功能最全的 Web 转 App 工具集，一个完全运行在手机上的"APK 工坊"——能把网站、HTML、Node.js/PHP/Python/Go 项目甚至 WordPress 打包成可安装的 APK。这篇文章带你从源码构建 WebToApp：环境要求只有JDK 17 + Android Studio两样，跟着 Gradle 命令行一步步完成编译、部署和发布签名配置，零基础也能跑通。

构建前你需要准备什么

在动手之前，先确认三样东西都到位：

项目通过 gradle/wrapper/gradle-wrapper.properties 锁定了gradle-9.4.1-bin.zip，所以你不需要自己安装 Gradle——执行./gradlew时会自动下载对应版本。

Android SDK 方面，项目编译目标是compileSdk = 36（app/build.gradle.kts），CI 流程中还额外安装了 CMake 3.22.1 与 NDK（.github/workflows/android-ci.yml），如果你用 Android Studio，在 SDK Manager 里勾选以下组件即可：

• platform-tools
• platforms;android-36
• build-tools;36.0.0
• cmake;3.22.1
• ndk;28.2.13676358

💡 为什么需要 NDK？因为 app/src/main/cpp/ 下包含node_launcher、go_exec_loader等 C/C++ 原生代码，通过 CMake 编译为.so文件，这是 WebToApp 能在手机上 fork+exec 本地运行时的关键。

WebToApp 构建完成后的应用主界面与 APK 导出能力一览（My Apps 主页、工具箱与关于页）：

第一步：获取源码

克隆仓库到本地（建议放在路径不含中文和空格的目录）：

git clone https://gitcode.com/gh_mirrors/web/web-to-app cd web-to-app

打开仓库你会发现它是三个 Gradle 模块的结构（见 settings.gradle.kts）：

app模块的产物就是你要构建和安装的主 App。

第二步：Gradle 编译（Debug 构建）

最简路径——在项目根目录执行：

./gradlew assembleDebug

这条命令会依次完成：下载 Gradle 9.4.1 → 解析依赖（Kotlin、Compose、Room、apksig 等）→ CMake 编译原生代码 → 打包 APK。首次构建需要下载依赖，耗时较长，属于正常现象。

构建参数方面，项目已经在 gradle.properties 中预设好了大内存堆（6G）与 Kotlin 增量编译，一般无需额外配置。产物位置：

app/build/outputs/apk/standard/debug/app-standard-debug.apk

⚠️ 注意项目定义了standard和gplay两个 flavor（app/build.gradle.kts）。上表的standard是侧载版（包名com.webtoapp）；gplay变体包名为shiaho.webtoapp，专供 Google Play 分发。个人构建用standardDebug即可。

如果用 Android Studio 打开项目，等待 Gradle Sync 完成后直接点运行按钮效果等价。

第三步：部署到手机

1. 手机开启开发者选项 → USB 调试，用数据线连接电脑；
2. 命令行安装：

adb install -r app/build/outputs/apk/standard/debug/app-standard-debug.apk

或在 Android Studio 中选中已连接的设备，点击 ▶ 运行app模块。

应用最低支持 Android 6.0（minSdk = 23），构建目标 Android 15（targetSdk = 35，app/build.gradle.kts），在绝大多数现代手机上可直接安装运行。

第四步（可选）：Release 签名配置

需要正式发布的签名版 APK 时，WebToApp 采用不提交密钥到仓库的安全做法：把签名信息写入项目根目录的local.properties（该文件不入库）。

在local.properties中添加四项配置：

signing.storeFile=/path/to/your.keystore signing.storePassword=你的库密码 signing.keyAlias=你的别名 signing.keyPassword=你的密钥密码

构建脚本会读取这四项并自动生成 release 签名配置（app/build.gradle.kts），然后执行：

./gradlew assembleStandardRelease

🔒 一个贴心的安全细节：如果你没配置签名就直接打 release 包，构建会主动报错拒绝，而不是悄悄用 debug 密钥签——因为 debug 签名的 release 包会让老用户升级时报"签名不匹配"。CI 冒烟测试场景可临时传-PallowDebugSignedRelease=true。

常见构建问题排查

写在最后

从 JDK 17 环境准备到./gradlew assembleDebug一行命令出包，WebToApp 的源码构建路径非常平滑：Gradle Wrapper 帮你管好版本，三个模块各司其职，签名配置与代码仓库彻底分离。构建完成后，你就拥有了这个完整的手机端 APK 工坊——从 APK/AAB 导出管线到 shell 同步机制的更多架构细节，可以在 docs/developer/architecture.md 与 AGENTS.md 中深入阅读。