Gradle 模板会配置如何使用 Gradle 来构建 Android 应用程序。每个__ Gradle__一套 Android 构建系统,可自动执行多种构建过程。这种自动化意味着能减少许多常见的构建错误。更多信息
See in Glossary 模板都代表一个 Gradle 项目。Gradle 项目可以包括并依赖于其他 Gradle 项目。
Gradle 模板包含以下文件:
| File | 所在地 | 包含 |
|---|---|---|
baseProjectTemplate.gradle |
位于导出项目的 root/build.gradle 文件夹 |
配置信息,影响最终 Gradle 项目中所有模块。指定要使用的 Android Gradle 插件版本以及 Java 插件的位置。这些位置是该项目中线上代码库和 Java 插件的组合。 |
launcherTemplate.gradle |
位于导出项目的 root/launcher/build.gradle 文件夹 |
关于如何构建 Android 应用程序的指令。包括捆绑、签名以及是否拆分__ apk__Unity 输出的 Android 包格式。选择文件 (File) > 构建并运行 (Build & Run) 时,APK 会被自动部署到设备。更多信息 See in Glossary。依赖 unityLibrary 项目,输出 .apk 文件或应用程序捆绑包。 |
mainTemplate.gradle |
位于导出项目的 root/unityLibrary/build.gradle 文件夹 |
包含关于如何将 Unity 构建为库的指令。输出 .aar 文件。可以在 Unity 编辑器中用自定义模板来覆盖 Unity 模板。详情请参阅本页的“提供自定义 Gradle 构建模板”小节。 |
libTemplate.gradle |
因情况而异 | 如果 Android Library Project 插件不包含 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# 脚本访问应用程序的清单和资源。