WebToApp

在移动端开发中，将一个网站或前端项目打包成独立的 Android 应用，传统流程往往需要配置 Android Studio、编写 Gradle 脚本、处理签名证书……步骤繁琐且门槛较高。

WebToApp 是一款完全开源的 Android 应用，允许你在手机端零代码完成网站、媒体资源或 HTML 项目到 APK 的转换与构建。无需电脑，无需 Android Studio，几分钟即可生成可安装、可分发的独立应用。

🚀 核心价值：三步构建，即刻分发

输入网址/选择文件 → 配置应用参数 → 一键生成 APK

• 零编程门槛：可视化配置界面，无需编写任何 Java/Kotlin 代码
• 手机端构建：直接在手机上完成编译、签名、打包全流程
• 开源免费：MIT 许可证，代码完全透明，支持自定义扩展

🌐 核心转换能力

🤖 AI 驱动：让应用开发更智能

WebToApp 深度集成 AI 能力，降低功能扩展与界面定制的门槛：

AI 模块开发 Agent

• 自然语言编程：用中文描述需求（如"自动隐藏页面顶部广告"），AI 自动生成 JavaScript/CSS 注入代码
• 安全扫描：自动检测 XSS、eval 等潜在风险，确保注入代码安全可靠
• 语法校验：实时检查代码错误，支持自动修复建议
• 调试预览：内置测试页面，即时验证模块效果

AI 图标与界面生成

• 多模型支持：集成 Google Gemini、OpenAI、智谱 GLM、MiniMax 等主流 AI 供应商
• 智能图标生成：输入应用名称或描述，AI 自动生成精美应用图标
• 会话管理：支持多轮对话调整风格，收藏常用图标模板
• 实时预览：生成代码或图标后，可直接在应用内预览效果

🛡️ 安全与隐私：企业级防护能力

对于需要分发或商用的应用，安全性至关重要。WebToApp 提供多层次防护：

• APK 加密：采用 AES-256-GCM 算法对配置文件、资源文件进行加密，防止反编译篡改
• 浏览器伪装：支持自定义 User-Agent 和浏览器指纹，规避网站反爬策略
• 广告拦截引擎：内置域名级 Hosts 拦截规则，自动过滤网页广告与弹窗
• 独立运行环境：每个生成的应用拥有隔离的 WebView 实例，支持多开与指纹隔离
• 激活码机制：支持 SHA-256 加密校验的激活码系统，实现应用分发权限控制

🧩 扩展模块系统：类油猴脚本的移动端实现

这是 WebToApp 最具扩展性的设计。你可以通过注入 JavaScript/CSS 代码，为任意网页应用增强功能：

10 个内置模块（开箱即用）

模块开发能力

• URL 匹配规则：支持通配符与正则表达式，精准控制模块生效范围
• 用户配置项：模块可暴露配置参数，让用户自定义行为
• 分享码机制：一键生成模块分享码，他人导入即可复用
• NativeBridge API：通过 window.NativeBridge 调用 Android 原生能力

// 示例：一键保存图片并震动反馈
document.querySelectorAll('img').forEach(img => {
    img.addEventListener('contextmenu', (e) => {
        e.preventDefault();
        NativeBridge.saveImageToGallery(img.src);
        NativeBridge.vibrate(50);
        NativeBridge.showToast('图片已保存');
    });
});

✨ 实用功能集成

除了核心转换能力，WebToApp 还集成了大量提升用户体验的实用功能：

🛠️ 技术架构：现代 Android 开发实践

WebToApp 采用当前 Android 开发的主流技术栈，确保代码质量与可维护性：

📝 语言        Kotlin 1.9+
🎨 UI 框架     Jetpack Compose + Material 3
🏗️ 架构模式   MVVM + Repository
🗄️ 本地存储   Room + SQLite
🌐 网络请求   OkHttp
🖼️ 图片加载   Coil
🔐 加密方案   AES-256-GCM + PBKDF2
✍️ APK 签名   JarSigner + Keystore
🌍 多语言    i18n 动态切换（中/英/阿）
📱 系统兼容   Android 6.0 (API 23) ~ Android 16 (API 36)

项目结构概览：

app/src/main/java/com/webtoapp/
├── core/                    # 核心功能模块
│   ├── apkbuilder/         # APK 构建与签名核心
│   ├── crypto/             # 加密系统
│   ├── extension/          # 扩展模块引擎 + AI Agent
│   ├── webview/            # WebView 管理与桥接
│   ├── isolation/          # 独立环境与指纹伪装
│   └── ...                 # 广告拦截、后台服务、BGM 等
├── ui/                      # UI 层（Jetpack Compose）
│   ├── screens/            # 各功能页面
│   ├── components/         # 可复用组件
│   └── theme/              # 主题系统
└── util/                    # 工具类

📖 快速上手指南

1. 安装与启动

• 从 GitHub Releases 下载最新 APK 安装
• 首次启动授予存储、网络等必要权限

2. 创建你的第一个应用

1. 点击主页「创建应用」
2. 输入网站地址（如 https://example.com）
3. 设置应用名称、包名、版本号
4. （可选）选择图标：从相册选取或 AI 生成
5. （可选）配置扩展模块、启动画面、背景音乐等
6. 点击「保存」→「构建 APK」
7. 构建完成后自动弹出安装界面

3. 使用扩展模块增强功能

1. 在创建/编辑应用时，展开「扩展模块」卡片
2. 点击「选择模块」浏览内置模块库
3. 勾选需要的功能（如「视频下载器」「暗黑模式」）
4. 模块将在应用运行时自动注入执行

4. AI 辅助开发自定义模块

1. 进入「扩展模块」→「AI 模块开发」
2. 用自然语言描述需求（如"点击按钮时复制当前页面链接"）
3. AI 自动生成代码并进行安全扫描
4. 预览效果后保存，模块即可复用

🔧 高级用法：编译与二次开发

如果你希望修改 WebToApp 本身或集成到自有项目：

# 环境要求
- Android Studio Hedgehog (2023.1.1)+
- JDK 17
- Gradle 8.2

# 编译步骤
git clone <repository_url>
cd WebToApp
./gradlew assembleDebug        # 编译调试版
./gradlew assembleRelease      # 编译发布版（需配置签名）

# 签名配置（app/build.gradle.kts）
signingConfigs {
    create("release") {
        storeFile = file("your-keystore.jks")
        storePassword = "your-store-password"
        keyAlias = "your-key-alias"
        keyPassword = "your-key-password"
    }
}

📌 注意事项与限制

• 反爬兼容：部分网站有反爬虫或 CSP 策略，可能导致加载受限
• 权限依赖：需要网络、存储等权限才能正常使用完整功能
• 模块执行：扩展模块在 WebView 中运行，受网站安全策略约束
• 激活码验证：内置激活码仅本地校验，服务端验证需自行扩展
• 项目导出：导出的 Android Studio 项目需在 PC 端编译，手机端仅支持直接生成 APK

🔄 近期更新亮点（v1.9.5）

• ✅ 新增 Cookies 持久化，保持登录状态
• ✅ 支持多 API Key 管理与模型名称搜索
• ✅ 新增弹窗拦截器与 URL 预览隐藏功能
• ✅ 优化多语言适配与自定义 API 端点兼容
• ✅ 修复画廊构建、麦克风权限、激活码显示等已知问题