Version: 2020.2
Android
将 Unity 集成到 Android 应用程序中

Android 环境设置

要为 Android 构建和运行应用程序,必须安装 Unity Android Build Support 平台模块。还需要安装 Android 软件开发工具包(SDK)和原生开发工具包(NDK)才能在 Android 设备上构建和运行代码。默认情况下,Unity 会安装基于 OpenJDK 的 Java 开发工具包。

注意:Unity 支持 Android 4.4 “KitKat” 和更高版本。请参阅 AndroidSdkVersions 以了解详细信息。

1.安装 Android Build Support 和 Android SDK & NDK Tools

使用 Unity Hub 安装 Android Build Support 和所需的依赖项:Android SDK & NDK Tools 以及 OpenJDK。

添加 Android 模块
添加 Android 模块

可在安装 Unity Editor 时安装 Android Build Support、Android SDK & NDK Tools 以及 OpenJDK,也可在以后添加它们。

如需了解关于添加 Android 模块的信息:

如果使用的是 2018 版 Unity,请参阅 Unity 2018.4 文档以了解如何手动安装这些依赖项。

2.在设备上启用 USB 调试

要启用 USB 调试,必须在设备上启用开发者选项 (Developer options)。要完成该操作,请在设备的 Settings 菜单中找到构建版本号。版本号的位置因设备而异;对于原生 Android,此信息通常位于 Settings > About phone > Build number 中。有关设备和 Android 版本的具体信息,请咨询硬件制造商。

按照上述说明导航到版本号后,点击版本号七次。随后会弹出一条通知消息“You are now X steps away from being a developer”,其中“X”是一个数字,每点击一次就会倒数一个数。在第七次点击时,Developer options 将解锁。

注意:在 4.2 (Jelly Bean) 之前的 Android 版本上,默认启用 Developer options。

选择 Settings > Developer options(如果找不到,在一些设备上,可以查找路径 Settings > System > Developer options),然后选中 USB debugging 复选框。Android 通过 USB 连接到计算机的情况下将进入调试模式。

用 USB 线缆将设备连接到计算机。如果在 Windows 计算机上进行开发,可能需要安装特定于设备的 USB 驱动程序。如需了解更多信息,请参阅设备制造商网站。

Windows 和 macOS 的设置过程有所不同;对此,Android 开发者网站上有详细说明。有关将 Android 设备连接到 SDK 的更多信息,请参阅 Android 开发者文档的运行应用程序 (Run Your App) 部分。

自定义 Android SDK & NDK Tools 和 OpenJDK 的安装

Unity 建议使用 Unity Hub 来安装 Android SDK & NDK Tools,以确保您获得正确的版本和配置。Unity 分别在 /Unity/Hub/Editor/[EditorVersion]/Editor/Data/PlaybackEngines/AndroidPlayer/ 下的 SDK、NDK 和 OpenJDK 文件夹中安装 Android SDK & NDK Tools 和 OpenJDK。

如果多个 Unity 版本具有相同的依赖关系(请确保查看系统要求以了解最新要求),并希望避免重复安装 Android SDK & NDK Tools 和 OpenJDK,则可以在 Unity Preferences 窗口中指定一个共享位置。为此,请选择 Preferences > External tools,并在 SDK 和 NDK 字段中输入目录路径:

Preferences 窗口中显示了 Android 外部工具设置
Preferences 窗口中显示了 Android 外部工具设置

警告:Unity 未正式支持除了提供的 OpenJDK、SDK 或 NDK 版本外的其他版本。

要更改 Unity 用于构建 Android 应用程序的 OpenJDK、SDK Tools 或 NDK,请执行以下操作:

  1. 打开项目。
  2. 打开 Preferences 窗口(Windows 和 Linux:Edit > Preferences;macOS:Unity > Preferences)。
  3. 在左侧导航栏中,选择 External Tools。

更改 OpenJDK 路径

  1. 取消选中 JDK Installed with Unity (recommended)。
  2. 在 JDK 字段中输入 JDK 安装文件夹的路径,或使用 Browse 按钮找到该路径。

更改 Android SDK Tools 路径

  1. 取消选中 Android SDK Tools Installed with Unity (recommended)。
  2. 在 SDK 字段中输入 SDK 安装文件夹的路径,或使用 Browse 按钮找到该路径。

Unity 可使用随 Unity 版本发布时提供的最新版 Android SDK。

更改 Android NDK 路径

  1. 取消选中 Android NDK Installed with Unity (recommended)。
  2. 在 NDK 字段中输入 NDK 安装文件夹的路径,或使用 Browse 按钮找到该路径。

每个版本的 Unity 都需要安装特定版本的 Android NDK:

Unity 版本 NDK 版本
2017.4 LTS r13d
2018.4 LTS r16b
2019.1 r16b
2019.2 r16b
2019.3 r19

请参阅系统要求页面以查看完整要求。

Android
将 Unity 集成到 Android 应用程序中