manifest.json 自定义包名与权限
manifest.json 是什么
manifest.json 是 WebCat 项目根目录下一个特殊的 JSON 文件，打包 APK 时的所有配置都从这里读取。WebCat 新建工程时会自动生成一份默认值，你如果不改，打包就用默认配置。
主要字段说明
以下是最常用的几个字段（字段名以你实际 WebCat 版本为准，可能略有差异）：
| 字段 | 作用 | 示例值 |
|---|---|---|
packageName | 包名（安卓唯一标识） | top.webcat.mytodo |
appName | 桌面图标下显示的应用名 | 我的待办清单 |
versionName | 用户可见的版本号 | 1.0.0 |
versionCode | 整数型内部版本号 | 1 |
icons | 各分辨率图标路径 | 见上一页 自定义图标 |
permissions | 需要声明的安卓权限列表 | ["INTERNET", "WRITE_EXTERNAL_STORAGE"] |
改包名的正确姿势
包名是安卓系统里区分不同 App 的唯一标识——一旦安装后再改包名，系统会认为这是一个全新的 App，旧版本不会自动升级，用户需要卸载新装。所以：
- 发布前想清楚包名，定了就别乱改
- 格式建议用反向域名：
com.你的标识.应用名或top.webcat.你的标识 - 不能用中文、空格、特殊字符；只能用小写字母、数字、点号
权限声明要点
WebCat 打包默认会加一些基础权限（网络访问等）。如果你的功能需要额外权限：
- 文件读写：打包时勾选「存储访问」或在
permissions数组里加相关条目 - 相机：需要拍照功能时声明 CAMERA 权限
- 定位：需要获取位置时声明 ACCESS_FINE_LOCATION
- 麦克风：需要录音时声明 RECORD_AUDIO
具体权限的写法以 WebCat 当前版本的默认 manifest.json 为参考格式。
用 JSON 编辑器改
5.21 版本开始支持 JSON 文件直接编辑（见 JSON 文件编辑）。修改 manifest.json 的推荐流程：
- 打开 manifest.json
- 改你要调整的字段值
- 点格式化，让缩进重新对齐
- 肉眼扫一遍大括号是否配对
- 保存后再去打包
打包前最后检查
改完 manifest.json，打包前跑一遍预览——确认首页能正常加载（manifest.json 本身不影响运行，但打包流程如果读取配置失败会直接报错）。
打包后 APK 安装成功了吗？桌面上图标和应用名是你改的那个吗？设置里应用信息页显示的包名和版本号对不对？这几项都对上了说明配置生效了。