Version: 6000.3
语言: 中文
构建和交付 Android 版
Gradle 模板变量

Gradle 模板

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

Gradle 模板文件

Gradle 模板由以下文件组成:

文件 位置 包含
baseProjectTemplate.gradle 在导出的项目中,root/build.gradle文件夹 影响最终 Gradle 项目中所有模块的配置信息。它指定要使用的 Android Gradle 插件版本以及 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 模板变量