安装版本参考

此页面讲述安装版本流程,包括如何编写安装版本脚本的概览。

Windows
MacOS
Linux

开发者们总是在针对不同硬件配置和操作系统寻找有效交付版本解决方案的方式。安装版本 是功能完整的引擎版本,可进行分发,使团队快速开始使用引擎。从技术角度而言,安装版本包含虚幻编辑器的预编译二进制文件,以及开发中每个目标平台和发布配置的静态库。

安装版本进程自动设置制作虚幻引擎 4 安装版本所需的编译包和工具。概括而言,制作安装版本是设置默认目标平台、使用其工具和编辑器编译 UE4、运行测试、以及将 UE4 安装版本部署到目标平台的一系列过程。

制作安装版本

可结合 [UE4Root]/Engine/Build/InstalledBuild.xml 中的安装版本脚本使用 BuildGraph 脚本系统创建安装版本。

创建安装版本的步骤:

  1. 使用以下命令行调用 AutomationTool,用 Win64Mac 替代 [PLATFORM],运行安装版本脚本。还可使用可用的 安装版本脚本选项 配置版本。

    BuildGraph -target="Make Installed Build [PLATFORM]" -script=Engine/Build/InstalledEngineBuild.xml -clean
  2. 导航到虚幻引擎目录中的 LocalBuilds/Engine/ 文件夹,查看创建的安装版本。如指定了不同的发布路径,则导航到该目录。

安装版本脚本选项

InstalledEngineBuild.xml 脚本将制作出启用所有默认选项和平台的安装版本;然而,可使用一套特定选项对其进行配置,以便确定包含哪些平台、向何处发布版本,等等。将 -listonly 选项传至脚本即可查看自定义编译过程的可用选项列表(以及将要编译的节点列表)。

可用选项有:

选项

默认

描述

-set:HostPlatformOnly=[true/false]

false

仅针对主平台制作安装版本的助手选项,因此无需逐个禁用平台

-set:WithWin64=[true/false]

true

包含 Win64 目标平台

-set:WithWin32=[true/false]

true

包含 Win32 目标平台

-set:WithMac=[true/false]

true

包含 Mac 目标平台

-set:WithAndroid=[true/false]

true

包含 Android 目标平台

-set:WithIOS=[true/false]

true

包含 iOS 目标平台

启用此项需要带远程编译设置的 Mac。

-set:WithTVOS=[true/false]

true

包含 tvOS 目标平台

启用此项需要带远程编译设置的 Mac。

-set:WithLinux=[true/false]

true

包含 Linux 目标平台

-set:WithLumin=[true/false]

true

包含 Lumin 目标平台

-set:WithHTML5=[true/false]

true

包含 HTML5 目标平台

-set:WithPS4=[true/false]

false

包含 PS4 目标平台

启用此项需要 PS4 SDK。

-set:WithXboxOne=[true/false]

false

包含 XboxOne 目标平台

启用此项需要 Xbox One SDK。

-set:WithDDC=[true/false]

true

为引擎内容和模板编译独立派生数据缓存

为引擎和模板内容编译独立 派生数据缓存(DDC) 是编译最慢的方面之一。如不需要独立 DDC,可在命令行中附加 -set:WithDDC=false 跳过此步骤。

-set:WithFullDebugInfo=[true/false]

false

为二进制编辑器及打包的应用构建生成完整调试信息

-set:SignExecutables=[true/false]

false

如已将机器对可执行文件签名设为编译过程的一部分,则对生成的可执行文件签名。

-set:AnalyticsTypeOverride=[ID]

N/A

分析事件发送的辨识符

-set:GameConfigurations=[Configurations]

Development;Shipping

指定打包应用的配置

包含额外文件

RuntimeDependencies(在每个模块的 build.cs 文件中设置)自动整理并确定哪些文件将包含在安装版本中。然而无法以此方式添加部分必需文件,因此它们在 [UE4Root]/Engine/Build/InstalledEngineFilters.xml 中被定义。InstalledEngineFilters XML 文件还列出了应排除在版本之外的文件,确定需要被去除或签名的文件类型,并最终决定为什么项目编译 DDC。如果需要在安装版本中包含额外文件,可从 InstalledEngineFilters XML 文件开始。

Select Skin
Light
Dark

Welcome to the new Unreal Engine 4 Documentation site!

We're working on lots of new features including a feedback system so you can tell us how we are doing. It's not quite ready for use in the wild yet, so head over to the Documentation Feedback forum to tell us about this page or call out any issues you are encountering in the meantime.

We'll be sure to let you know when the new system is up and running.

Post Feedback