Gradle 模板配置了如何使用Gradle一个 Android 构建系统,可以自动执行多个构建流程。这种自动化意味着许多常见的构建错误不太可能发生。更多信息
参见术语表构建 Android 应用。每个 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 项目文件。
要在 Unity 组装 Gradle 项目后修改它,请创建一个继承自IPostGenerateGradleAndroidProject的类,并覆盖OnPostGenerateGradleAndroidProject函数。此函数接收 unityLibrary 模块的路径作为参数,您可以使用它通过 C# 脚本访问应用程序的清单和资源。