基础配置四项——APP 名称、网站地址、标识 ID、版本号
四项必填项
创建项目后自动跳转到软件配置页面,前四个字段标记为红色星号——必填:
1. 软件名称(APP Display Name)
用户在桌面看到的 APP 名称:
- 支持:中文、英文、数字、下划线、短横线
- 不支持:空格、特殊符号
- 示例:
我的记账本、MyTool、chat-gpt-china
直接填中文名没问题,PakePlus 支持中文 APP 名称打包。如果有空格,用下划线或短横线代替。
2. 网站地址(Source URL 或 Local Path)
PakePlus 打包的内容来源:
- HTTP/HTTPS 网页:对应的访问地址 — 打包在线网站
- 本地 HTML 文件:
file:///path/to/index.html或直接选本地文件 - dist 目录:选 Vue/React 编译后的 dist 文件夹
注意事项:
- 网络地址必须能访问(公开或内网但客户端能访问)
- Vue/React 的 dist 目录建议先构建好(
npm run build后产生的那个) - GitHub 单文件上传有 100MB 软限制,视频/大图片建议走外部链接
3. 软件标识(APP ID)
这是最容易写错的字段。APP ID 是你这个软件在系统里的唯一标识符,用于:
- Windows/Mac 上区分不同应用
- Android 包名(
com.example.myapp格式) - 系统级 API 调用和权限管理
命名规范
- 仅允许小写字母、数字、下划线
_ - 段不能以数字开头
- 无连续点、无首尾点
- 推荐格式:
com.你的域名或项目名.应用名
正确 vs 错误示例
| APP ID | 正确? | 原因 |
|---|---|---|
com.myblog.ticker | ✅ | 符合反向域名格式 |
com.dbbeaaffeac.pakeplus | ✅ | PakePlus 自动生成的默认 ID |
myapp | ❌ | 太短且不符合反向域名格式(在部分平台会报错) |
MyApp.com.example | ❌ | 有大写字母 |
com.example.2app | ❌ | 段以数字开头 |
com..example.app | ❌ | 连续点 |
.com.example.app | ❌ | 首尾点 |
怎么起一个好的 APP ID
如果有自己的域名(哪怕是二级域名),直接用反向域名:
- 有
example.com→com.example.myapp - 有
blog.person.com→com.person.blog.ticker
没有域名就想一个唯一的名字前缀:
com.myname.mytoolio.github.yourname.myapp
4. 软件版本号
遵循语义化版本(SemVer)习惯:主版本.次版本.修订号
| 版本号 | 含义 |
|---|---|
0.0.1 | 初始版本 / 内测 |
0.1.0 | 功能初步完成 / Beta |
1.0.0 | 正式发布 |
1.2.3 | 第 1 主版本、第 2 次功能迭代、第 3 次 bug 修复 |
PakePlus 版本号是自由文本,不强制校验格式,但建议遵循 SemVer 以便后续更新管理。
配置页面长什么样
四个必填项在页面顶部横向排列:
- 左列:软件名称 + 软件标识(两个字段上下排)
- 右列:网站地址 + 软件版本(两个字段上下排)
每个字段右边有一个"锁定"图标,点击可以防止后续误改。
后续可选配置
四项填完后,下面还有一堆可选配置,分块排列:
- 软件图标、圆角图标开关
- 窗口保持、单例模式
- 开发调试、脚本文件
- 窗口模式选择、窗口大小
- 过滤元素、APP 描述
这些分别在 窗口模式切换、窗口尺寸与持久化 等页面里有详细拆解。
保存 / 预览 / 发布
配置页面底部三个大按钮:
| 按钮 | 作用 |
|---|---|
| 保存 | 保存当前配置到本地和 GitHub(如果用云端) |
| 预览 | 打开预览窗口查看 APP 效果,可反复点 |
| 发布 | 开始打包(云端或本地),这是最终操作 |
建议填写完先保存,再点预览检查效果,确认没问题后再发布。