版本:Unity 6 (6000.0)
语言:English
构建和交付 Android 应用
Gradle 模板变量

Gradle 模板

Gradle 模板配置了如何使用Gradle一个 Android 构建系统,可以自动执行多个构建流程。这种自动化意味着许多常见的构建错误不太可能发生。更多信息
参见术语表
构建 Android 应用。每个 Gradle 模板都代表一个单独的 Gradle 项目。Gradle 项目可以包含其他 Gradle 项目并依赖于它们。

Gradle 模板文件

Gradle 模板包含以下文件

文件 位置 包含内容
baseProjectTemplate.gradle 在导出的项目中,root/build.gradle 文件夹 影响最终 Gradle 项目中所有模块的配置信息。它指定了要使用的 Android Gradle Plugin 版本以及 Java 插件的位置。这些位置是联机存储库和此项目内部的 Java 插件的组合。
launcherTemplate.gradle 在导出的项目中,root/launcher/build.gradle 文件夹 有关如何构建 Android 应用的说明。这包括捆绑、签名以及是否拆分apkUnity 输出的 Android 包格式。当您选择“文件”>“构建并运行”时,APK 会自动部署到您的设备。更多信息
参见术语表
。它依赖于 unityLibrary 项目,并输出 .apk 文件或应用包。
mainTemplate.gradle 在导出的项目中,root/unityLibrary/build.gradle 文件夹 有关如何将 Unity 构建为库的说明。这会输出一个 .aar 文件。您可以使用 Unity 编辑器中的自定义模板覆盖 Unity 模板。有关更多详细信息,请参阅本页上的“提供自定义 Gradle 构建模板”部分。
libTemplate.gradle 变化 如果Android 库项目插件在 Unity 之外创建的一组代码,用于在 Unity 中创建功能。您可以在 Unity 中使用两种类型的插件:托管插件(使用 Visual Studio 等工具创建的托管 .NET 程序集)和原生插件(特定于平台的原生代码库)。更多信息
参见术语表
不包含 build.gradle 文件,则 Unity 会使用 libTemplate.gradle 文件作为模板生成一个。Unity 生成 build.gradle 文件后,或者如果插件目录中已存在一个文件,则 Unity 会将插件复制到 Gradle 项目中。
settingsTemplate.gradle 在导出的项目中,root/settings.gradle 文件 指定 Gradle 构建系统在构建项目时应包含的模块名称。您可以使用 Unity 编辑器中的自定义模板覆盖 Unity 模板。有关更多详细信息,请参阅本页上的“提供自定义 Gradle 构建模板”部分。
gradleTemplate.properties 在导出的项目中,root/gradle.properties 文件 配置 Gradle 构建系统并指定属性,例如Java 虚拟机 (JVM) 堆的大小。

要更好地控制 Unity 生成的 Gradle 项目文件,您可以覆盖 Unity 的默认 Gradle 模板文件。有关如何执行此操作的信息,请参阅使用 Gradle 模板文件修改 Gradle 项目文件

使用 C# 修改导出的 Gradle 项目

要在 Unity 组装 Gradle 项目后修改它,请创建一个继承自IPostGenerateGradleAndroidProject的类,并覆盖OnPostGenerateGradleAndroidProject函数。此函数接收 unityLibrary 模块的路径作为参数,您可以使用它通过 C# 脚本访问应用程序的清单和资源。

构建和交付 Android 应用
Gradle 模板变量