Sharp Stock

English

简体中文

English

简体中文

Database Compatibility Version ​

Sharp Stock uses a "Compatibility Version" mechanism to manage the matching relationship between the software program and the asset library database structure.

1. Core Definition ​

The compatibility version (as opposed to the software's own version number v1.x) represents the underlying logical structure of the database (such as field definitions in data tables and index relationships). Even if software features are frequently iterated, the compatibility version number will remain stable as long as the underlying storage structure does not change.

2. Version Compatibility Logic ​

  • Backward Compatibility (Automatic Non-destructive Upgrade): When new software detects that an asset library uses an older storage structure, the system will perform upgrade logic to upgrade the database to the latest format supported by the current software.
    • Minor Version Upgrade: If it is a minor schema adjustment, the system will automatically complete the upgrade in the background during startup, requiring no action from you.
    • Major Version Upgrade: When major data structure refactoring is involved (such as splitting specific asset tables from v1.0 to v2.0), the system will prompt you for confirmation when opening the asset library.
  • Minor Version Compatibility: If the database's minor version is slightly higher than what the software supports (e.g., software supports 2.0, library is 2.1), the system usually allows opening the library. However, since the database contains new structures the software cannot yet understand, some advanced features may not fully function.
  • Major Version Block: If the database's major version is higher than the software's supported range (e.g., library upgraded to 2.0 while software only supports 1.x), the system will forcibly block the opening operation. This is to prevent older software from causing irreversible damage to high-version data structures through incorrect operations.

3. Protocol v2.0 Upgrade Notes ​

When you open a v1.0 asset library using a new version of the software that supports the v2.0 protocol, you will be prompted to upgrade. Please pay close attention to the following before upgrading:

  • Team Collaboration & Sharing:

    IMPORTANT

    If the asset library is shared among a team (e.g. stored in SVN or shared cloud drives), once you agree to upgrade it to the v2.0 format, other team members must also update their Sharp Stock client software. Members using older software will not be able to open the upgraded asset library.

  • Consequences of Declining: If you choose to decline the upgrade, the system will not be able to open the asset library and will automatically return to the welcome screen.
  • Recommended Actions After Upgrading: Once the database is upgraded, the system will suggest running a full scan. This populates asset-specific attributes that did not exist in older versions (e.g., face and material counts for 3D models, channels and sample rates for audio). You can click "Scan Now" to populate them immediately, which starts background Web Worker queues to parse metadata and display a progress overlay on the main screen. For 3D models and Spine animations, subsequent browsing or previewing will only read from the database and will not trigger database writes, preventing binary conflicts when collaborating via SVN. You can also choose "Scan Later Manually" and trigger it under [Settings - Maintenance] later.

4. Common Issue: Version Too High Alert ​

If you receive an "Asset library version too high" prompt when opening a library, it means the library has already undergone a structural upgrade by another team member using a higher version of the software.

Solution:

  • Please close the application immediately and go to the app store where you originally downloaded the software (Microsoft Store, Steam, or Mac App Store).
  • Perform a version check and complete the software update. After installing the latest version of Sharp Stock, you can resume normal access to the asset library.

5. How to View Current Version ​

On the [Settings] → [About Product] page, you can view the compatibility version number currently supported by the software and actually used by the asset library in real-time.