1. 必需的Android设置

安装CodeWorks for Android 1R6u1 SDK。

Windows
MacOS
Linux
On this page

步骤

开始Android开发的第一步是安装CodeWorks for Android 1R6u1,这能确保部署到Android设备的必需程序和代码都已准备就绪。以下部分将说明如何将CodeWorks for Android 1R6u1安装到开发电脑上。

如已安装CodeWorks for Android 1R6u1但环境变量已丢失,则可使用编辑器中的 编辑菜单(Edit Menu) > 项目设置(Project Settings) > Android SDK 属性略过以下步骤并将编辑器直接指向安装路径。

强烈建议在编辑器和Launcher两者皆关闭时安装CodeWorks for Android 1R6u1,确保安装不存在问题。

  1. 如要安装CodeWorks for Android 1R6u1,须导航至 Engine > Extras > Android 文件夹。

    CodeWorks for Android 1R6u1安装程序需要安装Visual Studio才能成功完成。支持的版本是2013、2015和2017。

    安装类型

    位置

    二进制

    [EngineInstallLocation]\Unreal Engine[EngineVersion]\Engine\Extras\Android

    GitHub

    [EngineSyncLocation]\UE4\Engine\Extras\Android

    如果虚幻引擎4下载自 Github,在运行CodeWorks for Android 1R6u1安装程序前则需要执行以下步骤。注意:从Github上下载虚幻引擎4源代码的Windows和Mac系统电脑均需要执行此操作。如果使用的是从launcher下载的二进制版本,则可跳过此部分,直接安装CodeWorks for Android 1R6u1。

    1. 从Github下载虚幻引擎4并解压后,运行 Setup.bat 文件来下载必需的文件,以及 CodeWorks for Android 1R6u1 安装程序。

    2. Setup.bat 完成运行后,找到并运行CodeWorks for Android 1R6u1安装程序,按以下步骤进行操作。

  2. 双击 CodeWorksforAndroid-1R6u1-windows.exe 开始安装进程。

    AndroidWorks_11.png

  3. 点击第一个窗口上的 下一步(Next) 按钮来开始安装进程。

    AndroidWorks_00.png

  4. 点击 下一步(Next) 按钮继续。

    AndroidWorks_01.png

  5. 设置CodeWorks for Android 1R6u1的下载和安装路径,然后点击 下一步(Next) 按钮。

    AndroidWorks_02.png

    可以沿用默认安装路径。

  6. 确认安装的是 CodeWorks for Android 1R6u1 版本,然后点击 下一步(Next) 按钮。

    AndroidWorks_03.png

  7. 如果同意授权条款,则点击标有 接受所有(Accept All) 的勾选框,然后按下 接受 按钮。

    AndroidWorks_04.png

  8. 将出现一个新窗口,显示CodeWorks for Android 1R6u1工具的下载和安装进程。

    完成这部分操作需要网络连接。所花时间从数分钟到数小时不等,具体取决于网络连接速度。

    AndroidWorks_06.png

  9. 按下 下一步(Next) 按钮来继续CodeWorks for Android 1R6u1的安装。

    AndroidWorks_09.png

  10. 按下 完成 按钮完成安装。

    AndroidWorks_10.png

  11. 最后按下 按钮重新启动电脑。

    AndroidWorks_12.png

    从Github下载虚幻引擎4并完成CodeWorks for Android 1R6u1的安装后,重新启动PC或Mac设置环境变量,然后再次运行 Setup.bat 文件来下载所需的Android开发文件。

如已安装CodeWorks for Android 1R6u1但环境变量已丢失,则可使用编辑器中的 编辑菜单(Edit Menu) > 项目设置(Project Settings) > Android SDK 属性略过以下步骤并将编辑器直接指向安装路径。

强烈建议在编辑器和Launcher两者皆关闭时安装CodeWorks for Android 1R6u1,确保安装不存在问题。

在将CodeWorks for Android 1R6u1安装到Mac之前,首先需要确保已安装Java 8。使用下方的链接来下载并安装Java 8。

  1. 如要安装CodeWorks for Android 1R6u1,须导航至 Engine > Extras > Android 文件夹。

    安装类型

    位置

    二进制

    [EngineInstallLocation]\Unreal Engine[EngineVersion]\Engine\Extras\AndroidWorks\Mac

    GitHub

    [EngineSyncLocation\UE4\Engine\Extras\AndroidWorks\Mac

    如果虚幻引擎4下载自 Github,在运行CodeWorks for Android 1R6u1安装程序前则需要执行以下步骤。注意:从Github上下载虚幻引擎4源代码的Windows和Mac系统电脑均需要执行以下步骤。如果使用的是从launcher下载的二进制版本,则可跳过此部分,直接安装CodeWorks for Android 1R6u1。

    1. 从Github下载虚幻引擎4并解压后,运行 Setup.command 文件来下载必需的文件,以及CodeWorks for Android 1R6u1安装程序。

    2. Setup.command 完成运行后,找到并运行CodeWorks for Android 1R6u1安装程序,按以下步骤进行操作。

  2. 双击 CodeWorks for Android 1R6u1-osx.dmg 加载CodeWorks for Android 1R6u1安装程序。

    AndroidWorks_Mac_00.png

  3. 双击CodeWorks for Android 1R6u1安装程序图标开始安装进程。

    AndroidWorks_Mac_01.png

  4. 点击 下一步(Next)

    AndroidWorks_Mac_02.png

  5. 点击 下一步(Next)

    AndroidWorks_Mac_03.png

  6. 指定CodeWorks for Android 1R6u1的安装路径,然后按下 下一步(Next) 按钮。

    可以沿用默认安装路径。

    AndroidWorks_Mac_04.png

  7. CodeWorks for Android 1R6u1 Component Manager出现后,按下 下一步(Next) 按钮开始下载和安装进程。

    AndroidWorks_Mac_05.png

  8. 如果同意授权条款,则点击标有 接受所有(Accept All) 的勾选框,然后按下 接受 按钮。

    AndroidWorks_Mac_06.png

  9. CodeWorks for Android 1R6u1 Component Manager现在便会开始下载和安装必需的工具。

    完成这部分操作需要网络连接。所花时间从数分钟到数小时不等,具体取决于网络连接速度。

  10. 一切内容安装完成后将出现以下窗口。点击 下一步(Next) 按钮继续。

    AndroidWorks_Mac_08.png

  11. 点击 完成 按钮来完成CodeWorks for Android 1R6u1的安装。

    AndroidWorks_Mac_09.png

    从Github下载虚幻引擎4并完成CodeWorks for Android 1R6u1的安装后,重新启动Mac设置环境变量,然后再次运行 Setup.command 文件来下载所需的Android开发文件。

CodeWorks for Android 1R6u1安装完毕后,需要执行以下操作来编辑Bash文件:

  1. 打开Mac终端。

    JH_01.png

  2. 在终端类型中选择 nano ~/.bash_profile

    JH_02.png

  3. 滚动到文件末尾并添加 export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_121.jdk/Contents/Home

    JH_03.png

    以上为默认路径,如果在别处安装,须确保路径指向 jdk1.8.0_121.jdk/Contents/Home

  4. 按下 CTRL + X 组合键退出bash,然后按下 Y 保存修改,然后按下 回车键 确认修改并重启Mac。

  5. Mac重启后,打开终端并输入 Monitor,然后按下回车键。如所有内容均已正确设置,Android设备监视器启动画面将出现。

    JH_04.png

虚幻引擎4使用特殊版本的Android软件开发套件(SDK),称为CodeWorks for Android。CodeWorks for Android是设置SDK和原生开发套件(NDK)最简单的方法,SDK和NDK是使用虚幻引擎4开发Android项目必不可少的。如果您安装了较旧版本(1R5之前的版本)的Android SDK(或较旧版本的CodeWorks for Android),我们建议您将它们卸载,使用虚幻引擎4随附的CodeWorks for Android安装程序安装CodeWorks for Android

我们已在虚幻引擎4中捆绑了CodeWorks for Android安装程序,确保您的Android SDK与引擎兼容。需要注意的是,截至虚幻引擎版本4.16,引擎包含的是CodeWorks for Android 1R6u1。

安装CodeWorks for Android

为了向您显示如何开始在Linux上进行Android开发,我们将使用CodeWorks for Android 1R6u1和虚幻引擎版本4.14。在安装CodeWorks for Android 1R6u1之前,引擎应处于关闭状态。此外,还请确保您安装了Java Development Kit 8(JDK 8),并将`JAVA_HOME`环境变量设置为正确版本的Java Development Kit(JDK)。要验证`JAVA_HOME`设置是否正确,在终端中输入`echo $JAVA_HOME`。如果您没看到正确的JDK版本download JDK 8 ,并在Linux计算机上安装正确版本,并确保将`JAVA_HOME`环境变量设置为新安装的SDK。

在继续之前,请注意目前不支持Linux上的Android Vulkan。

  1. 首先,打开终端并浏览到[UE4Root]文件夹,其中包含编译好的引擎(使用`cd`命令并切换shell工作目录)。

    LinuxAndroid_Step0.png

  2. [UE4Root]文件夹内部,通过在终端中输入以下字符串,浏览到CodeWorks for Android 1R6u1二进制文件(CodeWorksforAndroid-1R6u1-linux-x64.run):cd Engine/Extras/AndroidWorks/Linux.

    LinuxAndroid_Step1.png

  3. 现在,在终端中输入`ls -l`,此时会显示一个很长的目录内容列表。

    LinuxAndroid_Step2.png

    通过文件权限设置,您可知道 CodeWorksforAndroid-1R6u1-linux-x64.run 尚未准备好执行。在运行CodeWorks for Android 1R6u1二进制文件之前,必须将文件访问权更改为允许"execute"权限。

  4. 要更改`CodeWorksforAndroid-1R6u1-linux-x64.run`的权限设置,使其能够像一般可执行文件一样运行,请在终端中输入`chmod +x CodeWorksforAndroid-1R6u1-linux-x64.run`。

    LinuxAndroid_Step3.png

    如果您想要进一步了解`chmod`命令,请在终端中输入`man chmod`,以阅读包括`chmod`工作方式的手册页面。

  5. 现在,在终端中输入`ls -l`。

    LinuxAndroid_Step4.png

    图像中高亮显示的文件权限表示,CodeWorks for Android 1R6u1二进制文件已经准备就绪,可以执行。

  6. 要运行CodeWorks for Android二进制文件,请在终端中输入./CodeWorksforAndroid-1R6u1-linux-x64.run

    LinuxAndroid_Step5.png

    请确保您的计算机具有有效的网络连接,然后再继续下一步。

  7. 在CodeWorks for Android 1R6u1二进制解包 NVIDIA CodeWorks for Android 安装程序后,您会看到 安装程序欢迎(Installer Welcom) 窗口,并提示您单击 下一步(Next)取消(Cancel)

    LinuxAndroid_Step6.png

  8. 安装程序欢迎(Installer Welcom) 窗口,单击 下一步(Next) 按钮以开始安装过程。

    LinuxAndroid_Step7.png

  9. 现在,从 Android开发者欢迎窗口(Android Developer's Welcome Window),单击 下一步(Next) 按钮以继续安装过程。

    LinuxAndroid_Step8.png

  10. 指定应安装和下载CodeWorks for Android 1R6u1的目录。

    LinuxAndroid_Step9.png

  11. 单击 下一步(Next >) 按钮以从NVIDIA下载CodeWorks for Android 1R6u1,之后在计算机上安装CodeWorks。

    LinuxAndroid_Step10.png

  12. 现在,确认您确实在安装 CodeWorks for Android 1R6u1,然后单击 Android组件管理器(Android Component Manager) 窗口中的 下一步(Next) 按钮。

    LinuxAndroid_Step11.png

  13. 条款与条件(Terms and Conditions) 窗口出现后,花些时间阅读所有 条款与条件,然后再选中 全部接受(Accept All) 复选框。

    LinuxAndroid_Step12.png

  14. 现在,单击 接受(Accept) 按钮以开始安装过程。

    LinuxAndroid_Step13.png

  15. 安装程序完成安装过程后,单击 下一步(Next >) 按钮以继续。

    LinuxAndroid_Step14.png

  16. 安装完成(Installation Complete) 窗口打开后,单击 完成(Finish) 按钮以完成安装。

    LinuxAndroid_Step15.png

  17. 确保重启计算机后再进行下一步。

    LinuxAndroid_Note16.png

    如果您不想使用Ubuntu's GUI,可以在终端中输入`sudo reboot`来重启计算机。

最终结果

所有操作完成后,所有的必需Android SDK便已安装,可用于构建在Android设备上运行的虚幻引擎4项目。

Tags
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