54 lines
2.3 KiB
Markdown
54 lines
2.3 KiB
Markdown
# 应用与数据身份
|
||
|
||
## 固定身份
|
||
|
||
| 项目 | 决定 |
|
||
| --- | --- |
|
||
| 显示名称 | `NESLite` |
|
||
| 正式 application ID/namespace | `org.neslite.app` |
|
||
| 当前发布版本 | `1.0.0`,`versionCode = 1000000` |
|
||
| 调试 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 声明无缝升级。
|
||
|
||
1.0.0 正式签名证书 SHA-256:
|
||
`767BDF6D6AB140B336EFCF28C5BAAC7A8515F2D760BC568283BAB4537D319191`。
|
||
密钥别名为 `neslite-release`,RSA 3072,有效期至 2054-01-30;私钥与密码仅在维护者本机保存。
|
||
|
||
## 数据目录约定
|
||
|
||
应用内部 `files/` 的长期布局如下,正式 ROM 不放在 `cache/`:
|
||
|
||
```text
|
||
files/
|
||
├── roms/<sha256>.nes
|
||
├── saves/<sha256>/battery/
|
||
├── saves/<sha256>/states/
|
||
├── saves/<sha256>/auto/
|
||
├── saves/cores/nestopia/<sha256>/ Nestopia 独立的 battery、states、auto、recovery 与标记
|
||
├── system/
|
||
└── diagnostics/
|
||
```
|
||
|
||
FCEUmm 保持原存档位置;Nestopia 不读取或迁移 FCEUmm 存档。`core_preferences` DataStore 保存默认
|
||
内核及按 ROM 哈希覆盖的选择,不改变 Room 身份。Room 与 DataStore 使用 Android 标准私有目录。ROM 身份是导入文件完整字节的 SHA-256;同名但
|
||
不同内容必须独立,重新导入相同哈希才重新关联既有存档。目录本身在 M2/M5 实现,本文件只固定
|
||
数据兼容约定。
|