Version: 2018.4
Android 开发入门
Unity Remote

Android 环境设置

无论是在 Unity 中构建 Android 应用程序还是从头开始编程,都必须先设置 Android 软件开发工具包 (SDK),然后才能在 Android 设备上构建并运行代码。默认情况下,Unity 会安装基于 OpenJDK 的 Java 开发工具包。

1.下载 Android SDK

可使用命令行工具或通过 Android Studio 安装 Android SDK。Android Studio 提供了一个易于使用的基于 GUI 的工具,但会在计算机上安装其他软件。使用命令行工具则只需较少的下载,不会安装其他软件,但使用起来可能更有难度。

1a.使用命令行工具安装 Android SDK

安装或解压 Android SDK。安装完成后,打开 Android SDK Manager 并添加至少一个 Android SDK 平台 (Android SDK Platform)、平台工具 (Platform Tools)、构建工具 (Build Tools) 和 USB 驱动程序(如果使用的是 Windows)。

要安装 Android 平台 SDK 和相关工具,请执行以下操作:

  1. 下载 Android 软件命令行工具

  2. tools 文件夹解压缩到硬盘驱动器上的某个位置。

  3. 打开命令提示符窗口。

  4. 导航到 tools 文件夹的解压缩位置中的 bin 文件夹:

    安装文件夹 > tools > bin

  5. 使用 sdkmanager 命令行工具检索可安装包列表。可安装包中包括平台 SDK、构建工具、平台工具和其他工具。

    sdkmanager --list

  6. 选择要安装的平台 SDK 版本。平台 SDK 在列表中采用以下形式:platforms;android-xxxx 表示 SDK 级别。数字越大,包越新。通常,可安装最新的可用版本。但是,在某些情况下,Google 发布了新版本的 SDK,但在构建 Unity 项目时会导致错误。在这种情况下,必须卸载 SDK 并安装早期版本。包安装命令的一般格式为 sdkmanager lt;包名称>。可同时安装相应的平台工具和构建工具。

示例:sdkmanager “platform-tools” “platforms;android–27” “build-tools;27.0.3”

  1. 如果是在 Windows 上运行,请安装 USB 设备驱动程序:

sdkmanager “extras;google;usb_driver”

这会将 SDK 安装在名为 platforms 的目录中,而此目录位于先前将 tools 文件夹解压缩到的目录。

示例:

c:<安装文件夹>\platforms

1b.使用 Android Studio 安装 SDK

Android 开发者门户安装 Android Studio。Android 开发者门户提供了详细的安装说明。

__注意__:Android Studio 提供了一些易用性优势,但尚未针对与 Unity 的兼容性进行全面测试。如果遇到错误,Unity 建议使用命令行方法。

安装 Android 平台 SDK 和其他工具时,通常可安装最新的可用版本。在某些情况下,Google 发布了新版本的 SDK,但在构建 Unity 项目时会导致错误。在这种情况下,请卸载 SDK 并安装早期版本。

应同时安装相关的平台工具和构建工具。如果是在 Windows 上运行,请安装 USB 设备驱动程序。

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__,然后启用 USB debugging__。Android 通过 USB 连接到计算机的情况下将进入调试模式。

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

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

3.在 Unity 中配置 Android SDK 路径

第一次创建 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

4.下载并设置 Android NDK

如果要使用 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

使用备用的 Java 开发工具包

Unity 建议您使用随 Android 构建工具一起安装的 JDK,以确保您获得正确的版本和配置。

如果已手动安装 JDK 并且不想重复安装,则可以在 Unity Preferences 窗口中指定位置。为此,请选择 Preferences > External tools__,并在 JDK__ 字段中输入目录路径:

Android 外部工具偏好设置
Android 外部工具偏好设置

__警告__:Android 工具不支持 JDK 9 或更高版本;备用 JDK 必须是版本 8。Unity 不会正式支持除 Android Build Tools 中嵌入的 JDK 版本之外的其他版本。

要更改 Unity 用于构建 Android 应用程序的 JDK,请执行以下操作:

  1. 打开项目。

  2. 打开 Preferences 窗口:
    • 在适用于 Windows 的 Editor 中,导航到 Edit > Preferences
    • 在适用于 macOS 的 Editor 中,导航到 Unity > Preferences
  3. 在左侧导航栏中,选择 External Tools

  4. 取消选中 JDK Installed with Unity (recommended)

  5. JDK 字段中输入 JDK 的路径,或使用 Browse 按钮找到该路径。


2018–11–21页面已修订并进行了编辑审查

Android 开发入门
Unity Remote