【随便做的翻译】《Unity：建立安卓环境》

原文：Android environment setup

版本：2018.3

更新时间：2019年5月24日14点00分。勘误一些内容。

前言

无论你是在Unity上手构建安卓应用还是从草稿中编程，你必须先安装Android Software Development Kit（安卓软件开发工具包），然后才能在安卓设备上构建/运行任何代码。默认下，Unity已经安装了基于OpenJDK的Java Development Kit。

1.下载Android SDK

你可以通过使用命令行工具（Command Line Tools）或通过Android Studio（安卓工作室）安装Android SDK。Android Studio提供了基于GUI而易于使用的工具，但也在你的计算机上安装了额外的软件。使用命令行工具下载量较小，并且不安装附加软件，但是使用起来可能更具挑战性。

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

安装或解压Android SDK。安装后，打开Android SDK Manager（安卓SDK管理器）并添加：若你使用Windows系统，则需要至少一个Android SDK Platform（安卓SDK平台）/Platform Tools（平台工具）/Build Tools（构建工具）/USB Driver（USB驱动程序，如果你使用Windows的话）。

安装Android SDK Platform及其相关工具：

1. 下载安卓软件命令行工具。
2. 将工具文件夹解压缩到硬盘驱动器上的一个位置。
3. 打开命令提示符窗口。
4. 导航到已解压缩的文件夹，在其中导航到：“解压文件夹”>tools>bin
5. 可安装的软件包囊括了Platform SDK、Build Tool、Platform Tool和其他工具。使用sdkmanager命令行工具检索可安装包的列表：sdkmanager -list (笔者注：这条笔者修改了文字的编排序列)
6. 选择要安装的Platform SDK版本。Platform SDK在列表中采用以下形式：platforms; android-xx。xx表示SDK版本。数字越大，安装包就越新。你同时可以安装对应的Platform Tool和Build Tool。通常，你可以安装最新的可用版本。但是，在构建Unity项目时，Google可能会发布一个潜藏错误的新版SDK。在这种情况下，你必须卸载此版SDK，并安装较老的版本。安装命令的通用格式是：sdkmanager <安装包名>。举个栗子：sdkmanager “platform-tools” “platforms;android-27” “build-tools;27.0.3”
7. 如果您正在Windows上运行，请安装USB Driver：sdkmanager “extras;google;usb_driver”

这将SDK安装到解压缩工具文件夹的目录中的“平台”目录中。例子：C:\<安装文件夹>\platforms

1b.使用Android Studio安装Android SDK

从安卓开发者网站中安装Android Studio。Android开发者网站已提供详细的安装说明。

注意：Android Studio提供了一些易于使用的好处，但与Unity安装时的兼容性没有得到充分的测试。如果遇到错误，Unity建议你使用命令行工具安装Android SDK。

当安装Android Platform SDK和其他工具时，通常可以安装最新的可用版本。可能在有些情况下，在使用谷歌发布的SDK新版本构建Unity项目时，其SDK会导致错误的发生。在此，必须卸载此SDK，并安装较老的版本。

笔者注：例如近日笔者在Android SDK上更新了Android Q后，在打包时发生了错误。请务必删除与Android Q（29.x.x-rcx）有关的版本内容，包括build-tool等连带内容。上同。

同时也要安装相关的Platform Tool和Build Tool。如果您正在Windows上运行，请安装USB Driver。

2.在设备上启用USB调试（USB Debugging）

在Samsung Galaxy Note 3显示的版本号
安卓5.0(Lollipop)

要启用USB调试，必须在设备上启用开发人员选项。为此，你需要在设备的设置菜单中找到版本号（Build Number）。

版本号的位置随设备而变化；原生安卓可遵循设置（Setting）>关于手机（About Phone）> 版本号来导航到指定位置。有关您的设备和安卓版本的具体信息，请参阅您的硬件制造商。

注意：在安卓版本4.2（JeleBean）之前，开发者选项没有被隐藏。可在设置>开发者选项（Developer Options）中启用USB调试。

使用上面的说明导航到版本号之后，点击版本号n次。出现一个弹出通知，上面写着“您现在离成为开发人员还有x步之遥”，其中“x”是一个数字，每一次点击都会减少其大小。当其变为0时，开发者选项会被解锁。

转到设置>开发者选项，并选用USB调试复选框，当设备通过USB连接到计算机时，启用调试模式（Debug Mode）。

使用USB电缆将设备连接到计算机。如果在Windows计算机上进行开发，可能需要安装设备特定的USB驱动程序。请查看您的设备的制造网站以获取更多信息。

在Samsung Galaxy Note 3显示的USB调试
安卓5.0(Lollipop)

Windows和macOS的设置过程不同，安卓开发者网站对此进行了详细说明。有关将安卓设备连接到SDK的更多信息，请参阅安卓开发者文档的《运行你的程序》这一部分。

3.在Unity中配置Android SDK路径

在Unity中第一次创建安卓项目时（或者Unity无法定位到SDK的位置时），Unity会要求你定义安装Android SDK的文件夹。

如果你使用sdkmanager安装SDK，可以在<安卓工具安装位置>\platforms\<Android SDK文件夹>中找到该文件夹。

例子：C:\<安卓工具安装位置>\platforms\android-27

如果安装Android Studio时安装了SDK，则可以在SDK Manager（SDK管理器）中找到位置。要从Android Studio打开SDK Manager，请单击工具栏中的Tools>Android>SDK Manager或点击SDK Manager即可。

若要在Unity中变更Android SDK的位置，则需在菜单栏中选择Edit>Preferences>External Tools。

笔者注：原文没有Edit，但为了方便Windows客户端用户查询特添加了Edit以便查询，其他客户端可忽略。下同。

4.下载并设置Android NDK(Native Development Kit)

如果你正在为安卓使用IL2CPP的脚本后端，那么你需要Android NDK（安卓原生开发工具包）。它包含构建文件必要使用的库，并最终生成输出包（APK）所需的工具链（如编译器和链接器）。如果你并不做IL2CPP后端，则可以跳过这一步。

从NDK下载网页下载Android NDK r16b（64位版本）。将Android NDK文件夹提取到计算机上，并记录其位置。

第一次使用IL2CPP构建安卓项目时，要求你定义安装Android NDK的文件夹。选择NDK安装的根文件夹。要更改Android NDK的位置，请在Unity Editor中导航到菜单：Edit>Preferences>External Tools。

5.使用另一版本的JDK（Using an alternate Java Development Kit）

Unity建议您使用安卓构建工具中安装的JDK，以确保您使用到对应的版本和配置。

如果您已经手动安装了JDK并且不想覆盖之前的安装，可以在Unity的Preference窗口中指定位置。为此，请转到Edit>Preferences>External Tools，并在JDK字段中输入目录路径：

Preferences for Android external tools

 

警告：Android工具不支持JDK9或更高版本；备用JDK必须是版本8。除了安卓构建工具中嵌入的版本外，Unity没有正式支持JDK版本。

要更改Unity用于构建Android应用程序的JDK：

1. 打开项目。
2. 打开“首选项”窗口：Windows版Unity中选择Edit > Preferences；MacOS则是Unity > Preferences。
3. 在左侧导航栏中，选择External Tools。
4. 取消选中“Use embedded JDK。
5. 在JDK字段中，输入JDK的路径或通过Browse定位它。

——————————

译者注：有一些网站是不存在的，需要以科学的方式来打开。