Skip to content

数据库兼容性版本 (Compatibility Version)

Sharp Stock 通过“兼容性版本”机制来管理软件程序与资产库数据库结构之间的匹配关系。

1. 核心定义

兼容性版本(而非软件自身的版本号 v1.x)代表了数据库底层的逻辑结构(如数据表的字段定义、索引关系等)。即便软件的功能进行了频繁迭代,只要底层的存储结构未发生变动,兼容性版本号将保持稳定。

2. 版本兼容逻辑

  • 向下兼容(自动无损升级):当新版软件检测到资产库采用的是旧版存储结构时,系统将执行升级逻辑,将数据库无损升级至当前软件支持的最新格式。
    • Minor 版本升级:若仅为数据库结构微调(次版本升级),系统会在启动阶段在后台自动完成升级,无需您的操作。
    • Major 版本升级:当涉及数据存储结构重构(如 v1.0 升级至 v2.0 拆分特定资产子表)时,系统在打开资产库时会弹出提示框,请求您的确认。
  • 次版本兼容 (Minor):若数据库的次版本略高于软件支持的版本(例如软件支持 2.0,库为 2.1),系统通常允许开启库。但由于数据库中包含软件尚无法理解的新结构,部分进阶功能可能无法完全发挥作用。
  • 主版本拦截 (Major):若数据库的主版本高于软件支持的范围(例如库已升级至 2.0,而软件仅支持 1.x),系统将强制拦截开启操作。此举是为了防止低版本软件因误操作导致高版本数据结构发生不可逆的损坏。

3. 协议 v2.0 升级注意事项

当您使用支持 v2.0 协议的新版软件打开 v1.0 版本的资产库时,系统会弹出升级提示。升级前请特别注意以下事项:

  • 团队协作与共享

    IMPORTANT

    如果该资产库在团队中共享(例如存放在 SVN 或共享云盘中),一旦您同意并将其升级为 v2.0 格式,其他团队成员也必须同步更新其 Sharp Stock 客户端软件。使用旧版软件的成员将无法打开升级后的资产库。

  • 拒绝升级的后果: 如果您选择拒绝升级,系统将无法打开此资产库,并会自动退回到欢迎界面。
  • 升级成功后的建议操作: 数据库升级完成后,系统会弹窗建议您立即执行一次完整扫描。扫描的目的是补齐旧版本库中没有的资产专属属性(例如:三维模型的面数和材质数,以及音频的声道和采样率等)。您可以点击“现在扫描”立即开始,此时系统将调用后台 Web Worker 队列提取元数据,并在主界面展示解析进度。对于 3D 模型与 Spine 骨骼动画资产,后续在浏览与预览时仅读取数据库数据,不会再次写入数据库,有效避免了 SVN 多人协作时的冲突。您也可以选择“以后手动扫描”,并在需要时通过【设置 - 维护】界面手动启动扫描。

4. 常见问题:版本过高预警

若您在开启库时收到“资产库版本过高”的提示,说明该库已被团队中其他使用更高版本软件的成员执行过结构升级。

解决方案:

  • 请立即关闭应用,前往最初下载本软件的应用商店(Microsoft StoreSteamMac App Store)。
  • 执行版本检查并完成软件更新。安装最新版 Sharp Stock 后,即可恢复对该资产库的正常访问。

5. 如何查看当前版本

您可以在 [设置] → [关于产品] 页面中,实时查看到当前软件支持的及资产库实际采用的兼容性版本号。