Version: 2019.4
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 模块的信息:

注意:如果是在 macOS 10.15 (Catalina) 上使用 Unity,并且没有通过 Unity Hub 安装 Android 工具,则操作系统的默认安全设置将阻止执行 Android NDK 二进制文件。必须更改这些安全设置,或从 Android 开发者网站下载已签名的 Android NDK (r16b)。

如果使用的是 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/ 下的 SDKNDKOpenJDK 文件夹中安装 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 应用程序中