系统要求与设备兼容性说明
构建器本身的要求
WebToApp 构建器需要以下环境才能正常安装和运行：
- Android 6.0（API 23） 及以上版本
- 设备存储空间足够（最新版本约 53MB）
- 能安装未知来源应用（第一次通过文件管理器安装时需手动授权）
支持的 CPU 架构：armeabi-v7a、arm64-v8a、x86、x86_64。构建器的 APK 是多架构通用包，安装时自动选对版本。
导出 APK 的运行环境
构建器产出的 APK 对系统版本的要求取决于它使用的浏览器引擎和运行时组件：
- 使用系统 WebView 的 APK：跟随设备上已安装的 Android System WebView 版本
- 使用 GeckoView 的 APK：GeckoView 仅提供 arm64-v8a 版，原生运行时在首次使用时才下载
- 带服务运行时的 APK：Node.js / PHP / Python / Go 二进制按 arm64-v8a 构建，需要 64 位设备
WebView 版本要求
导出的 APK 默认走系统 WebView 组件。部分机型出厂时的 WebView 版本过旧会引发异常——表现为打开就闪退、页面空白或提示组件缺失。
排查步骤：
- 打开应用商店，搜索「Android System WebView」
- 点击更新，同样更新系统 Chrome
- 重新打开 WebToApp 构建器或你导出的 APK
设备必须满足 Android 6.0 及以上才会预装 WebView 组件。
硬件架构注意事项
| 场景 | 要求 |
|---|---|
| 普通网页 / HTML / 前端封装 | 32 位以上都可以 |
| GeckoView 引擎 | 仅 arm64-v8a（64 位） |
| Node.js / PHP / Python / Go 运行时 | 仅 arm64-v8a（64 位） |
| WordPress | PHP 运行时 arm64-v8a（64 位） |
绝大多数近几年发布的安卓手机都是 arm64-v8a，32 位设备（如某些老款平板）无法使用服务端运行时和 GeckoView。
存储权限
WebToApp 需要访问以下存储区域：
- 应用自身目录：存放模板 APK、签名证书、运行时二进制
- 下载 / 文件管理：存放构建产物、导出的 APK/AAB
- 媒体库（画廊 / 图片 / 视频类型）：读取本地图片和视频文件
Android 11+ 上分区存储会要求按类型授权，选择「允许所有文件」可以简化操作。
网络权限
构建器全程运行在设备上，不需要远程构建服务器。但以下场景需要联网：
- 从开发者站自动检测最新版本号
- 离线包类型抓取目标网站内容
- Chrome 网上应用店搜索 MV3 扩展
- DNS-over-HTTPS 请求
- 订阅 hosts 去广告规则列表
服务运行时类型的 APK 导出后可以完全离线运行。