要为 Android 构建和运行应用程序,必须安装 Unity Android Build Support 平台模块。还需要安装 Android 软件开发工具包(SDK)和原生开发工具包(NDK)才能在 Android 设备上构建和运行代码。默认情况下,Unity 会安装基于 OpenJDK 的 Java 开发工具包。
__注意__:Unity 支持 Android 4.4 “KitKat” 和更高版本。请参阅 AndroidSdkVersions
以了解详细信息。
使用 Unity Hub 安装 Android Build Support 和所需的依赖项:Android SDK & NDK Tools 以及 OpenJDK。
可在安装 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 文档以了解如何手动安装这些依赖项。
要启用 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) 部分。
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 字段中输入目录路径:
__警告__:Unity 未正式支持除了提供的 OpenJDK、SDK 或 NDK 版本外的其他版本。
要更改 Unity 用于构建 Android 应用程序的 OpenJDK、SDK Tools 或 NDK,请执行以下操作:
Unity 可使用随 Unity 版本发布时提供的最新版 Android SDK。
每个版本的 Unity 都需要安装特定版本的 Android NDK:
Unity 版本 | NDK 版本 |
---|---|
2017.4 LTS | r13d |
2018.4 LTS | r16b |
2019.1 | r16b |
2019.2 | r16b |
2019.3 | r19 |
请参阅系统要求页面以查看完整要求。