Files
NESLite/docs/identity.md
T
2026-09-12 11:50:59 +08:00

1.8 KiB
Raw Blame History

应用与数据身份

固定身份

项目 决定
显示名称 NESLite
正式 application ID/namespace org.neslite.app
当前开发版本 0.1.3,versionCode = 1003
调试 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/:

files/
├── roms/<sha256>.nes
├── saves/<sha256>/battery/
├── saves/<sha256>/states/
├── saves/<sha256>/auto/
├── system/
└── diagnostics/

Room 与 DataStore 使用 Android 标准私有目录。ROM 身份是导入文件完整字节的 SHA-256;同名但 不同内容必须独立,重新导入相同哈希才重新关联既有存档。目录本身在 M2/M5 实现,本文件只固定 数据兼容约定。