1. Epic GamesDeveloper
  3. 设置Android SDK和NDK

设置Android SDK和NDK

如何为虚幻引擎设置你的Android开发环境

设置Android SDK和NDK
Prerequisite topics

In order to understand and use the content on this page, make sure you are familiar with the following topics:

如需了解简化的Android SDK设置流程，请参阅 设置Android SDK和NDK指南，该指南可将设置过程部分自动化。 如果你遇到Android SDK安装冲突或需要排查故障，请参阅本指南。

虚幻引擎使用Android Studio随附的Android软件开发套件（SDK）处理所有必要的Android开发组件，包括Android原生开发套件（NDK）。 本页提供了设置Android Studio并确保虚幻引擎正确识别这些组件的演练流程，以及一些用于管理NDK安装和早期引擎版本的故障排除技巧。

如果尝试运行SetupAndroid脚本时未满足所有先决条件，则将无法找到所需的SDK组件。 因此，在排查Android SDK的安装问题时，请通读此页面，因为安装过程取决于按照本文列示的顺序执行步骤。

Android SDK命令行工具在2023年2月更新之后，虚幻引擎4.27到5.1的用户需要编辑本教程中使用的SetupAndroid脚本。 本文档适用于UE 5.4和更高版本。 如果遇到问题，请根据你的虚幻引擎版本参考对应文档。

确保虚幻编辑器和Epic Games启动器都处于关闭状态，以确保安装NDK组件或设置引擎的环境变量时不会出现问题。

如需支持早期版本的虚幻引擎安装，请参阅"手动定位SDK路径"小节。 你可以在Android开发要求页面中找到你的虚幻引擎版本所需的对应NDK版本。

虚幻引擎5.3和更高版本使用jbr (OpenJDK 17)进行其JDK安装，但UE 5.2和之前的版本使用jre (Java 1.8)。 这意味着当你卸载旧版Android Studio时，你可能会丢失jre并导致UE5.2或更早版本中出现错误。

如果你需要支持UE 5.2和更早版本，在继续之前，找到jre目录并将其复制到Android Studio目录之外的地方，避免丢失。 然后你可以在旧版本的虚幻引擎中手动定位此文件夹。 详情请参阅“手动定位SDK路径”。

安装Android Studio

在计算机上设置必要的SDK和NDK组件之前，你需要安装先Android Studio。

请参阅Android开发要求，以了解兼容你当前所用虚幻引擎版本的Android Studio和NDK版本。

  1. 在你的Web浏览器中前往Android Studio归档。 向下滚动到Android Studio Flamingo | 2022.2.1 Patch 2 May 24, 2023。 展开下拉菜单，并为你的操作系统下载相应的安装程序或zip文件。

    在Android Studio归档页面上选择Android Flamingo 2022.2.1 Patch 2 May 24 2023

  2. 运行Android Studio安装程序。 在Android Studio设置（Android Studio Setup）对话框中，点击下一步（Next）以继续。

  3. 在选择组件（Choose Components）对话框中，保持启用默认组件。 点击下一步（Next）以继续。

  4. 在安装位置（Install Locations）对话框中，确保安装位置设置为默认位置。 点击下一步（Next）以继续。

    如果选择自定义安装位置，SetupAndroid脚本将无法找到文件，除非你事先编辑了该文件。 点击 **下一步（Next）** 继续。

  5. 在选择开始菜单文件夹（Choose Start Menu Folder）对话框中，点击安装（Install）以开始安装流程。

  6. 安装完成后，点击下一步（Next）以开始设置组件。

  7. 设置完成后，确保勾选启动Android Studio（Start Android Studio）复选框，并点击完成（Finish）以退出安装程序。

设置Android Studio以供首次使用

首次启动新安装的Android Studio时，请执行以下步骤：

  1. 当出现数据分享（Data Sharing）对话框时，选择是否要给Google发送使用情况统计数据。 如何选择全凭自己意愿，选择任一选项都会继续进入下一步骤。

  2. 在欢迎使用Android Studio（Welcome to Android Studio）对话框中，点击更多操作（More Actions）下拉菜单，然后点击SDK管理器（SDK Manager）。

    欢迎使用Android Studio对话框。 更多操作下拉菜单中高亮显示的SDK管理器选项。

  3. 在Android SDK系统设置中，点击Android SDK位置（Android SDK Location）旁边的编辑（Edit）按钮。

    编辑Android SDK位置

  4. SDK组件设置（SDK Components Setup）对话框中已选择了所需的组件。 点击下一步（Next）以安装组件。

    安装SDK组件

  5. 在验证设置（Verify Settings）窗口中，再次点击下一步（Next）以继续安装。

  6. 安装完成后，点击完成（Finish）。

  7. 在设置（Settings）菜单中，点击SDK工具（SDK Tools）选项卡。 这时将显示可选组件列表。

  8. 勾选显示包装细节（Show Package Details）复选框，以显示所有可用的SDK组件。

  9. 勾选Android SDK命令行工具（最新）（Android SDK Command-line Tools (latest)）复选框。 点击应用（Apply）以下载并安装此组件。

    安装Android SDK命令行工具

  10. 点击确定（OK）以取消窗口并关闭欢迎对话框。

在你的操作系统上完成Android Studio安装

完成上述所有步骤之后，你需要完成安装，确保在继续之前充分设置好你的环境。 每个操作系统都需要不同的步骤来完成安装。

操作系统 必要操作

Windows

重启你的计算机。

Linux

关闭你的终端窗口并重新打开它。

macOS

关闭你的终端窗口并重新打开它，或注销之后再重新登录。

重置或验证你的环境变量

此小节中的步骤主要适用于从UE 5.2及更早版本迁移到UE 5.3及更高版本的用户，他们可能需要重置环境变量。 如果你使用的是全新的UE和Android Studio版本，请继续进入下一个小节。

这对于使用AGDE进行调试的用户尤为重要，因为UE和AGDE现在都以jbr目录为目标，不需要单独的环境变量。

  1. 打开计算机的系统属性（System Properties）。

  2. 点击环境变量（Environment Variables）按钮。

  3. 如果存在名为AGDE_JAVA_HOME的环境变量，删除它。 此变量已不再需要，因为虚幻引擎和AGDE现在使用同一Java版本。

  4. 重置或验证以下环境变量。

    环境变量 预期值

    JAVA_HOME

    C:\Program Files\Android\Android Studio\jbr

    ANDROID_HOME

    C:\Users(Username)\AppData\Local\Android\Sdk

    NDK_ROOT

    C:\Users(Username)\AppData\Local\Android\Sdk\ndk(NDK Version Number)

    NDKROOT

    C:\Users(Username)\AppData\Local\Android\Sdk\ndk(NDK Version Number)

    将(Username)替换为你的用户名，(NDK Version Number)替换为所需安装版本号的目录名称。

    为了方便修复，请删除你的环境变量。 后续步骤中，它们将被SetupAndroid脚本替换。

如果需要支持早期版本的虚幻引擎，建议按照上述步骤保持与当前和未来虚幻引擎版本的兼容性。 要保留先前版本的虚幻引擎的路径，建议你编辑你的项目设置，并手动定位各个Android SDK、NDK和JDK版本的对应SDK路径。 详情请参阅下文的"手动定位SDK路径"。

运行SetupAndroid脚本

安装必要的Android SDK组件后，你可以使用SetupAndroid脚本下载并安装相应版本的Android NDK。

  1. 打开Engine/Extras/Android目录，并为你的操作系统运行相应的SetupAndroid脚本：

    • SetupAndroid.bat – Windows

    • SetupAndroid.command – Mac

    • SetupAndroid.sh – Linux.

  2. 脚本提示你接受Android SDK许可协议。 键入Y并按下Enter即可接受。

  3. 安装完成后，按任意键关闭命令提示符。

  4. 重启计算机，使所有更改生效。

NDK的安装目录应为C:/Users/[Username]/AppData/Local/Android/SDK/ndk/，其中[Username]是你计算机的登录名称。 你应该在此位置看到一个包含所需NDK版本的文件夹。

手动定位SDK路径

如果你按照上述说明操作而未遇到问题，虚幻引擎将自动关联Android SDK、当前Android NDK版本和Java开发套件（JDK）的SDK路径。 但是，如果你使用的是早期版本的虚幻引擎和Android Studio，可能需要手动定位SDK路径以使其兼容。 如果要从UE 5.0、5.1或5.2迁移到UE 5.3或更高版本，你很可能需要执行该操作。

要找到SDK路径，打开编辑（Edit） > 项目设置（Project Settings），然后转到平台（Platforms） > Android > Android SDK分段。

在虚幻编辑器的Project Settings/Platforms/Android/Android SDK目录下配置手动SDK

如果这些字段是空白的，UE将回退到先前分段中安装流程中使用的一组默认路径。 如果你安装了这些组件的多个版本，或在非标准目录下安装了这些组件，你可以在此处手动提供其路径。 或者，你也可以打开BaseEngine.ini并在[/Script/AndroidPlatformEditor.AndroidSDKSettings]分段下提供这些路径。

C++ 
[/Script/AndroidPlatformEditor.AndroidSDKSettings]
    SDKPath = (Path="C:\Filepath")
    NDKPath = (Path="C:\Filepath")
    JDKPath = (Path="C:\Filepath")

如果BaseEngine.ini中不存在SDKPath、NDKPath和JDKPath的条目，则系统将使用Android主目录的默认路径。

Ask questions and help your peers Developer Forums

Write your own tutorials or read those from others Learning Library

On this page
Related documents