Unreal Engine 5

在虚幻引擎开发环境中使用的Hive SDK由一个接口包和每个目标操作系统（Android、iOS、Windows）的平台包组成。您可以选择性地仅安装接口包和与您的游戏应用程序目标操作系统匹配的平台包。

• Hive SDK 虚幻引擎 5 接口（必需）
• Hive SDK 虚幻引擎 5 平台（仅为您的目标操作系统安装平台包）
  • Hive SDK 虚幻引擎 5 安卓
  • Hive SDK 虚幻引擎 5 iOS
  • Hive SDK 虚幻引擎 5 Windows

Hive SDK 安装¶

第一步. 下载最新的 Hive SDK 版本¶

从 最新的 Hive SDK Unreal Engine 5 版本 下载适用于目标操作系统的接口包和平台包。

步骤 2. 安装接口包¶

1. 解压下载的 Hive SDK v4 UE5 Interface 26.x.x.zip 文件，然后将 HIVESDK 文件夹添加到以下虚幻引擎项目路径中。

   • 路径: /Plugins<

2. 将依赖代码添加到以下路径的 Build.cs 文件中，以使用已安装的接口包。

   • 路径: /Source//.Build.cs
   • 依赖代码:

     public class HIVESDKV4Tester : ModuleRules
     {
             public HIVESDKV4Tester(ReadOnlyTargetRules Target) : base(Target)
             {
                     PublicDependencyModuleNames.AddRange(new string[] { ... Others..., "HIVESDK"});
             }
     }
     

第3步。安装平台包¶

解压下载的 Hive SDK v4 UE5 {Target OS} 26.x.x.zip 文件，然后根据您的目标操作系统将生成的文件夹添加到以下虚幻引擎项目路径中。

• 路径: /Plugins/HIVESDK/Source

  <project_root>
  └─ Plugins
          └─ Source
                  ├─ HiveSDK
                  ├─ HiveSDKAndroid    (可选)
                  ├─ HiveSDKiOS        (可选)
                  └─ HiveSDKWindows    (可选)
  

包兼容性¶

接口包和平台包可以一起使用，即使它们的版本不同，只要遵循以下包兼容性规则。

• 兼容性仅在 patch 版本级别内的 major.minor.patch 版本格式中得到支持。如果 major 和 minor 版本不匹配，则这些包不兼容。
  • 示例 1：如果接口包版本为 26.1.0，则仅平台包版本 26.1.x 兼容（例如，26.1.1，26.1.2）。
  • 示例 2：如果接口包版本为 26.1.0，则平台包版本 26.0.0 或 26.2.0 不兼容。

Hive SDK 更新¶

要手动更新Hive SDK，请先卸载之前安装的Hive SDK，然后安装最新版本。

步骤 1. 移除 Hive SDK¶

移除接口包¶

1. 删除虚幻引擎中的 /Plugins/HIVESDK 文件夹。
2. 从以下路径的 Build.cs 文件中移除依赖代码。
   • 路径：虚幻引擎 /Source//.Build.cs
   • 依赖代码：

     public class HIVESDKV4Tester : ModuleRules
     {
             public HIVESDKV4Tester(ReadOnlyTargetRules Target) : base(Target)
             {
                     PublicDependencyModuleNames.AddRange(new string[] { ... Others..., "HIVESDK(remove)"});
             }
     }
     

在移除接口包后，您必须重新启动虚幻编辑器以重新编译，因为项目结构已更改。
当您重新启动虚幻编辑器时，编译会根据更新的项目结构自动进行。在此时，如果之前项目结构编译的二进制文件仍然缓存于 Intermediate 和 Binaries 文件夹中，可能会发生构建错误。在这种情况下，请删除 Intermediate 和 Binaries 文件夹，然后重新启动虚幻编辑器以重新编译和重建。

删除平台包¶

在虚幻引擎中，选择并删除安装在/Plugins/HIVESDK/Source路径下的Platform包。

<project_root>
└─ Plugins
        └─ Source
                ├─ HiveSDK
                ├─ HiveSDKAndroid    (optional)
                ├─ HiveSDKiOS        (optional)
                └─ HiveSDKWindows    (optional)

在移除平台包后，重新启动虚幻编辑器以重建因项目结构变化而导致的编辑器。

步骤 2. 安装最新的软件包版本¶

请参考 Hive SDK 安装 以安装最新版本的接口包和平台包。

注意事项¶

当您重新启动虚幻编辑器时，可以在虚幻引擎中安装内置插件。此时，使用CEF（Chromium嵌入式框架）的WebBrowser无法应用，因为它与Hive SDK使用的CEF发生冲突。