Gradle中ext的类型安全替代方案（限定仅特定父项目的子项目可访问）

我懂你需求的痛点——用ext吧类型不安全，每次取都要手动强转还没IDE提示；用buildSrc吧又全局可见，所有子项目都能拿到，完全不符合你想要的“仅限特定父项目子项目访问”的要求。别担心，有两个精准匹配你需求的方案，给你详细说：

方案一：使用父项目专属的Convention Plugin（约定插件） #

这是Gradle官方推荐的类型安全配置方式，还能完美限定访问范围，核心思路就是：在buildSrc里定义一个自定义扩展类型，然后只在目标父项目的子项目里注册这个扩展，其他项目根本看不到它。

具体步骤： #

1. 先在项目根目录的buildSrc/src/main/kotlin下创建一个Kotlin文件（如果buildSrc目录不存在就手动建），定义我们的扩展类型：

// buildSrc/src/main/kotlin/com/example/ParentProjectExt.kt
package com.example

import org.gradle.api.provider.Property

// 用抽象类定义扩展，Gradle会自动实现它
abstract class ParentProjectExt {
    // 用Property做懒加载，比直接赋值更符合Gradle的最佳实践
    abstract val parentIntValue: Property<Int>
}

2. 回到目标父项目的build.gradle.kts，在subprojects块里注册这个扩展并设置值：

// 目标父项目 build.gradle.kts
subprojects {
    // 给当前子项目注册自定义扩展
    val parentProjectExt = extensions.create<com.example.ParentProjectExt>("parentProjectExt")
    // 设置我们需要的int值
    parentProjectExt.parentIntValue.set(42)
}

3. 现在这个父项目的所有子项目，就能类型安全、带IDE自动补全地访问这个值了：

// 目标父项目的子项目 build.gradle.kts
// 直接获取扩展，完全类型安全
val parentExt = extensions.getByType<com.example.ParentProjectExt>()
val localIntValue = parentExt.parentIntValue.get()

划重点：不在这个父项目下的其他子项目，根本找不到parentProjectExt这个扩展，完美实现了你要的范围限制！

方案二：轻量版——用扩展函数包装extra（不用改buildSrc） #

如果你觉得建buildSrc太麻烦，也可以用扩展函数给Project加一个类型安全的访问入口，同样只在目标父项目的子项目里生效。

具体步骤： #

直接在目标父项目的build.gradle.kts里写：

// 目标父项目 build.gradle.kts
subprojects {
    // 先把值放到extra里
    extra["parentIntValue"] = 42

    // 给Project类加一个类型安全的扩展函数
    fun Project.getParentIntValue(): Int {
        // 这里的强转只在父项目里写一次，子项目不用管
        return extra["parentIntValue"] as Int
    }
}

然后子项目里直接调用这个函数就行：

// 目标父项目的子项目 build.gradle.kts
val localIntValue = getParentIntValue() // 完全类型安全，不用自己强转

这个方案的好处是快，不用折腾buildSrc，缺点是IDE的自动补全可能不如Convention Plugin那么灵敏，但胜在简单直接，小项目用足够了。

为啥这两个方案比buildSrc好？ #

buildSrc里的代码是全局可见的，所有子项目（包括根项目下的其他子项目）都能访问；而这两个方案都是在目标父项目的subprojects块里定义的，只有这个父项目的子项目会被应用这些配置，完全符合你要的“限定范围”的需求。

备注：内容来源于stack exchange，提问作者Nolequen