如何在根项目build.gradle与settings.gradle之间共享版本变量

报错原因 #

Gradle 配置的执行顺序是先执行 settings.gradle，再执行根项目的 build.gradle，你在根 build.gradle 的 buildscript.ext 中定义的变量，settings.gradle 运行时还未初始化，因此无法识别。

解决方案（按推荐度排序） #

方案1：直接在版本目录中定义版本，反向供build.gradle使用（最推荐，符合版本目录设计初衷）

版本目录本身就是为了统一管理依赖版本设计的，你可以直接把compose版本定义在settings.gradle的版本目录中，根build.gradle需要用到时直接从版本目录读取即可，不需要额外定义ext变量。

• settings.gradle配置示例：

versionCatalogs {
    composeLibs {
        // 直接在这里定义compose版本，不需要从外部传入
        version('compose', '1.0.0')
        alias('ui-core').to('androidx.compose.ui', 'ui').versionRef('compose')
        alias('material').to('androidx.compose.material', 'material').versionRef('compose')
        alias('ui-preview').to('androidx.compose.ui', 'ui-tooling-preview').versionRef('compose')
        alias('ui-junit').to('androidx.compose.ui', 'ui-test-junit4').versionRef('compose')
        alias('ui-tooling').to('androidx.compose.ui', 'ui-tooling').versionRef('compose')

        bundle('suite', ['ui-core', 'material', 'ui-preview'])
    }
}

• 根build.gradle读取版本示例：

buildscript {
    // 直接从版本目录获取已定义的compose版本
    ext.compose_version = composeLibs.versions.compose.get()
    // 其余原有代码保持不变
}

方案2：将公共版本存放在gradle.properties中（适合多位置读取的通用场景）

所有Gradle配置文件都可以读取gradle.properties中定义的属性，是跨配置共享变量的通用方案。

• 第一步：在项目根目录的gradle.properties文件中添加版本定义：

compose_version=1.0.0

• 第二步：调整settings.gradle配置，读取properties中的属性：

versionCatalogs {
    composeLibs {
        version('compose', providers.gradleProperty('compose_version').get())
        // 其余alias、bundle配置保持不变
    }
}

• 第三步：根build.gradle中直接读取该属性即可：

buildscript {
    ext {
        compose_version = project.property('compose_version')
    }
    // 其余原有代码保持不变
}

方案3：在settings.gradle中定义ext变量，供build.gradle读取

如果不想改动现有结构，也可以把变量定义在更早执行的settings.gradle中，根build.gradle直接读取即可。

• 第一步：在settings.gradle开头添加变量定义，版本目录直接使用该变量：

ext.compose_version = '1.0.0'

versionCatalogs {
    composeLibs {
        version('compose', compose_version)
        // 其余alias、bundle配置保持不变
    }
}

• 第二步：根build.gradle直接读取settings中定义的ext变量：

buildscript {
    ext {
        compose_version = settings.ext.compose_version
    }
    // 其余原有代码保持不变
}

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