Gradle for Android

Gradle 是一种可自动执行许多构建过程的 Android 构建系统。这种自动化意味着不太可能发生许多常见的构建错误。最值得注意的是，在 Unity 中，该系统可减少 DEX（Dalvik 可执行文件格式）文件中的方法引用数量，这意味着可降低遇到 DEX 限制问题的可能性。但是，由于 Gradle 与默认的 Unity Android 构建系统之间存在差异，一些现有项目可能很难转换为 Gradle。

您可以使用 Unity 中的 Gradle 构建系统构建输出包 (APK)，也可以导出 Gradle 项目并在外部工具（如 Android Studio）中进行构建。

如需了解更多信息，请参阅 Gradle 的 Gradle for Android 构建入门 (Getting Started with Gradle for Android Build) 参考资源。

使用 Gradle for Android 进行构建

要在 Unity 中使用 Gradle 进行 Android 版本的构建，请执行以下操作：

1.在 Unity Editor 中，打开 Build Settings 窗口（菜单：__File__ > Build Settings…） 2.在 Platform 列表中，选择 Android 3.在 Build System 下拉选单中选择 Gradle (new)，然后单击 Build

导出 Gradle 项目

要导出 Gradle 项目，请按照上面的说明操作，但要先在 Build 窗口中勾选 Export Project 选项再单击 Build。单击 Build 时，Unity 会在指定目录中生成 Gradle 项目，而不是构建 APK。可将此项目导入 Android Studio 以进行其他修改或完全控制构建过程。

有关构建输出包 (APK) 的更多信息，请参阅 Android Studio 的构建配置文档。

提供自定义的 build.gradle 模板

To use your own build.gradle file when building the APK from Unity, import your build.gradle file to Assets/Plugins/Android/mainTemplate.gradle. Note that the file might use some template variables like TARGETSDKVERSION. See the default mainTemplate.gradle file in the Unity installation for an example file.

使用 Gradle 进行构建时的错误

如果在使用 Gradle 进行 Android 版本构建期间发生错误，Unity 将显示错误对话框。单击 Troubleshoot 即可在系统的浏览器中打开有关 Gradle 故障排除的 Unity 文档。

• 2017–05–22 页面已发布但未经编辑审查

• 5.5 中的新功能