本文介绍如何快速的将 GME SDK(Unreal 版本)集成到您的 Unreal 项目中。
开发环境要求
UnrealEngine 4.22 及以上版本。
Windows 或 Mac平台设备。
能运行 UnrealEngine 工程的配置环境。
步骤1:下载SDK
1. 请先下载相关 Demo 及 SDK。详细下载链接请参见 SDK 下载指引。
2. 在界面中找到 Unreal 版本的 SDK 资源。
3. 单击下载。下载完的 SDK 资源解压后有以下几个部分。文件说明如下表:
文件名 | 说明 | 作用 |
GMESDK.uplugin | uplugin 文件 | 插件配置文件 |
Resources | 插件资源文件 | 插件资源文件 |
Source | SDK 文件 | SDK 各平台库文件以及代码文件(例如头文件) |
Unreal SDK 平台支持:
步骤2:导入 GME SDK 到项目中
游戏工程的根目录(xxxx.uproject文件所在目录)下如果不存在 Plugins 文件夹,先新建一个,然后将 GME SDK 拷入 Plugins 文件夹,完成该步骤后的目录结构如下


步骤3:编译插件
刷新 C++工程(Visual studio/Xcode),打开 C++工程,可以看到类似下图的目录结构,然后编译游戏。


步骤4:编译完成
编译完成后重启 UE Editor,在 UE Editor 中打开插件管理器,可以看到 GME SDK 已经引入工程了,确定 GME SDK 是 Enabled 状态。


步骤5:新增 GME SDK 依赖
在游戏工程的 .build.cs 文件中新增 GME SDK 的依赖。


不同 Unreal 版本适配工作
1. Unreal Engine 4.21及以上版本
如果是使用 Unreal Engine 4.21及以上版本,下载使用 GME Unreal Engine 示例代码后要添加以下代码:
AUEDemoLevelScriptActor::AUEDemoLevelScriptActor(){PrimaryActorTick.bCanEverTick = true;}
说明:
在默认的情况下,tick 为关闭状态,必须手动开启。
2. Unreal Engine 4.26版本
Mac 系统编译 Demo 时,出现编译错误:variable 'Xi' set but not used [-Werror,-Wunused-but-set-variable]
解决方法:
修改
/Users/Shared/Epic\\ Games/UE_4.26/Engine/Source/Programs/UnrealBuildTool/Platform/IOS/IOSToolChain.cs和/Users/Shared/Epic\\ Games/UE_4.26/Engine/Source/Programs/UnrealBuildTool/Platform/Mac/MacToolChain.cs两个文件,将 Result += " -Wall -Werror";改为Result += " -Werror";

打开 UnrealBuildTool 工程,重新编译后再重新打开 UE,打包 MAC 和 iOS 都正常了。

