mirror of
https://github.com/ILoveBingLu/CipherTalk.git
synced 2026-05-21 20:13:03 +08:00
ILoveBingLu
92 lines
2.1 KiB
Markdown
92 lines
2.1 KiB
Markdown
# 📦 发布说明
|
||
|
||
## 触发方式
|
||
|
||
当前仓库不再使用本地 `npm run tuisong` 发布。
|
||
|
||
正式发布方式改为：
|
||
|
||
1. 修改 `package.json` 中的版本号
|
||
2. 提交代码并推送到 `main`
|
||
3. 推送一个与版本号完全一致的 Git tag，例如：
|
||
|
||
```bash
|
||
git tag v2.2.14
|
||
git push origin v2.2.14
|
||
```
|
||
|
||
只有推送 `v*` 标签时，GitHub Actions 才会自动构建和发布。
|
||
|
||
## GitHub Actions 会做什么
|
||
|
||
`.github/workflows/release.yml` 会在 `v*` 标签触发后执行：
|
||
|
||
1. 安装依赖
|
||
2. 重新编译原生模块
|
||
3. 执行 `npm run build`
|
||
4. 生成 `release/force-update.json`
|
||
5. 创建/更新 GitHub Release
|
||
6. 上传以下文件到 GitHub Release：
|
||
- 安装包
|
||
- `latest.yml`
|
||
- `force-update.json`
|
||
- 若存在则上传 `.blockmap`
|
||
7. 将以下文件同步到 Cloudflare R2：
|
||
- 安装包
|
||
- `latest.yml`
|
||
- `force-update.json`
|
||
|
||
## 版本要求
|
||
|
||
标签名必须与 `package.json.version` 完全对应：
|
||
|
||
- `package.json.version = 2.2.14`
|
||
- Git tag 必须是 `v2.2.14`
|
||
|
||
如果不一致，工作流会直接失败。
|
||
|
||
## 强制更新策略
|
||
|
||
工作流会调用：
|
||
|
||
```bash
|
||
npm run build:force-update-manifest
|
||
```
|
||
|
||
默认情况下不会触发强制更新。只有在仓库 Variables / Secrets 中提供以下值时，生成的 `force-update.json` 才会带上对应策略：
|
||
|
||
- `FORCE_UPDATE_MIN_VERSION`
|
||
- `FORCE_UPDATE_BLOCKED_VERSIONS`
|
||
- `FORCE_UPDATE_TITLE`
|
||
- `FORCE_UPDATE_MESSAGE`
|
||
- `FORCE_UPDATE_RELEASE_NOTES`
|
||
|
||
## Secrets / Variables
|
||
|
||
### Cloudflare R2 Secrets
|
||
|
||
需要在 GitHub 仓库配置以下 Secrets：
|
||
|
||
- `R2_ACCOUNT_ID`
|
||
- `R2_BUCKET_NAME`
|
||
- `R2_ACCESS_KEY_ID`
|
||
- `R2_SECRET_ACCESS_KEY`
|
||
|
||
### 可选强制更新 Variables / Secrets
|
||
|
||
可以按需配置：
|
||
|
||
- `FORCE_UPDATE_MIN_VERSION`
|
||
- `FORCE_UPDATE_BLOCKED_VERSIONS`
|
||
- `FORCE_UPDATE_TITLE`
|
||
- `FORCE_UPDATE_MESSAGE`
|
||
- `FORCE_UPDATE_RELEASE_NOTES`
|
||
|
||
不配置时，`force-update.json` 仍会生成，但只包含当前版本信息，不会强制用户升级。
|
||
|
||
## 当前更新源角色
|
||
|
||
- **GitHub Release**：主更新源，负责安装包与 `latest.yml`
|
||
- **Cloudflare R2**：镜像下载源 + 策略补充源
|
||
- **force-update.json**：GitHub 优先，R2 回退
|