安装Android的CodeWorks

安装Android的CodeWorks的流程指南

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用户的额外设置

若从 Github 下载虚幻引擎4,需执行以下步骤后方可运行CodeWorks for Android 1R7u1安装程序。注意:此操作适用于在Github上下载虚幻引擎4源代码的Windows和Mac操作系统PC。若正在使用启动器中下载的二进制版本,则可跳过此必要设置,立即安装CodeWorks for Android 1R7u1。

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

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

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

GitHub用户的额外设置

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

  1. 从Github下载虚幻引擎4并解压后,运行 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

    GitHub

    [EngineSyncLocation]\UE4\Engine\Extras\Android

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

    点击放大图像。

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

    点击放大图像。

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

    点击放大图像。

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

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

    点击放大图像。

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

    点击放大图像。

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

    点击放大图像。

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

    点击放大图像。

  10. 点击 下一步(Next) 按钮继续安装。

    点击放大图像。

  11. 点击 完成(Finish) 按钮完成安装。

    点击放大图像。

  12. 点击 按钮重启PC。

    AndroidWorks_12.png

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

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

    安装类型

    位置

    二进制

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

    GitHub

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

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

    点击放大图像。

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

    点击放大图像。

  4. 点击 下一步(Next)

    点击放大图像。

  5. 点击 下一步(Next)

    点击放大图像。

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

    点击放大图像。

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

    点击放大图像。

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

    点击放大图像。

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

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

    点击放大图像。

  11. 点击 完成(Finish) 按钮完成安装。

    点击放大图像。

    从Github下载虚幻引擎4并完成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] 文件夹。

    点击放大图像。

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

    点击放大图像。

  3. 在终端中输入 ls -l 将显示目录内容的长清单。

    点击放大图像。

    文件的权限设置会告知 CodeWorksforAndroid-1R6u1-linux-x64.run 未准备好执行。在运行CodeWorks for Android二进制文件之前,需要修改文件的访问权限,以允许"execute"权限。

  4. 若要修改 CodeWorksforAndroid-1R6u1-linux-x64.run 的文件权限设置,在终端中输入 chmod +x CodeWorksforAndroid-1R6u1-linux-x64.run,使其能够如普通可执行文件一样运行。

    点击放大图像。

    如欲了解 chmod 命令的更多内容,可在终端中输入 man chmod,阅读包含 chmod 工作原理的手册页面。

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

    点击放大图像。

    图中高亮显示的文件权限设置表示CodeWorks for Android 1R6u1二进制文件已准备好执行。

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

    点击放大图像。

    请确保电脑的网络连接正常,然后继续下一步。

  7. CodeWorks for Android 1R6u1二进制文件解包 NVIDIA CodeWorks for Android 安装程序后将出现 安装程序欢迎(Installer Welcome) 窗口,弹出点击 下一步(Next)取消(Cancel) 的提示。

    点击放大图像。

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

    点击放大图像。

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

    点击放大图像。

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

    点击放大图像。

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

    点击放大图像。

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

    点击放大图像。

  13. 条款和条件(Terms and Conditions) 窗口出现后,请阅读所有 条款和条件(Terms and Conditions),然后选择 接受全部(Accept All) 复选框。

    点击放大图像。

  14. 现在,点击 接受(Accept) 按钮开始安装进程。

    点击放大图像。

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

    点击放大图像。

  16. 安装完成(Installation Complete) 窗口出现后,点击 完成(Finish) 按钮完成安装。

    点击放大图像。

  17. 进入下一步前必须重启电脑。

    点击放大图像。

    若无需使用Ubuntu的GUI,可在终端中输入`sudo reboot` 重启电脑。

最终结果

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

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