您可以在自定义的Gradle一个 Android 构建系统,可自动执行多个构建过程。 此自动化意味着许多常见的构建错误不太可能发生。 更多信息
参见 术语表 模板文件中使用以下变量
变量 | 描述 |
---|---|
ABIFILTERS | 指定您的应用程序应支持的应用程序二进制接口 (ABI)。 例如,armeabi-v7a 、arm64-v8a 。 Gradle 只为指定的 ABIFILTERS 值创建应用程序构建。 |
APIVERSION | 要构建的 API 版本。 Unity 将 APIVERSION 和 TARGETSDK 设置为相同的值(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 将 APIVERSION 和 TARGETSDK 设置为相同的值(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 不应压缩的 流式资源 文件夹中的文件列表。 |