网页项目一键打包成安卓 App
打包意味着什么
WebCat 的打包功能把你写好的整个网页项目封装到一个安卓 App 壳里——打包后的 APK 本质上是一个 WebView 容器，里面跑你写的 HTML/CSS/JS（加上 PHP 编译后的静态页面）。用户装上后图标在桌面上，点开就进入你的网页界面，体验上和普通安卓应用差别不大。
完整打包流程（五步）
第一步：确认项目能正常预览
打包前先点运行把主要页面跑一遍：首页能加载、CSS 样式正常、JS 功能不报错、PHP 文件能输出结果。预览没问题再打包——打包出问题后排查比预览排查麻烦得多。
第二步：进入工程打包入口
在工程文件列表的菜单里找到「打包」或「Build APK」选项。不同版本入口位置不同，可能在：
- 文件列表右上角三点菜单
- 工程详情页底部的操作按钮
- 项目根目录右键或长按
第三步：填写基本信息
打包前会弹出配置界面，最基本的几个字段：
- 应用名：桌面图标下面显示的名字（默认取工程名，可以改）
- 包名：唯一标识，格式一般是
com.xxx.yourapp或top.webcat.xxx - 版本号：给用户看的版本字符串（比如 1.0.0）
- 内部版本号：整数，用于系统判断新旧
第四步：选择图标
默认会用 WebCat 自带的猫形图标，你可以换成自己项目的图标。换图标的具体方法见 自定义图标。
第五步：开始打包
确认信息点「开始」或「打包」，等待 10-30 秒。WebCat 会显示进度，完成后提示 APK 已生成并给出保存路径。
打包后的 APK 在哪
默认保存在工程目录下的 build/ 或 output/ 子目录，或 WebCat 指定的下载目录。打包完成后可以：
- 直接安装回自己手机：点安装，顺着系统授权未知应用来源即可
- 分享给别人：用微信、QQ、邮件发送 APK 文件
- 存到网盘或电脑：备份留存
打包后的 App 和 WebCat 预览有什么不同
| 维度 | WebCat 预览 | 打包后的 APK |
|---|---|---|
| 运行环境 | WebCat 内置 WebView | 独立的 Android WebView 壳 |
| PHP 支持 | ✅ 本地 PHP 服务处理 .php | ❌ 只能打包编译后的静态页面——.php 文件不会进 APK |
| 原生能力 | 有限 | WebCatX 的 CatNative 框架支持完整原生 API（详见版本线对比） |
| 离线可用性 | ✅ | ✅ 打包后就是纯静态文件，完全离线 |
PHP 项目打包要特别注意
这是最容易踩的坑：APK 打包只包含静态文件。你的 .php 文件虽然能在 WebCat 里通过本地服务跑起来，但打包时 WebCat 只会打进编译后的 HTML（预览看到的那份），原始 .php 不会进 APK。
如果你写了 PHP 后端逻辑（表单处理、数据库等），这些逻辑不会进 APK——打包后的 App 只有静态前端页面。解决方法：
- 后端逻辑部署到远程服务器，APK 里的前端用 fetch/AJAX 请求你的后端 API
- 或只打包纯静态功能，PHP 部分不要指望在打包后的 App 里运行