Version: Unity 6.0 (6000.0)
语言 : 中文
修改 Gradle 项目文件
使用 Gradle 模板文件修改 Gradle 项目文件

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

Unity 提供了播放器设置构建设置来配置应用程序。Unity 在构建项目时,会接受这些配置选项并使用它们来生成 Gradle 项目文件。但是,有时可能需要对__ Gradle__一套 Android 构建系统,可自动执行多种构建过程。这种自动化意味着能减少许多常见的构建错误。更多信息
See in Glossary
项目文件施加更多控制。

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

Gradle 项目文件 Gradle 模板 Android Studio
主清单 受支持 受支持
Android 启动器清单 受支持 受支持
主 Gradle 受支持 受支持
启动器 Gradle 受支持 受支持
基础 Gradle 受支持 受支持
Gradle 属性模板 受支持 受支持
Proguard 文件 受支持 受支持

可以使用 Android Project Configuration Manager 修改自定义 Android Gradle 项目文件。无法使用此方法修改默认 unityLibrarylauncher 模块中构建的 Gradle 项目文件。

Gradle 模板文件

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

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

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

导出至 Android Studio

如果导出用于 Android 的 Unity 项目,Unity 会生成 Gradle 项目文件并将其放在导出的项目中。如果在 Android Studio 中打开导出的项目,那么可以查看 Gradle 项目文件。这对于验证使用 Gradle 模板或 Android Project Configuration Manager 所做的修改非常有用,对于直接编辑文件本身也很有用。

提示:为了确保每次导出或构建 Unity 项目时都无需重新修改 Gradle 项目文件,最佳做法是在 Unity 中对 Gradle 项目文件进行所需的修改(使用 Gradle 模板文件或 Android Project Configuration Manager)。

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

Android Project Configuration Manager

Android Project Configuration Manager 是一组类,可用于在 C# 中设置和修改自定义 Gradle 项目文件。无法直接修改构建过程在默认 unityLibrarylauncher 模块中创建的 Gradle 项目文件。可以在这些模块中创建自定义模块来设置自定义 Gradle 项目文件并根据需要进行修改。

Unity 在构建后处理过程中应用修改,因此您可以检查 Unity 编辑器设置的值,并根据需要更改这些值。Android Project Configuration Manager 的入口点是 AndroidProjectFilesModifier 界面中的 OnModifyAndroidProjectFiles 方法。

有关如何使用此方法修改 Gradle 项目文件的信息,请参阅使用 Android Project Configuration Manager 修改 Gradle 项目文件

其他资源

修改 Gradle 项目文件
使用 Gradle 模板文件修改 Gradle 项目文件