WebToApp 部署教程：在手机上构建 Android 应用

本教程将指导你部署和使用 WebToApp——一个功能完整的 Android APK 构建工具，能直接在手机上通过 WebView 将网站打包成 APK，并支持本地服务器运行（Node.js、PHP 等）。

📱 部署方式：安装 App

WebToApp 是一个 Android 应用程序，你需要在 Android 手机上安装它，无需传统意义上的“服务器部署”。

1. 从 GitHub Releases 安装（推荐）

  • 打开项目 GitHub Releases 页面。
  • 下载最新版本的 APK 文件（例如 webtoapp-vX.X.X.apk）。
  • 在手机上打开该 APK 文件，根据系统提示允许“安装未知来源应用”并完成安装。

2. 从源代码构建（开发者）

如果你需要修改源码或自行编译：

1
2
3
git clone https://github.com/shiaho777/web-to-app.git
cd web-to-app
./gradlew assembleDebug

构建完成后，APK 位于 app/build/outputs/apk/debug/ 目录。进行发布版构建需要配置签名密钥，可参考项目文档。

🚀 首次使用与核心功能

1. 启动应用

安装后，在手机桌面打开 WebToApp 应用。主界面清晰展示了可用的 项目类型 和 模块，支持中文和英文等 10 种界面语言。

2. 快速创建第一个 App

  1. 选择输入源：你可以从 Website URL（网站地址）、HTML / Frontend（本地前端代码）、Node.js / PHP / Python / Go（带后端服务的项目） 等多种类型中选择。
  2. 配置基础信息：
    • 输入或选择项目源（例如输入 https://example.com）。
    • 自定义应用的 图标 (Icon)、名称 (App Name)、包名 (Package Name)（如 com.yourname.myapp）。
  3. 高级设置（可选）：根据需求调整：
    • 网络与隐私：启用 DNS-over-HTTPS、代理、TLS 指纹伪装等。
    • 浏览器引擎：选择系统 WebView 或下载 GeckoView（Firefox 引擎）。
    • 本地运行时：如果项目类型是 Node.js/PHP 等，在此配置启动文件和依赖。
  4. 构建 APK：点击 构建 (Build) 或 导出 (Export)。应用会实时处理，完成后会生成可安装的 APK 文件。

3. 使用 Agent（AI 助手）

应用内置了 Agent 功能（点击菜单 ⋮ → Agent），你可以通过自然语言与它交互来执行构建、管理等任务。

  1. 在 AI 设置 中配置 LLM 后端（OpenAI、Anthropic 或本地 Ollama 等）。
  2. 在 Agent 对话框中输入指令，例如：“创建一个名为 ‘My Blog’ 的 WordPress APK，并导出”。
  3. Agent 会调用内置的 57 个工具执行操作，并在需要时请求你的确认。

⚙️ 高级功能与技巧

部署本地服务器应用（Node.js/PHP/Python/Go）

这是一个强大特性：你可以将完整的服务器端应用打包进 APK，在手机上运行。

  1. 在 Linux 环境 或 运行时管理 中，下载所需的运行时（Node.js 18.20、PHP 8.4 等）。
  2. 创建项目时选择 Node.js 或 PHP 等类型。
  3. 将你的服务器代码（如 app.js 或 index.php）放入项目目录。
  4. 配置启动文件（例如 node app.js），构建的 APK 在启动时会自动 fork+exec 这个服务进程，并通过本地 WebView 访问。

增强隐私与反检测

  1. 在创建项目时，滚动到 隐私与指纹防御 区域。
  2. 启用 浏览器指纹伪装，并选择想要模拟的设备指纹。
  3. 开启 资源加密，为打包的 HTML/JS 等文件添加 AES-256-GCM 加密。
  4. 在 广告拦截 中，可以导入社区规则列表。

从 Chrome Web Store 安装扩展

WebToApp 支持在生成的 App 中加载 MV3 浏览器扩展。

  1. 在应用内找到 浏览器扩展 (Browser Extensions) 功能。
  2. 直接搜索 Chrome 商店中的扩展（如 uBlock Origin），点击安装。
  3. 安装后的扩展可以应用于你构建的特定 App 中。

❓ 常见问题排查

  • 应用无法安装：检查系统设置是否允许安装未知来源应用。如果提示“解析包错误”，请重新下载 APK，确保下载完整。
  • 构建失败：检查项目名称是否包含特殊字符，包名是否合法（如 com.example.app）。查看 文件管理器 中的 构建日志 获取详细错误信息。
  • 本地服务器（Node/PHP）不工作：确保在 Linux 环境 中已下载对应的运行时。对于 targetSdk，请注意：使用服务器运行时的 APK 默认 targetSdk=28，这是为了兼容 fork+exec 功能；纯 WebView 应用可以提高此设置。
  • 网络请求被阻止：检查是否启用了代理、DoH 或广告拦截规则，可尝试暂时关闭这些功能进行测试。
  • 界面显示不全或异常：尝试在设置中切换 深色/浅色主题，或调整显示缩放。

通过以上步骤，你应该能在 Android 手机上成功安装并使用 WebToApp，将网站、Web 应用甚至带有后端的项目打包成独立的 APK。该工具特别适合开发者快速测试、内容创作者分发离线内容，或对隐私和网络配置有高级需求的用户。