如何在settings.gradle中读取Gradle CLI设置的项目属性实现仓库覆盖

读取失效本质是Gradle构建的执行时序问题：

• 构建启动的标准顺序为：解析命令行启动参数 → 初始化Settings对象 → 执行settings.gradle脚本 → 初始化所有Project实例 → 执行各模块的build.gradle脚本
• 当settings.gradle执行时，rootProject实例尚未完成全量初始化流程，原本会挂载在Project对象上的项目属性集合也未完成绑定，因此通过rootProject.hasProperty()、rootProject.属性名的方式读取，必然拿不到命令行传入的参数值。
• 直接通过gradle.hasProperty("属性名")读取也存在偏差：命令行-P传入的项目参数，默认不会作为Gradle实例的直接动态属性挂载，这类属性只有在Project初始化阶段，才会被自动绑定到Project对象上。

1. 直接在settings.gradle中读取启动参数 #

所有通过./gradlew -Pxxx=xxx传入的参数，从构建启动第一步就会被写入gradle.startParameter.projectProperties这个键值集合，这个对象在settings.gradle执行阶段已经完全初始化，不存在时序问题，可直接读取：

// settings.gradle 内的maven仓库配置块
maven {
    url = gradle.startParameter.projectProperties.getOrDefault("overrideUrl", "https://default/server")
}

2. 实现全脚本域的属性透传 #

如果希望保持原有简洁的hasProperty判断逻辑，同时让settings.gradle和所有build.gradle都能直接读取到命令行参数，可以在settings.gradle的最开头提前完成属性同步：

// settings.gradle 最顶部的初始化逻辑
gradle.startParameter.projectProperties.each { key, value ->
    // 将参数挂载到Settings作用域，供settings内的配置块直接使用
    settings.ext.set(key, value)
    // 将参数提前挂载到rootProject作用域，替代原本的后置自动绑定流程
    rootProject.ext.set(key, value)
}

完成上述配置后，原本的判断逻辑就可以在两个脚本域正常运行：

// settings.gradle 内的仓库配置
maven {
    url = hasProperty("overrideUrl") ? overrideUrl : "https://default/server"
}

// 任意build.gradle 内的仓库配置
repositories {
    maven {
        url = rootProject.hasProperty("overrideUrl") ? rootProject.overrideUrl : "https://default/server"
    }
}

• 不要通过System.getProperty()读取-P传入的参数：-P是Gradle自定义的项目参数，不会写入JVM系统属性；对应能被系统属性读取的是-D开头的JVM参数，二者逻辑不互通。
• 不要在settings.gradle中依赖rootProject的原生属性读取逻辑，原生的属性自动绑定动作发生在settings脚本执行完成之后，存在天然的时序差。

内容的提问来源于stack exchange，提问作者Sooth