61 lines
1.4 KiB
Markdown
61 lines
1.4 KiB
Markdown
# 发布流程
|
||
|
||
## 1. 更新 CHANGELOG.md
|
||
|
||
按倒序(新版在前)在 `[Unreleased]` 下方添加新版本条目,格式遵循 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)。
|
||
|
||
底部添加版本链接:
|
||
|
||
```
|
||
[x.y.z]: https://github.com/DefectingCat/yayacal/releases/tag/vx.y.z
|
||
```
|
||
|
||
## 2. 更新版本号
|
||
|
||
编辑 `gradle.properties`:
|
||
|
||
- `app.version.base` 改为新版本号(如 `1.2.0`)
|
||
|
||
编辑 `app/build.gradle.kts`:
|
||
|
||
- `versionCode` 递增 `+1`
|
||
|
||
> `app.version.base` 优先于 `build.gradle.kts` 中的默认值,因此以 `gradle.properties` 为准。
|
||
|
||
## 3. 构建 Release APK
|
||
|
||
```bash
|
||
./gradlew :app:assembleRelease
|
||
```
|
||
|
||
产物路径:`app/build/outputs/apk/release/app-release.apk`
|
||
|
||
## 4. 提交、打 Tag、推送
|
||
|
||
```bash
|
||
git add CHANGELOG.md gradle.properties app/build.gradle.kts
|
||
git commit -m "release: vx.y.z"
|
||
git tag vx.y.z
|
||
git push origin main --tags
|
||
```
|
||
|
||
## 5. 创建 GitHub Release
|
||
|
||
```bash
|
||
gh release create vx.y.z \
|
||
app/build/outputs/apk/release/app-release.apk \
|
||
--title "YaYa vx.y.z" \
|
||
--notes-file CHANGELOG.md
|
||
```
|
||
|
||
`--notes-file` 会读取 CHANGELOG.md 全文作为 Release body。
|
||
|
||
## 检查清单
|
||
|
||
- [ ] CHANGELOG.md 新版本条目已添加(倒序,新版在前)
|
||
- [ ] CHANGELOG.md 底部链接已添加
|
||
- [ ] `gradle.properties` 中 `app.version.base` 和 `app/build.gradle.kts` 中 `versionCode` 已更新
|
||
- [ ] Release APK 构建成功
|
||
- [ ] Git tag 已推送
|
||
- [ ] GitHub Release 已创建且包含 APK
|