修改 Unity 应用程序的 Gradle 项目文件

Unity 提供了播放器设置允许您为 Unity 生成的最终游戏设置各种特定于播放器的选项。 更多信息
参见 术语表 和 构建设置 来配置您的应用程序。当 Unity 构建您的项目时，它会获取这些配置选项并使用它们生成 Gradle 项目文件。但是，有时您可能需要更多地控制 Gradle一个 Android 构建系统，它自动化了许多构建过程。这种自动化意味着许多常见的构建错误不太可能发生。 更多信息
参见 术语表 项目文件。

了解您可以用来修改 Gradle 项目文件 内容的可用方法。并非每种方法都与每个 Gradle 项目文件兼容。下表显示了您可以用来修改每个 Gradle 项目文件的方法。

您可以使用 Android 项目配置管理器修改自定义 Android Gradle 项目文件。您无法使用此方法修改默认 unityLibrary 和 launcher 模块中构建的 Gradle 项目文件。

Gradle 模板文件

Unity 使用模板生成最终的 Gradle 项目文件。您可以覆盖这些模板来控制 Unity 如何生成最终文件。Gradle 将 Android 库中的清单合并到最终的主清单中，并确保最终配置正确。

重要：如果您使用自定义 Gradle 模板文件，请注意，如果您将 Unity 项目升级到使用不同默认模板文件的 Unity 版本，则必须重写您的自定义 Gradle 模板文件。

有关如何使用此方法修改 Gradle 项目文件的详细信息，请参阅 使用 Gradle 模板文件修改 Gradle 项目文件。

导出到 Android Studio

如果您 将 Unity 项目导出到 Android，Unity 会生成 Gradle 项目文件并将它们放置在导出的项目中。如果您在 Android Studio 中打开导出的项目，则可以查看 Gradle 项目文件。这对于验证您使用 Gradle 模板或 Android 项目配置管理器所做的修改很有用，也有助于直接编辑文件本身。

提示：为了确保您无需在每次导出或构建 Unity 项目时都重新修改 Gradle 项目文件，最佳实践是在 Unity 中执行所需的 Gradle 项目文件修改（使用 Gradle 模板文件或 Android 项目配置管理器）。

有关如何使用此方法修改 Gradle 项目文件的详细信息，请参阅 使用 Android Studio 修改 Gradle 项目文件。

Android 项目配置管理器

Android 项目配置管理器是一组类，您可以使用它们在 C# 中设置和修改自定义 Gradle 项目文件。您无法直接修改构建过程中在默认 unityLibrary 和 launcher 模块中创建的 Gradle 项目文件。您可以在这些模块内创建自定义模块以设置自定义 Gradle 项目文件并根据需要修改它们。

Unity 在构建后处理期间应用修改，因此您可以检查 Unity 编辑器设置的值，并在需要时更改它们。Android 项目配置管理器的入口点是 OnModifyAndroidProjectFiles 方法，位于 AndroidProjectFilesModifier 接口中。

有关如何使用此方法修改 Gradle 项目文件的详细信息，请参阅 使用 Android 项目配置管理器修改 Gradle 项目文件。

其他资源

• 使用 Gradle 模板文件修改 Gradle 项目文件
• 使用 Android 项目配置管理器修改自定义 Gradle 项目文件
• 使用 Android Studio 修改 Gradle 项目文件