全景一键打包APK工具 · 使用说明书
版本：V1.0.0
一键把本地 HTML 项目（krpano / pano2vr 全景、网页游戏、企业 H5）或在线网址打包成 Android APK。
无需安装 Android SDK、JDK、Gradle、Node，双击即用。
目录
一、软件简介
| 项目 | 说明 |
|---|---|
| 软件名称 | 全景一键打包APK工具 V1.0.0 |
| 运行环境 | Windows 10 / 11（64 位），无需安装任何开发环境 |
| 输入 | 本地 HTML 项目目录（入口 index.html）或在线网址 |
| 输出 | Android APK 安装包（最低支持 Android 5.0，目标 Android 14） |
| 典型用途 | krpano / pano2vr 全景项目离线打包、网站转 APP、H5 应用封装 |
工作原理（了解即可）：软件内置了预编译的安卓 WebView 模板和 Windows 版打包工具链（aapt / zipalign / 签名），打包时把您的网页文件注入模板，按界面参数改写配置后编译、对齐、签名，输出 APK。
二、界面总览
| 区域 | 说明 |
|---|---|
| ① 顶部状态栏 | 显示软件名称版本、当前版本（免费版/专业版）、「注册」「联系购买」按钮 |
| ② 左侧导航 | 三个功能页：⚡ 快速打包 / ⚙ 高级设置 / 🔒 加密·一机一码 |
| ③ 参数面板 | 当前功能页的所有参数（内容较长，可上下滚动） |
| ④ 打包日志 | 实时显示打包过程与结果 |
| ⑤ 底部操作栏 | 进度条 + 绿色「▶ Build APK 打包」按钮 |
三、免费版 vs 专业版
软件本身全部功能免费开放使用，免费版与专业版的唯一区别在于打包出来的 APK：
| 对比项 | 免费版 | 专业版 |
|---|---|---|
| 软件全部打包功能 | ✅ 可用 | ✅ 可用 |
| 本地 HTML / 在线网址打包 | ✅ | ✅ |
| 密码锁 / 一机一码 / JS 桥等高级功能 | ✅ | ✅ |
| 打包次数 | 不限 | 不限 |
| APK 底部广告条 | ⚠️ 有（黑底白字"本App由全景一键打包APK工具打包"，点击跳转推广页） | ✅ 无广告，纯净全屏 |
| 授权方式 | 无需注册 | 注册码激活（限时 / 永久） |
| 顶部标识 | 橙色「免费版」 | 绿色「专业版（至XXXX-XX-XX）」或「专业版（永久）」 |
说明：免费版 APK 的广告条高度 48dp，固定在 APP 界面底部，不遮挡全景画面（WebView 区域会自动缩短），点击广告条会用系统浏览器打开
https://www.010720.cn。
四、注册与升级专业版
4.1 注册流程
- 点击顶部 「注册」 按钮，弹出注册对话框：
- 对话框中显示 本机机器码（如
82FC60D4FE33-F），点击 「复制」 按钮复制； - 点击 「在线获取注册码」（或联系客服），把机器码提供给网站/客服，获取注册码；
- 把注册码粘贴到「注册码」输入框，点击绿色 「注册」 按钮；
- 提示"注册成功"后，顶部变为绿色 「专业版（至XXXX-XX-XX）」，之后打包的 APK 即无广告条。
4.2 注册须知
| 事项 | 说明 |
|---|---|
| 联网要求 | 注册时必须联网（注册码由服务器在线校验）；注册成功后日常离线可用 |
| 授权期限 | 注册码分限时版（30/90/365 天）和永久版，到期后自动恢复免费版 |
| 换电脑 | 机器码与电脑硬件绑定，换电脑需重新获取注册码 |
| 吊销 | 被吊销的注册码会在 24 小时内失效，提示"该注册码已被吊销，请联系管理员！" |
| 取消注册 | 已注册状态下点「取消注册」→ 确认后恢复免费版（可反复测试注册码） |
五、五分钟快速上手
以打包一个本地全景项目为例：
- 选择入口：打包模式选「本地 HTML 项目」→「浏览...」选择项目的
index.html
（软件会自动把 index.html 所在的整个目录（含 tiles / skin / plugins 等子目录）打进 APK）
- 填基础信息：APP 显示名称（如"我的全景展示"）、版本号、包名
- 图标：不选择则自动使用内置默认图标
- 打包选项：全景项目建议直接点页面底部蓝色按钮 「⚡ Krpano 全景一键推荐配置」（自动勾好全屏/横屏/常亮/硬件加速等）
- 权限：全景陀螺仪漫游勾选「陀螺仪传感器权限」；离线项目可不勾网络权限
- 签名：测试用选「内置默认测试证书」即可
- 点击 「▶ Build APK 打包」，等待日志显示
✅ 打包成功，软件自动打开输出目录 - 把 APK 传到手机/模拟器安装即可
六、参数详解与选择建议
6.1 打包模式
| 参数 | 说明 | 选择建议 |
|---|---|---|
| 本地 HTML 项目 | 网页文件全部打进 APK，完全离线运行 | 全景项目、产品演示、展会离线展示选这个 |
| 在线网址 | APK 内嵌一个网址，打开即访问 | 网站转 APP、内容经常更新的场景 |
本地模式注意：选择
index.html后，其所在目录的全部文件会被递归打包。请确保入口文件就在项目根目录，不要选到子目录里的 html。
6.2 APP 基础信息
| 参数 | 说明 | 选择建议 |
|---|---|---|
| APP 显示名称 | 手机桌面图标下方显示的名字 | 中文建议 ≤ 6 个字，长了会被截断 |
| 版本号 | 如 1.0.0 | 每次重新打包发布建议递增（1.0.0 → 1.0.1），否则覆盖安装可能失败 |
| 包名 (shturl.cc/N) | APP 的唯一身份证，自动转为合法 Java 包名 | 每个 APP 用不同的 N（如 shturl.cc/1、shturl.cc/2）；同包名会互相覆盖安装 |
| APP 图标 | 512×512 PNG | 不选自动用内置默认图标；自定义请用正方形 PNG |
| 状态栏颜色 | 手机顶部状态栏背景色 | 与网页主色调一致更协调；全景黑色画面用 #000000 |
6.3 输出设置
| 参数 | 说明 | 选择建议 |
|---|---|---|
| 输出目录 | APK 保存位置 | 不选则输出到默认目录 C:\Users\你\.html2apk\output；建议指定到项目目录方便找 |
| APK 文件名 | 输出的安装包文件名 | 不填自动用"APP名称-版本号.apk" |
6.4 打包选项（逐项建议）
| 选项 | 作用 | 全景项目 | 普通网页 |
|---|---|---|---|
| 屏幕方向 | 竖屏 / 横屏 / 自动旋转 | 横屏（沉浸感强） | 竖屏 |
| 全屏模式 | 隐藏状态栏，沉浸式 | ✅ 勾 | 可不勾 |
| 隐藏手机虚拟导航按键 | 隐藏底部三大金刚键（需配合全屏） | ✅ 勾 | 不勾 |
| 屏幕常亮 | 运行时不自动锁屏 | ✅ 必勾（演示必备） | 按需 |
| 退出确认弹窗 | 按返回键弹"确定退出吗" | ✅ 勾（防误触退出） | 建议勾 |
| 硬件加速 | WebGL 渲染必需 | ✅ 必勾（不勾全景黑屏） | 建议勾 |
| 禁止网页缩放 | 禁止双指缩放页面 | ✅ 勾（krpano 推荐） | 不勾 |
| 下拉刷新 | 网页下拉重新加载 | 不勾 | 在线网址可勾 |
| 左右滑动前进后退 | 边缘滑动切换历史页 | 不勾（与全景拖拽冲突） | 按需 |
| 禁止网页缓存 | 每次都重新加载 | 不勾 | 调试期可勾 |
| 外部链接跳转系统浏览器 | 非 http/https/file 链接交系统处理 | ✅ 勾 | ✅ 勾 |
| 启动闪屏 Splash | APP 启动先显示一张图 1.2 秒 | 按需（品牌露出） | 按需 |
偷懒技巧：全景项目直接点页面底部 「⚡ Krpano 全景一键推荐配置」，自动勾好：横屏 + 全屏 + 隐藏导航键 + 常亮 + 退出确认 + 硬件加速 + 禁止缩放 + 陀螺仪权限。
6.5 权限配置
| 权限 | 何时勾选 |
|---|---|
| 陀螺仪传感器权限 | 全景需要陀螺仪漫游（转动手机看全景）时必勾 |
| 网络权限 | 本地项目含在线资源（地图/统计）或在线网址模式时勾；纯离线可不勾 |
| 定位权限 | 网页用了 GPS 定位（如周边导览）时勾 |
| 相机权限 | 网页需要扫码、拍照上传时勾 |
| 录音权限 | 网页有语音输入、语音讲解录制时勾 |
| 存储下载权限 | 网页需要下载文件到手机时勾；开启一机一码时自动勾选（用于卸载重装免激活） |
建议：按需勾选，不要乱勾。权限越多，安装时用户顾虑越大。
6.6 WebView 内核
| 选项 | 说明 | 建议 |
|---|---|---|
| 新版 WebView 内核 | 基于 Android System WebView，支持最新 WebGL / ES6 | ✅ 推荐，全景必须 |
| 旧版内核 | 兼容老旧设备，特性少 | 仅目标设备是 Android 5~6 老机器时考虑 |
6.7 签名设置
| 选项 | 说明 | 建议 |
|---|---|---|
| 内置默认测试证书（Debug 包） | 无需任何配置，直接出包 | 测试、内部使用选这个 |
| 导入外部 keystore（Release 正式签名） | 使用自己的 PKCS12 证书（.p12/.pfx/.keystore）+ 密码 + 别名 | 正式发布/上架应用市场必须用，且同一 APP 后续更新必须用同一证书，否则无法覆盖安装 |
重要：同一台手机上，同包名但签名不同的 APK 无法覆盖安装，必须先卸载旧版。正式发布后请妥善保管 keystore 和密码，丢失=永远无法更新该 APP。
七、高级设置
| 功能 | 说明 | 使用建议 |
|---|---|---|
| JS 桥 API | 网页内 JS 可调用 APP 原生方法：window.AndroidBridge.exit()（退出 APP）、window.AndroidBridge.refresh()（刷新页面） | 网页需要"退出按钮"时启用；普通展示不需要 |
| 伪加密保护资源 | 对 APK 资源做伪加密，防普通人用压缩软件直接解开 APK 偷走网页源码；Android 可正常安装 | 有源码保护需求时勾选；启用后自动关闭 v2 签名（部分新机型兼容性略降，实测主流机型正常） |
八、加密 / 一机一码
8.1 启动密码锁
勾选后设置密码，打包出的 APK 打开时先弹密码框，输对才能进入。
适合：内部资料、付费内容提前交付、演示机防乱翻。
密码在打包时以 SHA256 哈希存储，不明文写入 APK。忘记密码=只能重新打包。
8.2 一机一码设备授权
勾选后，APK 首次打开会显示一个机器码并要求输入激活码，激活后才能使用；同一台设备只需激活一次（卸载重装也免激活）。
完整流程：
- 打包时勾选「打包 APK 带设备激活机制」，授权密钥留空（用内置默认密钥）即可；
- 客户手机安装打开 APP → 界面显示机器码（如
A1B2C3D4E5F6-9），旁边有一键复制按钮； - 客户把机器码发给您；
- 您在本页下方「激活码生成器」粘贴机器码 → 点 「生成激活码」；
- 把激活码发给客户输入 → 激活成功，永久可用。
适合：按设备收费的项目（一台设备一份钱）、防 APK 被随意复制分发。
| 参数 | 说明 |
|---|---|
| 授权密钥 | 留空 = 用内置默认密钥（推荐，可直接用本工具的生成器）；自定义 = 更高的专属安全性，但需自行保管，丢失无法再生激活码 |
8.3 密码锁与一机一码的关系
两者可叠加：先弹密码框 → 密码正确 → 再弹激活框 → 都通过才进入。一般用其中一个即可。
九、常见场景推荐配置
| 场景 | 模式 | 关键配置 |
|---|---|---|
| krpano/pano2vr 全景离线展示 | 本地 | 点「⚡ Krpano 全景一键推荐配置」+ 陀螺仪权限 + 新版内核 |
| 网站转 APP | 在线网址 | 竖屏 + 网络权限 + 下拉刷新 + 屏幕方向竖屏 |
| 展会演示机 | 本地 | 全景配置 + 屏幕常亮 + 退出确认 + 启动密码锁（防乱翻） |
| 按台收费交付客户 | 本地 | 一机一码 + 存储权限（自动）+ 外部 keystore 签名 |
| 企业内部分发 | 本地/在线 | Debug 签名 + 伪加密保护资源 |
| 正式发布上架 | 本地/在线 | 外部 keystore（Release）+ 专业版（无广告条）+ 版本号管理 |
十、常见问题 FAQ
Q1：打包的 APK 安装后打开黑屏？
全景项目检查两点：①「硬件加速」必须勾选；② 本工具已内置 pano2vr 黑屏自动修复（自动注入 three.js），请用最新版重新打包。普通网页黑屏多为 https 混合内容问题，把「网络权限」勾上重试。
Q2：安装时提示"解析包错误"？
① APK 没下载完整，重新拷贝；② 手机安卓版本低于 5.0；③ 与已安装的同包名 APP 签名冲突——先卸载旧版再装。
Q3：覆盖安装失败？
同包名 + 不同签名 = 无法覆盖。要么卸载重装，要么用与上次相同的签名证书。
Q4：免费版 APK 底部的广告条会挡住全景吗？
不会。广告条是独立布局区域（底部 48dp），全景画面区域自动缩短，画面完整不被遮挡。专业版 APK 无任何广告条。
Q5：打包一直转圈/失败？
看底部「打包日志」的红色错误行。常见：入口文件路径含特殊字符、图标不是 PNG、外部 keystore 密码错误。
Q6：一机一码的 APP，客户换手机了怎么办？
激活码与设备绑定，换手机后机器码变化，需要为新机器码重新生成激活码（生成次数不限）。
Q7：软件首次启动很慢、没反应？
单文件版首次启动需解压约 76MB 内置资源（几秒），期间会显示 logo 闪屏，属正常现象，之后启动正常。
Q8：专业版到期/被吊销会怎样？
到期后软件自动恢复免费版（功能仍可用，只是打包的 APK 重新带广告条）；被吊销的注册码最迟 24 小时内失效。
联系购买专业版：https://www.010720.cn/p/pano2apk