Obtainium应用版本管理机制解析：版本字符串与版本代码的协调问题

核心问题现象

在Obtainium项目中，用户报告了一个关于应用版本管理的特殊现象：当同时启用"与操作系统检测版本协调版本字符串"和"使用应用versionCode作为操作系统检测版本"两个选项后，即使后续关闭这两个选项，系统仍会持续使用versionCode而非实际版本号进行版本管理。

技术背景解析

Obtainium采用双轨制版本管理系统：

1. 内部版本记录：维护应用安装、更新等操作的历史记录，其版本标识可以是任意唯一字符串（如版本代码、发布日期等）
2. 系统版本记录：读取Android系统提供的标准版本字符串（如1.5.2格式的版本号）

问题复现路径

1. 初始状态：添加GitHub更新源时使用实际版本号
2. 启用状态：同时开启版本协调和versionCode选项
3. 回退状态：关闭上述选项后，系统仍保持使用versionCode

深层机制分析

出现这种现象的根本原因在于Obtainium的版本协调机制设计：

• 版本协调功能启用时，系统会建立内部版本与系统版本的映射关系
• 当使用versionCode作为版本标识时，这种映射关系会被持久化存储
• 简单的选项关闭操作不会自动重置已建立的版本标识映射

解决方案建议

1. 标记更新法：通过"标记为已更新"操作后撤销标记，可以触发版本标识重置
2. 版本重置法：使用设置中的版本检测重置功能
3. 保守配置：非必要情况下保持默认配置，避免复杂选项组合

最佳实践指导

对于普通用户建议：

• 保持默认配置即可满足大多数场景需求
• 仅在特定需求（如追踪非标准版本）时调整版本识别选项
• 修改版本识别策略后，建议通过安装/更新操作建立新的版本基准

对于高级用户提示：

• 版本代码(versionCode)更适合自动化构建场景
• 实际版本字符串更利于人工识别
• 两种标识方式各有优劣，应根据具体使用场景选择