36 lines
2.4 KiB
Markdown
36 lines
2.4 KiB
Markdown
# NESLite 发布到 Gitea
|
||
|
||
源码仓库:`http://git.m3frame.com/shen/NESLite.git`;发行页:
|
||
[shen/NESLite/releases](http://git.m3frame.com/shen/NESLite/releases)。源码放入 Git,APK、源码归档和符号放入发行附件。
|
||
|
||
## 正式签名
|
||
|
||
维护者本机默认目录为 `%USERPROFILE%/NESLite-private/signing`,可用 `NESLITE_SIGNING_DIRECTORY` 覆盖。
|
||
目录内使用 `neslite-release.p12`、`password.dpapi`,别名 `neslite-release`。
|
||
DPAPI 密码只供当前 Windows 用户解密;换机需从维护者自己的离线恢复材料还原,并重新加密密码。
|
||
签名文件、密码和恢复材料均不进入 Git、源码归档或发行附件。
|
||
|
||
首次生成的本地恢复副本位于 `%USERPROFILE%/NESLite-private/recovery`,包含密钥副本和恢复密码。
|
||
维护者应将其复制到受保护的离线存储;本机副本不等于异地备份。后续更新继续使用此密钥。
|
||
|
||
## 定版与构建
|
||
|
||
1. 同步应用版本、版本测试、说明和当前发布记录,提交全部源码改动。
|
||
2. 运行 `打包.cmd release -NoPause`。正式构建要求干净工作区,固定四项源码依赖,签名并验证 APK。
|
||
3. 检查 `build/releases/NESLite-<版本>-release.json` 与 `SHA256SUMS`:提交、版本、APK 和源码附件对应。
|
||
4. 将最终提交推送到 `main`,为该提交建立 `v<版本>` 标签并推送。
|
||
5. 在 Gitea 创建对应标签的发行草稿,填写 `docs/releases/<版本>.md` 的说明,上传清单中的附件和校验清单。
|
||
核对附件后发布。不要上传 `build` 整个目录、游戏 ROM、密钥或历史包。
|
||
|
||
当前站点的 HTTP Git 访问已核对可用;网页公布的 SSH 地址含 localhost,不能直接用于远程推送。
|
||
如以后启用 HTTPS 或配置正确的 SSH 地址,应使用站点确认后的实际地址;凭据由本机 Git 凭据管理器保管。
|
||
|
||
## 从发行源码构建
|
||
|
||
可以克隆仓库并双击 `打包.cmd` 构建调试版,固定依赖由脚本取得。
|
||
也可解压 NESLite 源码包,将四项依赖源码分别解压至 `third_party/sources/` 对应目录,然后按 `docs/build.md`
|
||
中的 Java/Wrapper 调用方式执行 `:app:assembleDebug`。该方式使用随包源码,不要求依赖目录带 Git 元数据。
|
||
重新分发改动版时使用自己的签名密钥,不能请求或使用维护者私钥。
|
||
|
||
1.0.0 发布依据为产品负责人的发布确认;历史计划中未归档的设备专项不自动勾选通过。
|