WebToApp 中文文档 下载 App

构建签名分享:从对话框到安装的完整链路

打开构建对话框

在「我的应用」里,找到目标应用卡片,点三点菜单,选择「构建 APK」。会弹出构建对话框,包含以下选项:

引擎选择的决策逻辑

一句话判据:只要你用了拦截、注入、脚本、扩展、加密这些能力,就选系统 WebView。GeckoView 内核下这些功能没有对应实现,配了也不会生效。

纯基础的网页封装、或者需要让目标站点看到 Firefox 指纹时,才选 GeckoView。GeckoView 仅提供 arm64-v8a 版,原生运行时在首次使用时才下载。

更详细的对比见 引擎选择章节。

构建过程在做什么

后台 ApkBuilder 依次完成:

  1. 复制一份 shell 模板 APK
  2. 修改包名(用你在基本信息里指定的)
  3. 替换图标和启动画面
  4. 裁剪权限(去掉模板里有但你的应用不需要的权限)
  5. 把序列化后的 app_config.json 嵌入 APK 内部
  6. 重新对齐原生库(16KB 页)
  7. 用 V1/V2/V3 方案完成签名
  8. 产出最终 APK 到下载目录

整个过程在设备 CPU 上完成,不联网,不排队。普通网页封装大约 2-5 分钟,带服务端运行时的类型可能需要更久。

签名方案

WebToApp 内置 Google 官方 apksig 库,支持:

默认全部启用,可以在设置里自定义签名文件名和证书。证书由用户自行管理——支持创建新证书、从 PEM / PKCS12 导入、导出证书查看指纹。

找到导出的 APK

构建完成后,从「我的应用」右上角三点菜单打开「文件管理」,所有导出的 APK 和 AAB 文件都在这里。文件管理支持:

分享出去

构建器没有远程分享功能——分享通过 Android 系统的分享菜单完成。选择「分享」后系统会弹出可选应用列表,选一个目标(比如网盘 App)即可。

导出 AAB(Google Play)

如果计划上架 Google Play,在构建对话框里选择「导出 AAB」。签名在设备上完成,用你自己的开发者账号提交即可。AAB 格式更适合 Play Store 的动态分发。

详细说明见 AAB 导出章节。