SDK Upgrade

使用 SDK 管理器升級 SDK¶

要使用 Hive SDK 管理器升级现有的 SDK，请在顶部菜单中点击 Hive > HIVE SDK 管理器 > SDK 升级。点击后，请阅读以下内容并继续进行升级。

介面包和平台包¶

Hive SDK v4 Unity 以版本 25.4.0 開始分發，作為 介面包 和 平台包 (Android, iOS)。

介面套件：包括在 Unity 環境中運行 Hive SDK 的介面和插件
- 範例：介面 25.4.5
平台套件：包括每個由 Hive SDK 支援的操作系統（Android、iOS）的庫、資源文件和設置
- 範例：平台 Android 25.4.0，平台 iOS 25.4.4

分開包裝的原因¶

分開包裝的原因如下。

可以通过仅安装必要的包来减少将 Hive SDK v4 Unity 应用到游戏项目中的时间。
在发现问题（例如错误）并修改构建的情况下，可以通过仅更新有问题的包快速部署。
由于仅安装了必要的包，因此在使用像 Git 这样的版本控制系统时，可以有效地跟踪更改。

套件應用規則¶

當介面版本的形式為 major.minor.patch 時，介面包和平台包的版本應用規則如下。

a. 平台套件必須使用與介面套件的 major 值相同的版本。
b. 平台套件可以使用小於或等於介面套件的 minor 值的版本。
c. 如果平台套件遵循 a, b 規則，則可以將 patch 版本應用於任何版本。
d. 平台套件可以在不同的目標操作系統（Android、iOS）之間使用不同的版本。

Warning

此平台套件目前僅支援 Unity Android 和 Unity iOS。Unity Windows 將於稍後發佈。

示例 1：選擇平台包¶

在应用接口 25.4.5 时，可以如下应用平台包。

選擇發佈遊戲的平台
- 如果您只發佈 Android 遊戲，請僅安裝 Android 平台
- 如果您只發佈 iOS 遊戲，請僅安裝 iOS 平台
- 如果您同時發佈 Android 和 iOS，請同時安裝 Android 平台和 iOS 平台
選擇平台包版本
- 您可以選擇版本 25.4.0 或更高
- Android 和 iOS 可以應用不同的版本
- 例如：Android 平台 25.4.0，iOS 平台 25.4.4

示例 2：介面套件更新¶

介面套件可以自由更新到高於當前版本的版本。

然而，在更新接口包时，如果现有的平台包不符合版本规则，则平台包也必须更新。

例如，在更新如下所示的接口包后，您需要将平台 iOS 更新到 版本 26.0.x。

當前版本：介面 25.4.0，平台 iOS 25.4.4
目標更新版本：介面 26.0.0

示例 3：接口包与平台包之间的兼容性¶

介面版本	平台 Android 版本	平台 iOS 版本	相容性
25.4.5	25.4.0	25.4.4	O
25.5.3	25.4.1	25.5.5	O
26.0.0	25.5.5	26.0.1	X (需要更新到平台 Android 版本 26.0.x 或更高版本)

升級訂單 (hive SDK v4 Unity 25.4.0 及以上)¶

1. 選擇升級版本¶

(1) SDK 管理器升級指南¶

點擊將帶您到SDK管理器指南頁面。閱讀指南並繼續升級。

(2) 檢查已應用的版本和最新版本¶

您可以查看目前應用的 Hive SDK v4 Unity 版本和最新發布的版本。
如果未應用 Hive SDK v4 Unity，則應用的版本將標記為 -。

(3) 發布說明¶

點擊移動旁邊的介面包將帶您到該版本的發行說明頁面。閱讀您想要升級到的最新版本的發行說明，然後繼續升級。

(4) 選擇介面套件版本¶

選擇您想要更新或安裝的介面套件。當您點擊文件夾形狀的圖標時，對應版本的介面套件將被選中，並且會出現一個用戶界面菜單，允許您選擇平台套件。低於當前應用版本的介面套件無法安裝，此時狀態中將顯示無法升級圖標。

(5) 選擇平台套件版本¶

選擇您想要更新或安裝的平台包（Android、iOS）。首先，選擇相應操作系統的版本。在確認圖標標記為可升級版本後，點擊復選框以啟用它。

查看介面的先前版本¶

您可以查看当前安装的接口软件包版本的较低版本列表。较低版本标记为不可升级，并且不支持降级。

(7) 應用程式¶

如果您已選擇要升級的介面或平台套件，請通過點擊應用按鈕進入下一步。

2. 完整性驗證¶

如果您已選擇要升級的版本，在此階段您可以選擇要從升級中排除的文件並執行完整性驗證。在現有的SDK版本文件中，只有經過完整性驗證的文件才能升級到目標版本。

(1) 選擇要從升級中排除的檔案¶

在 Hive SDK v4 Unity 套件中，選擇要從升級中排除的檔案。點擊 立即編輯 將會彈出一個備忘檔案，您可以在其中創建要從升級中排除的檔案列表。然後，您可以編輯並保存備忘檔案。

(2) 完整性驗證¶

比較現有版本的 Hive SDK v4 Unity 套件所組成的檔案與原始檔案。換句話說，它比較開發者本地機器上安裝的 Hive SDK v4 Unity 套件檔案與 SDK 管理器伺服器上存在的原始 Hive SDK v4 Unity 檔案。如果本地有修改過的檔案，它們將顯示在列表中。點擊列表中的檔案可以在程式碼編輯器中查看程式碼內容。