Files

36 lines
2.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 发布依据为产品负责人的发布确认;历史计划中未归档的设备专项不自动勾选通过。