Files
NESLite/docs/identity.md
T

48 lines
1.8 KiB
Markdown
Raw 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` |
| 正式 application ID/namespace | `org.neslite.app` |
| 当前候选版本 | `0.9.10`,`versionCode = 9010` |
| 调试 application ID | `org.neslite.app.debug` |
| 发布 ABI | `arm64-v8a` |
| min/target SDK | 28/36 |
`org.neslite.app` 自 M0 起视为长期数据身份;在有用户数据的 APK 后不得改名。调试包采用独立
ID,避免覆盖正式用户数据。
## 版本号规则
稳定版本的 `versionName` 为 `MAJOR.MINOR.PATCH`,`versionCode` 为
`MAJOR × 1,000,000 + MINOR × 1,000 + PATCH`。例如 1.0.0 是 `1,000,000`,1.2.7 是
`1,002,007`。发布前开发构建可使用较小、单调递增的编号和 `-dev` 后缀,但不能回退已安装
发布包的 `versionCode`。
## 签名延续策略
调试 APK 使用 Android SDK 的 debug keystore,仅作开发验证。发布使用专用、离线保存的
release keystore;私钥、口令、`*.jks`/`*.keystore` 和 CI 密钥不进入 Git、源码包或诊断导出。
首次发布时记录别名、证书 SHA-256 指纹、有效期和保管责任人到未提交的发布保管记录。之后所有
`org.neslite.app` 更新必须使用同一签名证书;若证书不可恢复,不能以同一 ID 声明无缝升级。
## 数据目录约定
应用内部 `files/` 的长期布局如下,正式 ROM 不放在 `cache/`:
```text
files/
├── roms/<sha256>.nes
├── saves/<sha256>/battery/
├── saves/<sha256>/states/
├── saves/<sha256>/auto/
├── system/
└── diagnostics/
```
Room 与 DataStore 使用 Android 标准私有目录。ROM 身份是导入文件完整字节的 SHA-256;同名但
不同内容必须独立,重新导入相同哈希才重新关联既有存档。目录本身在 M2/M5 实现,本文件只固定
数据兼容约定。