JoiPlay 版本号规则和命名约定
版本号格式
JoiPlay 的版本号格式为三段式：主版本.次版本.构建号
以 1.21.000 为例
- 1：主版本号——大版本迭代（通常是架构性变化或重要里程碑）
- 21：次版本号——功能迭代（约每月一次，每次若干新功能和改进）
- 000：构建号——同一版本下的小修复打包（bugfix 或内部构建版本）
构建号的变化不引入新功能，只是修 bug 或内部打包方式微调。比如 1.21.000 和 1.21.001 之间只有 bugfix，没有新功能。
插件版本号独立
每个引擎插件有自己独立的版本号，和核心 APK 没有绑定关系：
| 组件 | 版本号示例 | 更新节奏 |
|---|---|---|
| 核心 APK（JoiPlay Required） | 1.21.000 | 约每月一次 |
| RPG Maker Plugin | 1.22.008 | 跟随核心 + 随时加兼容修复 |
| Ren'Py 8.5 Plugin | 1.01.00 | 跟随 Ren'Py 引擎大版本 |
| Ruffle Plugin | 1.02.002 | 跟随 Ruffle 项目更新 |
| Godot 4.3 Plugin | 1.00.60 | 跟随 Godot 引擎更新 |
RPG Maker Plugin 的版本号通常高于核心 APK（比如核心是 1.21.000，插件是 1.22.008）——这很正常，插件的功能迭代更频繁。
版本演进路线
从社区整理的历史可以看到几个重要阶段：
| 时间 | 里程碑版本 | 重要变化 |
|---|---|---|
| 2020 | ~0.3 | 最早公开版，只有 RPG Maker 支持 |
| 2021 | ~1.0 | 引入 Ren'Py 插件支持 |
| 2022 | ~1.10 | 模块化插件架构成型 |
| 2023 | ~1.19 | Flash（Ruffle）插件上线 |
| 2024 | ~1.20 | 三档画质预设、自动 RTP 下载 |
| 2025 下半年 | ~1.21 | Godot 支持、虚拟手柄底层重构 |
| 2026 Q1 | ~1.22（alpha） | 渲染性能优化、内存管理改进 |
怎么判断"要不要更新"
| 情况 | 建议 |
|---|---|
| 当前版本正常使用、没有已知问题 | 不必追更——JoiPlay 的更新是持续的，不是强制性的 |
| 某个游戏在当前版本有兼容问题 | 先更新对应插件试试（插件更新更频繁），不行再更核心 APK |
| 安全补丁或重大架构变化 | 必更——可以关注官方的 changelog |
| 游戏在老版本里表现完美 | 别更——新版可能引入回归问题 |
更新注意事项
- 插件先更：通常插件更新不涉及架构变化，风险低；核心 APK 更新可能有更大变化
- 同一个大版本内只升不降：比如从 1.21.000 升到 1.21.001（安全），但不要从 1.21 降回 1.20（可能丢失新版本的设置数据）
- 更新前备份存档：虽然存档在应用私有目录不好导出，但如果是大版本跨越建议至少记录存档位置
- 更新后先测几个游戏：确保插件和核心 APK 版本匹配、没有回归问题