跳转至

Unreal Engine 4

在虚幻引擎开发中使用的Hive SDK由接口包和每个目标操作系统(Android、iOS、Windows)的平台包组成。因此,您可以选择并仅安装与您的游戏应用目标操作系统匹配的接口包和平台包。

  • Hive SDK 虚幻引擎 4 接口(默认安装)
  • Hive SDK 虚幻引擎 4 平台(仅为目标操作系统安装平台包)
    • Hive SDK 虚幻引擎 4 安卓
    • Hive SDK 虚幻引擎 4 iOS
    • Hive SDK 虚幻引擎 4 Windows
Note

有关插件和模块(虚幻引擎项目的组件)的更多信息,请参见以下链接。

Hive SDK 安装

步骤 1. 下载最新版本的 Hive SDK

Hive SDK Unreal Engine 4 最新版本 下载与您的游戏应用目标操作系统相匹配的接口包和平台包。

步骤 2. 安装接口包

  1. 解压下载的 Hive SDK v4 UE4 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 UE4 {Target OS} 26.x.x.zip 文件,并根据您的目标操作系统将生成的文件夹添加到下面的虚幻引擎项目路径中。

  • 路径: /Plugins/HIVESDK/Source
    <project_root>
    └─ Plugins
            └─ Source
                    ├─ HiveSDK
                    ├─ HiveSDKAndroid    (可选)
                    ├─ HiveSDKiOS        (可选)
                    └─ HiveSDKWindows    (可选)
    
Note

在打包阶段,Hive SDK 在构建您的游戏应用后创建可执行文件 (.apk_, _.IAP, *.exe 等),上述路径中添加的 Platform 包的代码和资源会自动包含在每个目标操作系统的可执行文件中。

包兼容性

接口和平台包即使版本不同,也可以兼容,遵循以下包应用规则。

  • 兼容性仅在 major.minor.patch 版本格式的 patch 版本级别上得到支持。如果 majorminor 版本不匹配,则它们不兼容。
    • 示例 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 并安装最新版本。

第一步. 删除 Hive SDK

删除接口包

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

    • 路径: Unreal Engine /Source//.Build.cs
    • 依赖代码:
      public class HIVESDKV4Tester : ModuleRules
      {
              public HIVESDKV4Tester(ReadOnlyTargetRules Target) : base(Target)
              {
                      PublicDependencyModuleNames.AddRange(new string[] { ... Others..., "HIVESDK(delete)"});
              }
      }
      

由于删除接口包会改变项目结构,您必须重新启动虚幻编辑器以进行新的编译。
当您重新启动虚幻编辑器时,编译会根据更改后的项目结构自动进行。然而,如果从先前项目结构编译的二进制文件仍然缓存于 IntermediateBinaries 文件夹中,则会发生构建错误。在这种情况下,请删除 IntermediateBinaries 文件夹,并重新启动虚幻编辑器以重新编译和重建。

删除平台包

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

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

由于删除平台包会改变项目结构,请重新启动虚幻编辑器以进行编辑器重建。

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

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


注意事项

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

Warning

WebBrowser CEF 目前没有更新或维护,因此应用它可能会面临安全问题。