配置构建环境
2025-11-12 23:24:15
org.gradle.caching=(true,false)
设置为 true 时,Gradle 将在可能的情况下重用先前构建的任务输出,从而大大加快构建速度。
默认值为 false;构建缓存未启用。
org.gradle.caching.debug=(true,false)
设置为 true 时,每个任务的单独输入属性哈希和构建缓存键都会在控制台上记录。
默认值为 false。
org.gradle.configuration-cache=(true,false)
启用配置缓存。Gradle 将尝试重用先前构建的构建配置。
默认值为 false。
org.gradle.configureondemand=(true,false)
启用孵化中的按需配置,在此模式下,Gradle 将尝试仅配置必要的项目。
默认值为 false。
org.gradle.console=(auto,plain,rich,verbose)
自定义控制台输出着色或详细程度。
默认值取决于 Gradle 的调用方式。
org.gradle.continue=(true,false)
如果启用,任务失败后继续执行任务,否则任务失败后停止任务执行。
默认值为 false。
org.gradle.daemon=(true,false)
设置为 true 时,Gradle Daemon 用于运行构建。
默认值为 true。
org.gradle.daemon.idletimeout=(空闲毫秒数)
Gradle Daemon 将在指定的空闲毫秒数后自行终止。
默认值为 10800000(3 小时)。
org.gradle.debug=(true,false)
设置为 true 时,Gradle 将在启用远程调试的情况下运行构建,监听端口 5005。请注意,这等同于向 JVM 命令行添加 -agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=5005,并将暂停虚拟机直到调试器连接。
默认值为 false。
org.gradle.java.home=(JDK 主目录路径)
指定 Gradle 构建过程的 Java 主目录。该值可以设置为 jdk 或 jre 位置;但是,根据您的构建内容,使用 JDK 更安全。这不会影响用于启动Gradle 客户端 VM 的 Java 版本。
您还可以使用Daemon JVM 标准来控制用于运行 Gradle 本身的 JVM。
如果未指定设置,则默认值从您的环境(JAVA_HOME 或 java 的路径)中派生。
org.gradle.jvmargs=(JVM 参数)
指定用于 Gradle Daemon 的 JVM 参数。此设置对于配置 JVM 内存设置以优化构建性能特别有用。这不影响 Gradle 客户端 VM 的 JVM 设置。
默认值为 -Xmx512m "-XX:MaxMetaspaceSize=384m"。
org.gradle.logging.level=(quiet,warn,lifecycle,info,debug)
设置为 quiet、warn、info 或 debug 时,Gradle 将使用此日志级别。值不区分大小写。
默认值为 lifecycle 级别。
org.gradle.parallel=(true,false)
配置后,Gradle 将分叉最多 org.gradle.workers.max 个 JVM 来并行执行项目。
默认值为 false。
org.gradle.priority=(low,normal)
指定 Gradle Daemon 及其启动的所有进程的调度优先级。
默认值为 normal。
org.gradle.projectcachedir=(目录)
指定项目特定的缓存目录。默认为根项目目录中的 .gradle。
默认值为 .gradle。
org.gradle.problems.report=(true|false)
启用 (true) 或禁用 (false) build/reports/problems-report.html 的生成。true 是默认值。报告是根据提供给问题 API 的问题生成的。
org.gradle.unsafe.isolated-projects=(true,false)
启用项目隔离,从而启用配置缓存。
默认值为 false。
org.gradle.vfs.verbose=(true,false)
配置监视文件系统时的详细日志记录。
默认值为 false。
org.gradle.vfs.watch=(true,false)
切换文件系统监视。启用后,Gradle 会在构建之间重用它收集的有关文件系统的信息。
在 Gradle 支持此功能的操作系统上,默认值为 true。
org.gradle.warning.mode=(all,fail,summary,none)
设置为 all、summary 或 none 时,Gradle 将使用不同的警告类型显示。
默认值为 summary。
org.gradle.workers.max=(最大工作进程数)
配置后,Gradle 将使用最多给定数量的工作器。
默认值为 CPU 处理器数量。