版本:Unity 6 (6000.0)
语言:英语
Gradle 模板
修改 Gradle 项目文件

Gradle 模板变量

您可以在自定义的Gradle一个 Android 构建系统,可自动执行多个构建过程。 此自动化意味着许多常见的构建错误不太可能发生。 更多信息
参见 术语表
模板文件中使用以下变量

变量 描述
ABIFILTERS 指定您的应用程序应支持的应用程序二进制接口 (ABI)。 例如,armeabi-v7aarm64-v8a。 Gradle 只为指定的 ABIFILTERS 值创建应用程序构建。
APIVERSION 要构建的 API 版本。 Unity 将 APIVERSIONTARGETSDK 设置为相同的值(Android 播放器设置 中的 目标 API 等级)。
APPLICATIONID Android 应用程序 ID。 例如,com.mycompany.myapp
APPLY_PLUGINS 指定构建过程中要使用的 Gradle 插件在 Unity 之外创建的一组代码,用于在 Unity 中创建功能。 您可以在 Unity 中使用两种类型的插件:托管插件(使用 Visual Studio 等工具创建的托管 .NET 程序集)和本机插件(特定于平台的本机代码库)。 更多信息
参见 术语表
BUILDTOOLS 要使用的 SDK 构建工具。
BUILD_SCRIPT_DEPS 指定构建过程中所需的依赖项和存储库列表。
BUILTIN_NOCOMPRESS 指定要从 压缩一种存储数据的方法,可以减少其所需的存储空间。 请参见 纹理压缩动画压缩音频压缩构建压缩
参见 术语表
中排除的文件扩展名列表。 文件扩展名为:.unity3d.ress.resource.obb.bundle.unityexp
DEBUGSYMBOLLEVEL 指示包含调试应用程序所需的调试元数据的符号包类型。 您可以将值设置为 none 表示没有调试元数据,symbol_table 表示只有符号表的符号包,或者 full 表示包含符号表和调试信息的符号包。
DEFAULT_CONFIG_SETUP 包含 android.defaultConfig 的附加配置组件。
DEPS 项目依赖项列表。 这是项目使用的库列表。
DIR_GRADLEPROJECT Unity 创建 Gradle 项目的目录。
DIR_UNITYPROJECT Unity 项目的目录。
EXTERNAL_SOURCES 用于生成构建工件(例如,GameActivity 和 Swappy 本机库)的构建脚本。
GOOGLE_PLAY_DEPENDENCIES 指定您的应用程序所需的 Google Play 服务。 例如,com.google.android.gms:play-services-ads:23.2.0
IL_CPP_BUILD_SETUP 用于生成与 IL2CPP一个 Unity 开发的脚本后端,您可以在构建某些平台的项目时将其用作 Mono 的替代方案。 更多信息
参见 术语表
相关的构建工件(例如,libil2cpp.so)的构建脚本。
LAUNCHER_SOURCE_BUILD_SETUP Unity 的内部构建脚本。
LIBSDKTARGET Unity 库支持的目标 API 等级。
MINIFY_DEBUG 指示是否缩小调试构建。
MINIFY_RELEASE 指示是否缩小发布构建。
MINSDK 支持应用程序的最低 API 版本。
NAMESPACE 应用程序命名空间。 例如,com.MyCompany.MyApp
NDKPATH 指定在 外部工具Android 部分中设置的 Android Native Development Kit (NDK) 安装文件夹路径,菜单:编辑 > 首选项 > 外部工具(macOS:Unity > 设置 > 外部工具)。
NDKVERSION Unity 使用的 Android NDK(原生开发工具包)版本。 例如,ndkVersion "20.0.5594570"
PACKAGING 指定所需的 APKUnity 输出的 Android 包格式。 当您选择文件 > 构建并运行时,APK 会自动部署到您的设备。 更多信息
参见 术语表
打包选项。
PLAY_ASSET_PACKS 指定要包含在应用程序中的 资源包
SIGN 如果此构建已签名,请完成 signingConfigs 部分。
SIGNCONFIG 指示构建是否已签名。 如果此属性设置为 signingConfig.release,则构建已签名。
SOURCE_BUILD_SETUP Unity 的内部构建脚本。
SPLITS 指示您的应用程序是否支持多个 APK 构建。
SPLITS_VERSION_CODE 为拆分 APK 设置版本代码的构建脚本。
TARGETSDK 要定位的 API 版本。 Unity 将 APIVERSIONTARGETSDK 设置为相同的值(Android 播放器设置 中的 目标 API 等级)。
USER_PROGUARD 指定要用于缩小的自定义 ProGuard 文件。
VERSIONCODE 应用程序的内部版本号。 它用于指示应用程序版本的最新程度,其中较高的数字表示较新的版本。
VERSIONNAME 用字符串表示的应用程序版本号。 此版本号对用户可见。

自定义的 settingsTemplate.gradle 文件还可以包含以下变量

变量 描述
INCLUDES 要包含在 Gradle 项目中的 Android 库插件列表。
ARTIFACTORYREPOSITORY 仅供内部使用,添加对 Unity 的 maven 存储库的引用。 Unity 在构建过程中会删除它。

自定义的 gradleTemplate.properties 文件还可以包含以下变量

变量 描述
ADDITIONAL_PROPERTIES 包含应用程序的附加属性。 这包括
• Gradle 模板版本。
• Unity 项目的路径。
• 如果应用程序使用 Android 应用程序捆绑包 发布格式,则指示保留本机库压缩的标志。
• 如果应用程序使用 GameActivity 应用程序入口点,则指示使用 AndroidX 的标志。
JVM_HEAP_SIZE Java 虚拟机 (JVM) 堆 的最大大小。
STREAMING_ASSETS Gradle 不应压缩的 流式资源 文件夹中的文件列表。

其他资源

Gradle 模板
修改 Gradle 项目文件