Skip to content

Commit fcfe594

Browse files
committed
update docs
1 parent 6bb595b commit fcfe594

File tree

1 file changed

+32
-9
lines changed

1 file changed

+32
-9
lines changed

docs/danxi/04-publish/01-android-windows.md

Lines changed: 32 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -7,8 +7,8 @@
77
## 打包
88

99
1.`pubspec.yaml` 中修改版本号;
10-
2. 执行项目下的 `run_build.bat` 脚本,根据提示确认 Android 版可以打包,**且使用了正确的证书**(证书使用流程见下);
11-
3. 输入版本号(该输入仅用于输出的文件名,胡乱输也不影响输出的文件内容);
10+
2. 确定使用了正确的 Android 签名证书(证书使用流程见下);
11+
3. 运行 `dart build_release.dart --target <android|windows|aab|linux> --versionCode <版本号,如 1.4.5>` 来打包。
1212
4.`build/app/` 目录下获取对应的安装包。
1313

1414
::::tip 证书使用流程
@@ -57,6 +57,8 @@ signingConfig signingConfigs.release
5757

5858
:::tip
5959
建议在点击发布按钮前,先发布到草稿,在后续工作完成后再正式发布。
60+
61+
由于接下来几个步骤都会频繁用到更新日志,建议在这一步编写并保存好更新日志,以备后续使用。
6062
:::
6163

6264
:::info 有用的链接
@@ -68,8 +70,8 @@ signingConfig signingConfigs.release
6870
### Android 下载站
6971
目前暂时没有自动化的发布流程,需要手动上传安装包到服务器。
7072

71-
1. 保证安装包体积小于 25MB
72-
2. 将安装包命名为 danxi-latest.apk,上传至 https://github.com/DanXi-Dev/DanXi-Backend/tree/main/public 文件夹下
73+
1. 保证安装包体积小于 25MB,以满足 Cloudflare 的限制;
74+
2. 将安装包命名为 `danxi-latest.apk`,上传至 https://github.com/DanXi-Dev/DanXi-Backend/tree/main/public 文件夹下
7375

7476
### F-Droid
7577

@@ -114,9 +116,11 @@ git checkout tags/2.2.3
114116

115117
`git push` 默认不会推送 tag 到仓库,需要使用 `git push --tags`
116118

119+
请务必在推送后到 GitHub 仓库页面点击最新提交,确定 tag 已经推送成功。
120+
117121
:::
118122

119-
7. 等待 F-Droid 构建服务器发现新的 tag,自动构建并发布,大约需要 3-7 天。你可以在 [F-Droid 构建状态](https://f-droid.org/zh_Hans/packages/de.storchp.fdroidbuildstatus/) 应用中查看构建状态。
123+
7. 等待 F-Droid 构建服务器发现新的 tag,自动构建并发布,大约需要 3-7 天。你可以在 [F-Droid 构建状态](https://f-droid.org/zh_Hans/packages/de.storchp.fdroidbuildstatus/) 应用中查看构建状态。
120124

121125
:::info 有用的链接
122126

@@ -134,14 +138,22 @@ git checkout tags/2.2.3
134138

135139
:::
136140

141+
### Google Play
142+
143+
在 Google Play 中发布需要打包为 `.aab` 格式的安装包,然后上传到 Google Play Console。
144+
145+
由于 Google Play Console 的操作较为直观,这里不再赘述具体步骤。
146+
137147
## 公告
138148
### 应用内更新提醒
139149

140-
1. 【deprecated】[DanXi-Dev/DanXi-Backend](https://github.com/DanXi-Dev/DanXi-Backend) 仓库中,打开 `all.json` 文件,找到 `"maxVersion": -2``"maxVersion": -3` 的两个条目,将其 `content` 字段的值改为当前版本号和更新日志
150+
1.[DanXi-Dev/DanXi-Backend](https://github.com/DanXi-Dev/DanXi-Backend) 仓库中,打开 `all.json` 文件,找到 `"maxVersion": -2``"maxVersion": -3` 的两个条目,将其 `content` 字段的值改为当前版本号和更新日志
141151

142152
:::caution
143153

144-
> 字符串内容需要转义,例如 `"` 需要写成 `\"`,换行符需要写成 `\n`。请不要图省事而直接复制粘贴手写的更新日志,否则可能会导致 JSON 格式错误。
154+
字符串内容需要转义,例如 `"` 需要写成 `\"`,换行符需要写成 `\n`。请不要图省事而直接复制粘贴手写的更新日志,否则可能会导致 JSON 格式错误。
155+
156+
`all.json` 目前已弃用,仅在旧版本中使用。新版本其实只需要修改 `tmp_wait_for_json_editor.toml` 文件即可。但是为了旧版本能收到更新提醒,仍然需要修改 `all.json`
145157
:::
146158

147159
:::info 有用的链接
@@ -150,5 +162,16 @@ git checkout tags/2.2.3
150162

151163
:::
152164

153-
2.[DanXi-Dev/DanXi-Backend](https://github.com/DanXi-Dev/DanXi-Backend) 仓库中,打开 `tmp_wait_for_json_editor.toml` 文件。找到 [latest_version] 下的 flutter 字段,修改其值。
154-
3.[https://github.com/DanXi-Dev/danxi-dev.github.io] 仓库中找到 `src/views/ProjectAppView.vue` 文件,按需修改 `<script>` 标签中的 `latestVersion``oldestVersion` 变量。如有特殊需求,请同步更改该网页内的其他部分(如特性介绍)。
165+
2.[DanXi-Dev/DanXi-Backend](https://github.com/DanXi-Dev/DanXi-Backend) 仓库中,打开 `tmp_wait_for_json_editor.toml` 文件。找到 `[latest_version]` 下的 flutter 字段,修改其值。
166+
167+
### 官网
168+
[DanXi-Dev/danxi-dev.github.io](https://github.com/DanXi-Dev/danxi-dev.github.io) 仓库中找到 `src/views/ProjectAppView.vue` 文件,按需修改 `<script>` 标签中的 `latestVersion``oldestVersion` 变量。
169+
170+
:::tip
171+
如有特殊需求,请同步更改该网页内的其他部分(如特性介绍)。
172+
:::
173+
174+
175+
### QQ 群组
176+
177+
根据实际运营情况,也需要在 QQ 群组中发布新版本的安装包及更新日志。

0 commit comments

Comments
 (0)