Choose your operating system:
Windows
macOS
Linux
虚幻引擎4使用特殊版本的Android软件开发套件(SDK),名为 CodeWorks for Android 。其包含使用虚幻引擎开发Android项目所需的所有SDK和本地开发套件(NDK)。虽然当前在Windows上使用的是1R7u1版本,在Linux上用的是1R6u1版本,但我们仍计划使用后续版本的CodeWorks。
如果已安装Android SDK的其他版本(或CodeWorks for Android的更早版本),建议您将其卸载,使用虚幻引擎自带的CodeWorks for Android安装程序来进行安装。 以下部分将讲述CodeWorks的安装流程。
如果已经安装了正确版本的CodeWorks for Android,但丢失了环境变量,可以使用编辑器中的 编辑(Edit) > 项目设置(Project Settings) > Android SDK 属性直接将编辑器指向安装位置。
必要设置
源代码用户所需的额外设置
假如你在使用虚幻引擎的源代码编译版本,比如你从 Github 下载的版本,那么你就需要执行以下步骤后方可运行CodeWorks for Android 1R7u1安装程序。注意:此操作适用于在Github上下载虚幻引擎4源代码的Windows和Mac操作系统PC。若正在使用启动器中下载的二进制版本,则可跳过此必要设置,立即安装CodeWorks for Android 1R7u1。
-
下载并解压源代码后,运行 Setup.bat 文件下载必需文件及 CodeWorks for Android 1R7u1 安装程序。
-
Setup.bat 完成运行后,找到CodeWorks for Android 1R7u1安装程序,并按照以下说明运行。
在Mac上,需安装 Java 8 方可安装CodeWorks for Android 1R7u1。可从 此处 下载该程序。
源代码用户所需的额外设置
假如你用的是源码版本的虚幻引擎,例如从 GitHub 下载的版本。你还需要执行以下步骤才能运行CodeWorks for Android 1R7u1安装程序。注意:下列操作适用于在Github上下载虚幻引擎4源代码的Windows和Mac操作系统PC。若使用的是从launcher下载的二进制版本,可跳过此设置,进入后续步骤。
-
等你下载并解压虚幻引擎的源代码后,运行 Setup.command 文件下载必需文件及CodeWorks for Android 1R7u1安装程序。
-
Setup.command 完成运行后,找到CodeWorks for Android 1R7u1安装程序,按照以下步骤执行操作。
请确保安装了Java开发工具包8(JDK 8),并将
JAVA_HOME
环境变量设为Java开发工具包(JDK)的正确版本。在终端中输入
echo $JAVA_HOME
即可验证
JAVA_HOME
是否正确设置。若未看到正确的JDK版本,
下载JDK 8
,并将其安装到Linux电脑上,同时确保将
JAVA_HOME
环境变量设为新安装的JDK。
在继续操作之前,请注意:Linux上的目前不支持Android Vulkan。
安装
强烈建议在关闭编辑器和启动程序后再安装CodeWorks for Android,以确保安装不出现任何问题。
-
前往 Engine > Extras > Android 文件夹。
CodeWorks for Android 1R7u1安装程序需要成功安装Visual Studio。
安装类型
位置
二进制版本
[EngineInstallLocation]\Unreal Engine[EngineVersion]\Engine\Extras\Android
源代码版本
[EngineSyncLocation]\UE4\Engine\Extras\Android
-
双击 CodeWorksforAndroid-1R7u1-windows.exe 文件启动安装进程。
-
点击第一个窗口上的 下一步(Next) 按钮开始安装进程。
-
点击 下一步(Next) 按钮继续。
-
设置CodeWorks for Android 1R7u1的下载和安装位置。可将该设置留为默认位置。
-
选择是否要启用数据使用收集,然后点击 下一步(Next) 按钮。无论是否启用均不会影响进一步设置,且完全取决于您团队的决断。
-
确保将安装 CodeWorks for Android 1R7u1 并点击 下一步(Next) 按钮。
-
若同意许可条款,点击标有 接受全部(Accept All) 的复选框,然后按 接受(Accept) 按钮。
-
新窗口将弹出,显示CodeWorks for Android 1R7u1所需工具的下载和安装进程。完成此部分操作需连接互联网。基于互联网连接速度,该过程所花从数分钟到数小时不等。
-
点击 下一步(Next) 按钮继续安装。
-
点击 完成(Finish) 按钮完成安装。
-
点击 是 按钮重启PC。
假如你用的是源码版本的虚幻引擎,例如从Github下载的版本,CodeWorks for Android 1R7u1完成安装后,你还需要重新启动PC或Mac设置环境变量,然后再次运行 Setup.bat 文件来下载所需的Android开发文件。
-
前往 Engine > Extras > AndroidWorks 文件夹。
安装类型
位置
二进制版本
[EngineInstallLocation]\Unreal Engine[EngineVersion]\Engine\Extras\AndroidWorks\Mac
源代码版本
[EngineSyncLocation\UE4\Engine\Extras\AndroidWorks\Mac
-
双击 CodeWorks for Android 1R7u1-osx.dmg 加载CodeWorks for Android 1R7u1安装程序。
-
双击CodeWorks for Android 1R7u1安装程序图标,开始安装进程。
-
点击 下一步(Next) 。
-
点击 下一步(Next) 。
-
指定CodeWorks for Android 1R7u1的安装位置,然后按 下一步(Next) 按钮。可使用默认位置。
-
显示CodeWorks for Android 1R7u1组件管理器后,点击 下一步(Next) 按钮开始下载和安装进程。
-
若同意许可条款,点击标有 全部接受(Accept All) 的勾选框,然后点击 接受(Accept) 按钮。
-
CodeWorks for Android 1R7u1组件管理器将开始下载并安装必要工具。完成此部分操作需连接互联网。该进程可能需要几分钟到几小时不等,具体时间取决于网速。
-
所有内容安装完毕后将显示以下窗口。点击 下一步(Next) 按钮继续。
-
点击 完成(Finish) 按钮完成安装。
假如你用的是源代码版本的虚幻引擎,例如从Github下载的版本,那么完成CodeWorks for Android 1R7u1的安装后,你需要重新启动Mac设置环境变量,然后再次运行 Setup.command 文件来下载所需的Android开发文件。
CodeWorks for Android 1R7u1安装完毕后,需执行以下操作来编辑Bash文件:
-
打开Mac终端。
-
在终端中输入 nano ~/.bash_profile 。
-
向下滚动到文件末尾并添加 export JAVA_HOME="/Library/Java/JavaVirtualMachines/jdk1.8.0_121.jdk/Contents/Home"`。
以上为默认路径,若安装在其他位置,路径必须指向 jdk1.8.0_121.jdk/Contents/Home 。
-
按 CTRL + X 退出bash,按 Y 保存更改,然后按 Enter 确认更改,最后重启Mac。
-
Mac重启后,打开终端,输入**Monitor** 并按回车键。若一切设置正确,应出现Android Device Monitor启动画面。
Windows和Mac上的虚幻引擎使用CodeWorks for Android 1R6u1,而Linux上当前使用1R6u1。
-
打开终端,利用
cd
命令将工作目录设为包含已编译引擎的[UE4Root]
文件夹。 -
在
[UE4Root]
文件夹内,通过在终端中输入以下字符串,前往CodeWorks for Android二进制文件( CodeWorksforAndroid-1R6u1-linux-x64.run ):cd Engine/Extras/AndroidWorks/Linux
。 -
在终端中输入
ls -l
将显示目录内容的长清单。文件的权限设置会告知 CodeWorksforAndroid-1R6u1-linux-x64.run 未准备好执行。在运行CodeWorks for Android二进制文件之前,需要修改文件的访问权限,以允许"execute"权限。
-
若要修改
CodeWorksforAndroid-1R6u1-linux-x64.run
的文件权限设置,在终端中输入chmod +x CodeWorksforAndroid-1R6u1-linux-x64.run
,使其能够如普通可执行文件一样运行。如欲了解
chmod
命令的更多内容,可在终端中输入man chmod
,阅读包含chmod
工作原理的手册页面。 -
现在,在终端中输入
ls -l
。图中高亮显示的文件权限设置表示CodeWorks for Android 1R6u1二进制文件已准备好执行。
-
要运行CodeWorks for Android二进制文件,在终端中输入
./CodeWorksforAndroid-1R6u1-linux-x64.run
。请确保电脑的网络连接正常,然后继续下一步。
-
CodeWorks for Android 1R6u1二进制文件解包 NVIDIA CodeWorks for Android 安装程序后将出现 安装程序欢迎(Installer Welcome) 窗口,弹出点击 下一步(Next) 或 取消(Cancel) 的提示。
-
在 安装程序欢迎(Installer Welcome) 窗口中点击 下一步(Next) 按钮开始安装进程。
-
现在在 Android开发者欢迎窗口(Android Developer's Welcome Window) 中,点击 下一步(Next) 按钮继续安装进程。
-
指定CodeWorks for Android的安装目录。
-
点击 下一步(Next) 按钮在电脑上下载并安装CodeWorks。
-
确认正在安装 CodeWorks for Android 1R6u1 ,然后在 Android组件管理器(Android Component Manager) 窗口中点击 下一步(Next) 按钮。
-
条款和条件(Terms and Conditions) 窗口出现后,请阅读所有 条款和条件(Terms and Conditions) ,然后选择 接受全部(Accept All) 复选框。
-
现在,点击 接受(Accept) 按钮开始安装进程。
-
安装程序完成安装进程后,点击 下一步>(Next>) 按钮继续。
-
安装完成(Installation Complete) 窗口出现后,点击 完成(Finish) 按钮完成安装。
-
进入下一步前必须重启电脑。
若无需使用Ubuntu的GUI,可在终端中输入`sudo reboot` 重启电脑。
最终结果
安装完成后,所有的必需Android SDK便已安装,可以构建在Android设备上运行的虚幻引擎4项目了。