无论是在 Unity 中构建 Android 应用程序还是从头开始编程,都必须先设置 Android 软件开发工具包 (SDK),然后才能在 Android 设备上构建并运行代码。默认情况下,Unity 会安装基于 OpenJDK 的 Java 开发工具包。
可使用命令行工具或通过 Android Studio 安装 Android SDK。Android Studio 提供了一个易于使用的基于 GUI 的工具,但会在计算机上安装其他软件。使用命令行工具则只需较少的下载,不会安装其他软件,但使用起来可能更有难度。
安装或解压 Android SDK。安装完成后,打开 Android SDK Manager 并添加至少一个 Android SDK 平台 (Android SDK Platform)、平台工具 (Platform Tools)、构建工具 (Build Tools) 和 USB 驱动程序(如果使用的是 Windows)。
要安装 Android 平台 SDK 和相关工具,请执行以下操作:
下载 Android 软件命令行工具。
将 tools 文件夹解压缩到硬盘驱动器上的某个位置。
打开命令提示符窗口。
导航到 tools 文件夹的解压缩位置中的 bin 文件夹:
安装文件夹 > tools > bin
使用 sdkmanager 命令行工具检索可安装包列表。可安装包中包括平台 SDK、构建工具、平台工具和其他工具。
sdkmanager --list
选择要安装的平台 SDK 版本。平台 SDK 在列表中采用以下形式:platforms;android-xx。xx 表示 SDK 级别。数字越大,包越新。通常,可安装最新的可用版本。但是,在某些情况下,Google 发布了新版本的 SDK,但在构建 Unity 项目时会导致错误。在这种情况下,必须卸载 SDK 并安装早期版本。包安装命令的一般格式为 sdkmanager lt;包名称>。可同时安装相应的平台工具和构建工具。
示例:sdkmanager “platform-tools” “platforms;android–27” “build-tools;27.0.3”
sdkmanager “extras;google;usb_driver”
这会将 SDK 安装在名为 platforms 的目录中,而此目录位于先前将 tools 文件夹解压缩到的目录。
示例:
c:<安装文件夹>\platforms
从 Android 开发者门户安装 Android Studio。Android 开发者门户提供了详细的安装说明。
__注意__:Android Studio 提供了一些易用性优势,但尚未针对与 Unity 的兼容性进行全面测试。如果遇到错误,Unity 建议使用命令行方法。
安装 Android 平台 SDK 和其他工具时,通常可安装最新的可用版本。在某些情况下,Google 发布了新版本的 SDK,但在构建 Unity 项目时会导致错误。在这种情况下,请卸载 SDK 并安装早期版本。
应同时安装相关的平台工具和构建工具。如果是在 Windows 上运行,请安装 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__,然后启用 USB debugging__。Android 通过 USB 连接到计算机的情况下将进入调试模式。
用 USB 线缆将设备连接到计算机。如果在 Windows 计算机上进行开发,可能需要安装特定于设备的 USB 驱动程序。如需了解更多信息,请参阅设备制造商网站。
Windows 和 macOS 的设置过程有所不同;对此,Android 开发者网站上有详细说明。有关将 Android 设备连接到 SDK 的更多信息,请参阅 Android 开发者文档的运行应用程序 (Running Your App) 部分。
第一次创建 Android 项目时(或者如果 Unity 稍后无法找到 SDK),Unity 会要求您找到安装 Android SDK 的文件夹。
如果是使用的 sdkmanager 来安装 SDK,则可在 <android 工具安装位置>\platforms<android sdk 文件夹> 中找到该文件夹。
示例:
c:<android 工具安装位置>\platforms\android–27
如果是在安装 Android Studio 时安装的 SDK,则可在 Android Studio SDK Manager 中找到该位置。要从 Android Studio 打开 SDK Manager,请选择 Tools > Android > SDK Manager 或选择工具栏中的 SDK Manager。
要更改 Android SDK 的位置,请在 Unity 菜单栏中选择 Unity > Preferences > External Tools。
如果要使用 Android 的 IL2CPP 脚本后端,则需要 Android 原生开发工具包 (NDK)。该工具包中包含构建必要库并生成输出包 (APK) 所需的工具链(如编译器和链接器)。如果不以 IL2CPP 后端为目标,则可以跳过此步骤。
从 NDK 下载网页下载 Android NDK 版本 r16b(64 位)。将 android-ndk-r16b 文件夹解压缩到计算机上的目录,并记下该位置。
第一次使用 IL2CPP 构建 Android 项目时,Unity 会要求您找到安装 Android NDK 的文件夹。选择 NDK 安装的根文件夹。要更改 Android NDK 的位置,请在 Unity Editor 中导航到菜单 Unity > Preferences 以显示 Unity Preferences 对话框。在此处单击 External Tools。
Unity 建议您使用随 Android 构建工具一起安装的 JDK,以确保您获得正确的版本和配置。
如果已手动安装 JDK 并且不想重复安装,则可以在 Unity Preferences 窗口中指定位置。为此,请选择 Preferences > External tools__,并在 JDK__ 字段中输入目录路径:
__警告__:Android 工具不支持 JDK 9 或更高版本;备用 JDK 必须是版本 8。Unity 不会正式支持除 Android Build Tools 中嵌入的 JDK 版本之外的其他版本。
要更改 Unity 用于构建 Android 应用程序的 JDK,请执行以下操作:
打开项目。
在左侧导航栏中,选择 External Tools。
取消选中 JDK Installed with Unity (recommended)。
在 JDK 字段中输入 JDK 的路径,或使用 Browse 按钮找到该路径。
2018–11–21页面已修订并进行了编辑审查