Unreal Engine 4

本指南说明安装 Hive SDK 后需要执行的任务。

设置自动旋转屏幕功能¶

当屏幕方向设置为同时支持横屏和竖屏时，需要进行以下设置。

Android¶

对于 Android 应用构建，如果将屏幕方向设置为同时支持横屏和竖屏，则需要进行以下代码修改，才能使自动旋转屏幕功能正常工作。

1. 前往 /Engine/Build/Android/Java/src/com/epicgames/ue4/GameActivity.java.template。
2. 添加 HiveActivity.onConfigurationChanged() API。

   @Override
   public void onConfigurationChanged(Configuration newConfig)
   {
   HiveActivity.onConfigurationChanged(this, newConfig); // Add
   super.onConfigurationChanged(newConfig);
   
   
   // forward the orientation
   boolean bPortrait = newConfig.orientation == Configuration.ORIENTATION_PORTRAIT;
   nativeOnConfigurationChanged(bPortrait);
   }
   

iOS¶

若要在 iOS 上正常使用双向屏幕旋转，请在 Unreal Engine 的 IOSAppDelegate.cpp 文件中实现屏幕旋转相关方法 application(\_:supportedInterfaceOrientationsFor:)。此方法会返回要应用于游戏的 UIInterfaceOrientationMask 值。仅横屏游戏返回 landscape，仅竖屏游戏返回 portrait，同时支持横屏和竖屏的游戏返回 landscape 和 portrait。

将以下代码添加到 /Engine/Source/Runtime/ApplicationCore/Private/IOS/IOSAppDelegate.cpp。

- (UIInterfaceOrientationMask)application:(UIApplication *)application supportedInterfaceOrientationsForWindow:(UIWindow *)window
{
  // TODO: Landscape-only game
  return UIInterfaceOrientationMaskLandscape;
  // TODO: Portrait-only game
  return UIInterfaceOrientationMaskPortrait;
  // TODO: Game that supports both landscape and portrait
  return UIInterfaceOrientationMaskAll;
}

设置 Swift 兼容性 (iOS)¶

在 iOS 开发环境中，为了使 Unreal Engine 4 与 Swift 语言兼容，请在以下文件中添加带有 'Add' 注释的行或代码块。

Engine/Source/Programs/UnrealBuildTool/ProjectFiles/Xcode/XcodeProject.cs

    {
       Content.Append("\t\t\t\t\"PRODUCT_BUNDLE_IDENTIFIER[sdk=iphoneos*]\" = " + IOS_BUNDLE + ";" + ProjectFileGenerator.NewLine);
    }
    // Add
    if (ProjectFile != null)
    {
        Content.Append("\t\t\t\tSWIFT_VERSION = 5.0;" + ProjectFileGenerator.NewLine);
        Content.Append("\t\t\t\tSWIFT_OBJC_BRIDGING_HEADER = \"" + GamePath + "/dummy-Bridging-Header.h\";" + ProjectFileGenerator.NewLine);
    }
   // Add End
}
if (TVOSRunTimeVersion != null)
{

if (XcodeProjectFileGenerator.bGeneratingRunIOSProject)
{
   Content.Append("\t\t\t\tALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES = YES;"+ ProjectFileGenerator.NewLine); // Add
   Content.Append("\t\t\t\tINFOPLIST_FILE = \"" + IOSInfoPlistPath + "\";" + ProjectFileGenerator.NewLine);
   Content.Append("\t\t\t\tCODE_SIGN_ENTITLEMENTS = \"" + IOSEntitlementPath + "\";" + ProjectFileGenerator.NewLine);
}

Content.Append("\t\t\t\t\"INFOPLIST_FILE[sdk=macosx*]\" = \"" + MacInfoPlistPath + "\";" + ProjectFileGenerator.NewLine);
if (IOSRunTimeVersion != null)
{
   Content.Append("\t\t\t\tALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES = YES;"+ ProjectFileGenerator.NewLine); // Add
   Content.Append("\t\t\t\t\"INFOPLIST_FILE[sdk=iphoneos*]\" = \"" + IOSInfoPlistPath + "\";" + ProjectFileGenerator.NewLine);
   Content.Append("\t\t\t\t\"CODE_SIGN_ENTITLEMENTS[sdk=iphoneos*]\" = \"" + IOSEntitlementPath + "\";" + ProjectFileGenerator.NewLine);
}

Engine/Source/Programs/UnrealBuildTool/Platform/IOS/IOSToolChain.cs

    Result += " -Xlinker \\\"" + Path.GetDirectoryName(OutputFile.AbsolutePath) + "\\\"";
}
Result += " -Xlinker -rpath -Xlinker /usr/lib/swift";  // Add
Result += " -dead_strip";
Result += " -m" + GetXcodeMinVersionParam() + "=" + ProjectSettings.RuntimeVersion;
Result += " -Wl";

设置 entitlements (iOS)¶

Unreal Engine 会在构建时通过 UnrealBuildTool 动态创建用于签名的 entitlements 文件。请按以下方式添加所需的 entitlement 项。

• 通过项目设置添加：部分通用 entitlement 项可以直接在 Unreal Editor 的 Project Settings 菜单中启用。
• 通过修改引擎源代码添加：Project Settings 不支持的其他项目，必须直接修改以下 UnrealBuildTool 引擎源文件中的 entitlements 生成代码来添加。
  • 要修改的文件：Engine/Source/Programs/UnrealBuildTool/Platform/IOS/IOSExport.cs

Hive SDK 各功能所需的 entitlement 项及添加方法如下。请仅添加应用使用的功能对应的项，这些功能也必须在 provisioning profile 中作为 capability 启用。有关各项的详细说明，请参阅 Apple 官方文档。

修改 IOSExport.cs 时，请在以下位置的 'Add' 和 'Add End' 之间添加所需项目。

Text.AppendLine( "<dict>");
Text.AppendLine( "\t<key>get-task-allow</key>");
Text.AppendLine(string.Format( "\t<{0}/>", bForDistribution ? "false": "true"));

// Add - Add the required entitlement entries. The following is a Game Center example.
Text.AppendLine("\t<key>com.apple.developer.game-center</key>");
Text.AppendLine("\t<true/>");
// Add End

if (bCloudKitSupported) {
    if (iCloudContainerIdentifiersXML != "")

构建后，请按如下方式确认 entitlements 是否已应用到应用。

codesign -d --entitlements :- {构建后的 .app 路径}

应用 HIVEAppDelegate (iOS)¶

从 Hive SDK v4 26.4.1 开始，HIVEAppDelegate swizzling 会在 Hive SDK 插件内部自动执行。应用启动时插件会自动处理，因此无需在应用代码中进行额外操作。