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

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

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

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

Gradle 模板文件

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

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

如需了解如何使用此方法修改 Gradle 项目文件，请参阅使用 Gradle 模板文件修改 Gradle 项目文件。

导出到 Android Studio

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

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

如需了解如何使用此方法修改 Gradle 项目文件，请参阅使用 Android Studio 修改 Gradle 项目文件。

Android 项目配置管理器

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

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

如需了解如何使用此方法修改 Gradle 项目文件，请参阅使用 Android 项目配置管理器修改 Gradle 项目文件。

其他资源

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