liufumingren 01599d1716 新增打包体系:exe/APK 一键打包与配置统一
- Windows exe:electron-builder 配置 + build:exe 一键打包
- Android APK:离线打包脚手架(命令打包,无需 Android Studio),包名/签名沿用散单项目
- 版本统一:package.json 三段版本,APK versionCode 自动推导
- 配置统一到 config/ 目录,含密钥文件 git 忽略并配套 example 模板
- env.js 接口地址改为环境变量注入,移除敏感信息
- 删除 info/basicinfo.txt(含账号/IP 数据)
- tsconfig 移除已弃用的 baseUrl
2026-09-18 20:13:41 +08:00

39 lines
2.2 KiB
Markdown

# config 目录统一说明
本目录存放项目配置文件。**含敏感信息的配置一律不提交 git,配套的 `*.example.*` 模板提交**,新克隆后按模板复制填写即可。
## 本目录
| 文件 | 说明 | git |
|---|---|---|
| `android.json` | Android 离线打包本地配置(包名、签名密码、AppKey 等) | ❌ 不提交(敏感) |
| `android.example.json` | 上述配置的模板,首次使用复制为 `android.json` | ✅ 提交 |
`android.json` 字段说明:appId(uni-app appid)、appKey(dev.dcloud.net.cn 申请)、appName(应用名)、packageName(Android 包名)、abis(CPU 架构)、icon/splash(图标启动图路径,相对项目根)、wwwSource(可选:指定 App 资源目录,留空则自动用 dist/build/app 或 unpackage/resources)、signing(keystore 路径/密码)。
## 根目录其他配置
| 文件 | 说明 | git |
|---|---|---|
| `.env` / `.env.electron` | Vite 构建目标(web/electron),无敏感信息 | ✅ 提交 |
| `.env.example` | 环境变量模板(接口地址等),复制为 `.env.local` 填写 | ✅ 提交 |
| `.env.local` | 本地环境变量(含内网接口地址,勿提交) | ❌ 不提交(匹配 `*.local`) |
| `env.js` | 前端环境模块(读 Vite 环境变量,不写死敏感地址) | ✅ 提交 |
| `electron-builder.config.cjs` | exe 打包配置(无敏感) | ✅ 提交 |
## 其他敏感/忽略位置
| 位置 | 说明 |
|---|---|
| `android-offline/keystore/` | 签名密钥文件,整个目录不提交 |
| `android-offline/HBuilder-Integrate-AS/` | **已提交 git(保证发布基座一致)**。工程内不写死任何密码:包名/版本/签名/应用名/appid/appKey 均由 `simpleDemo/build.gradle` 在构建时动态读取 `config/android.json` 与 `package.json`;仅排除 `local.properties`、`.gradle/`、`build/` 等本地产物 |
| `release/`、`dist/` | 打包产物,不提交 |
| `info/basicinfo.txt` | 曾含接口返回的账号/IP 数据,已删除;注意 git 历史中仍存在,如有需要可清理历史 |
## 新机器初始化清单
1. `cp config/android.example.json config/android.json` 并填写(签名密钥放入 `android-offline/keystore/`)
2. `cp .env.example .env.local` 并填写接口地址
3. `npm install`
4. 打包:`npm run build:exe`(Windows)、`npm run android:pack`(Android)