APK打包助手

将网址或本地网页一键打包成 Android APK 的本地化桌面工具

APK打包助手（ToApp Builder）是一款基于 Electron 构建的桌面工具，无需云端服务，所有构建过程在本地完成，数据安全可控。它可以将任意网站 URL、本地 HTML 文件或 ZIP 压缩包快速封装为 Android APK 安装包，支持丰富的自定义配置（启动页、深色模式、WebView 内核选择、签名等）。

运行时文件： dist/win-unpacked/APK打包助手.exe

目录结构

ToAppBuilder/
├── package.json                    # 项目配置 (Electron + electron-builder)
├── README.md                       # 本文件
│
├── src/                            # Electron 应用源码
│   ├── main/                       # 主进程 (Node.js)
│   │   ├── index.js                #   主入口 — 窗口管理、IPC处理、构建调度
│   │   └── preload.js              #   预加载脚本 — 暴露安全 API 到渲染进程
│   └── renderer/                   # 渲染进程 (前端 UI)
│       ├── index.html              #   主界面 (约700行，完整 SPA)
│       ├── css/
│       │   └── style.css           #   样式
│       ├── js/
│       │   └── app.js              #   前端交互逻辑
│       └── assets/
│           ├── icon.ico            #   应用图标 (Windows)
│           ├── icon.png
│           └── icon_simple.ico
│
├── engine/                         # 构建引擎 (核心)
│   ├── build-engine.js             #   APK 构建引擎 (~1237行)
│   │                               #   aapt2 编译 → Java 编译 → DEX 转换
│   │                               #   → APK 打包 → 签名 → 对齐
│   └── template/
│       └── app/                    # Android 项目模板
│           ├── build.gradle
│           ├── AndroidManifest.xml
│           ├── src/main/java/      # Java 源码 (WebView 封装)
│           ├── src/main/res/       # 资源文件 (mipmap、layout 等)
│           ├── assets/             # 内置资源 (图标、Ionic 等)
│           ├── libs/
│           │   └── tbs_sdk_43939.jar   # 腾讯 X5 内核 SDK
│           └── assets/
│               └── x5.tbs.apk          # X5 离线内核 (约33MB)
│
├── dist/                           # 构建输出 (portable 版)
│   └── win-unpacked/
│       ├── APK打包助手.exe           # 可执行文件 (主入口)
│       ├── resources/
│       │   └── app.asar            #   打包后的应用代码
│       ├── locales/                # Electron 国际化语言包
│       │   ├── zh-CN.pak
│       │   └── ...
│       ├── d3dcompiler_47.dll      # Electron 运行时依赖
│       ├── ffmpeg.dll
│       ├── icudtl.dat
│       ├── libEGL.dll / libGLESv2.dll
│       ├── v8_context_snapshot.bin
│       └── vk_swiftshader.dll
│
├── dist2/                          # 另一版本构建输出 (nsis/installer 版)
│   └── win-unpacked/
│       └── ...                     # 内容同 dist，含 LICENSE 等额外文件
│
├── node_modules/                   # Node.js 依赖
├── package-lock.json
│
├── test-build.js                   # 构建测试脚本
├── test-output/                    # 测试构建产物
│   ├── test-app.apk
│   ├── test-advanced.apk
│   ├── test-local-html.apk
│   ├── test-new-url.apk
│   └── test-page.html
│
└── 文档/
    ├── ICO图标修复_20260728_1340.md
    ├── apk_crash_fix_20260728_1238.md
    ├── x5_offline_integration_20260728.md
    ├── 日志记录功能_20260728_1325.md
    └── APK打包助手_测试报告.md

功能特性

快速入门

1. 启动软件 → 运行 APK打包助手.exe
2. 输入网址 或选择本地 HTML/ZIP 文件
3. 填写应用名称（可选：上传图标、展开更多设置）
4. 点击 「生成 APK」，等待 30–60 秒
5. 将生成的 .apk 文件传输到 Android 手机并安装

详细操作指南请参见软件内的「新手帮助」页面。

环境依赖

APK 构建需要以下本地环境（可在「环境检测」页面查看状态）：

设置环境变量 ANDROID_HOME 指向 SDK 安装目录。

技术栈

• 桌面框架： Electron 33
• 运行时： Node.js
• 构建引擎： 自研 Node.js 构建管道（aapt2 → javac → d8 → apksigner）
• Android 模板： 原生 Java + Android SDK（无 Gradle 依赖，纯命令行编译）
• 图标处理： Python Pillow

构建说明

# 安装依赖
npm install

# 开发模式运行
npm start           # 或 npm run dev（自动打开 DevTools）

# 打包为 Windows 便携版（portable）
npm run build

# 打包为 Windows 安装包（NSIS）
npm run build-installer

许可

MIT License

开发者： 沧州虎王科技
Copyright © 2026 沧州虎王科技. All rights reserved.