虚幻引擎5文档已被迁移至 Epic开发者社区

安装Android的CodeWorks

安装Android的CodeWorks的流程指南

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。

  1. 下载并解压源代码后，运行 Setup.bat 文件下载必需文件及 CodeWorks for Android 1R7u1 安装程序。

  2. Setup.bat 完成运行后，找到CodeWorks for Android 1R7u1安装程序，并按照以下说明运行。

在Mac上，需安装 Java 8 方可安装CodeWorks for Android 1R7u1。可从 此处 下载该程序。

源代码用户所需的额外设置

假如你用的是源码版本的虚幻引擎，例如从 GitHub 下载的版本。你还需要执行以下步骤才能运行CodeWorks for Android 1R7u1安装程序。注意：下列操作适用于在Github上下载虚幻引擎4源代码的Windows和Mac操作系统PC。若使用的是从launcher下载的二进制版本，可跳过此设置，进入后续步骤。

  1. 等你下载并解压虚幻引擎的源代码后，运行 Setup.command 文件下载必需文件及CodeWorks for Android 1R7u1安装程序。

  2. 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，以确保安装不出现任何问题。

  1. 前往 Engine > Extras > Android 文件夹。

    CodeWorks for Android 1R7u1安装程序需要成功安装Visual Studio。

    安装类型

    位置

    二进制版本

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

    源代码版本

    [EngineSyncLocation]\UE4\Engine\Extras\Android

  2. 双击 CodeWorksforAndroid-1R7u1-windows.exe 文件启动安装进程。

    AndroidWorks_11.png

    点击放大图像。

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

    AndroidWorks_00.png

    点击放大图像。

  4. 点击 下一步（Next） 按钮继续。

    AndroidWorks_01.png

    点击放大图像。

  5. 设置CodeWorks for Android 1R7u1的下载和安装位置。可将该设置留为默认位置。

  6. 选择是否要启用数据使用收集，然后点击 下一步（Next） 按钮。无论是否启用均不会影响进一步设置，且完全取决于您团队的决断。

    AndroidWorks_02.png

    点击放大图像。

  7. 确保将安装 CodeWorks for Android 1R7u1 并点击 下一步（Next） 按钮。

    AndroidWorks_03.png

    点击放大图像。

  8. 若同意许可条款，点击标有 接受全部（Accept All） 的复选框，然后按 接受（Accept） 按钮。

    AndroidWorks_04.png

    点击放大图像。

  9. 新窗口将弹出，显示CodeWorks for Android 1R7u1所需工具的下载和安装进程。完成此部分操作需连接互联网。基于互联网连接速度，该过程所花从数分钟到数小时不等。

    AndroidWorks_06.png

    点击放大图像。

  10. 点击 下一步（Next） 按钮继续安装。

    AndroidWorks_09.png

    点击放大图像。

  11. 点击 完成（Finish） 按钮完成安装。

    AndroidWorks_10.png

    点击放大图像。

  12. 点击 是 按钮重启PC。

    AndroidWorks_12.png

    假如你用的是源码版本的虚幻引擎，例如从Github下载的版本，CodeWorks for Android 1R7u1完成安装后，你还需要重新启动PC或Mac设置环境变量，然后再次运行 Setup.bat 文件来下载所需的Android开发文件。

  1. 前往 Engine > Extras > AndroidWorks 文件夹。

    安装类型

    位置

    二进制版本

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

    源代码版本

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

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

    AndroidWorks_Mac_00.png

    点击放大图像。

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

    AndroidWorks_Mac_01.png

    点击放大图像。

  4. 点击 下一步（Next） 。

    AndroidWorks_Mac_02.png

    点击放大图像。

  5. 点击 下一步（Next） 。

    AndroidWorks_Mac_03.png

    点击放大图像。

  6. 指定CodeWorks for Android 1R7u1的安装位置，然后按 下一步（Next） 按钮。可使用默认位置。

    AndroidWorks_Mac_04.png

    点击放大图像。

  7. 显示CodeWorks for Android 1R7u1组件管理器后，点击 下一步（Next） 按钮开始下载和安装进程。

    AndroidWorks_Mac_05.png

    点击放大图像。

  8. 若同意许可条款，点击标有 全部接受（Accept All） 的勾选框，然后点击 接受（Accept） 按钮。

    AndroidWorks_Mac_06.png

    点击放大图像。

  9. CodeWorks for Android 1R7u1组件管理器将开始下载并安装必要工具。完成此部分操作需连接互联网。该进程可能需要几分钟到几小时不等，具体时间取决于网速。

  10. 所有内容安装完毕后将显示以下窗口。点击 下一步（Next） 按钮继续。

    AndroidWorks_Mac_08.png

    点击放大图像。

  11. 点击 完成（Finish） 按钮完成安装。

    AndroidWorks_Mac_09.png

    点击放大图像。

    假如你用的是源代码版本的虚幻引擎，例如从Github下载的版本，那么完成CodeWorks for Android 1R7u1的安装后，你需要重新启动Mac设置环境变量，然后再次运行 Setup.command 文件来下载所需的Android开发文件。

CodeWorks for Android 1R7u1安装完毕后，需执行以下操作来编辑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 保存更改，然后按 Enter 确认更改，最后重启Mac。

  5. Mac重启后，打开终端，输入**Monitor** 并按回车键。若一切设置正确，应出现Android Device Monitor启动画面。

    JH_04.png

Windows和Mac上的虚幻引擎使用CodeWorks for Android 1R6u1，而Linux上当前使用1R6u1。

  1. 打开终端，利用 cd 命令将工作目录设为包含已编译引擎的 [UE4Root] 文件夹。

    LinuxAndroid_Step0.png

    点击放大图像。

  2. 在 [UE4Root] 文件夹内，通过在终端中输入以下字符串，前往CodeWorks for Android二进制文件( 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二进制文件之前，需要修改文件的访问权限，以允许"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 Welcome） 窗口，弹出点击 下一步（Next） 或 取消（Cancel） 的提示。

    LinuxAndroid_Step6.png

    点击放大图像。

  8. 在 安装程序欢迎（Installer Welcome） 窗口中点击 下一步（Next） 按钮开始安装进程。

    LinuxAndroid_Step7.png

    点击放大图像。

  9. 现在在 Android开发者欢迎窗口（Android Developer's Welcome Window） 中，点击 下一步（Next） 按钮继续安装进程。

    LinuxAndroid_Step8.png

    点击放大图像。

  10. 指定CodeWorks for Android的安装目录。

    LinuxAndroid_Step9.png

    点击放大图像。

  11. 点击 下一步（Next） 按钮在电脑上下载并安装CodeWorks。

    LinuxAndroid_Step10.png

    点击放大图像。

  12. 确认正在安装 CodeWorks for Android 1R6u1 ，然后在 Android组件管理器（Android Component Manager） 窗口中点击 下一步（Next） 按钮。

    LinuxAndroid_Step11.png

    点击放大图像。

  13. 条款和条件（Terms and Conditions） 窗口出现后，请阅读所有 条款和条件（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的GUI，可在终端中输入`sudo reboot` 重启电脑。

最终结果

安装完成后，所有的必需Android SDK便已安装，可以构建在Android设备上运行的虚幻引擎4项目了。

欢迎帮助改进虚幻引擎文档！请告诉我们该如何更好地为您服务。
填写问卷调查
取消