AGP 8.3.2中buildConfigField报错，如何使用buildConfigFields？

问题原因 #

AGP 8.0+版本重构了BuildConfig相关配置API，旧版的buildConfigField()方法被移除，同时默认关闭了BuildConfig类的生成，这就是你遇到"Gradle DSL method not found: buildConfigField()"错误的核心原因。

解决方案 #

1. 开启BuildConfig生成 #

在defaultConfig中显式开启BuildConfig生成（AGP 8.x默认关闭）：

android {
    defaultConfig {
        buildConfig = true
    }
}

2. 配置不同构建类型的常量 #

有两种方式可以配置release/debug的差异化常量：

方式一：使用buildConfig闭包的fields.add()

这是最直观的写法，直接在对应buildType下添加字段：

android {
    defaultConfig {
        buildConfig = true
    }

    buildTypes {
        release {
            buildConfig {
                fields {
                    // 字符串常量需要用转义双引号包裹
                    add("String", "API_BASE_URL", "\"https://api.prod.example.com\"")
                    add("boolean", "ENABLE_LOG", "false")
                    add("int", "MAX_RETRY_COUNT", "3")
                }
            }
        }

        debug {
            buildConfig {
                fields {
                    add("String", "API_BASE_URL", "\"https://api.dev.example.com\"")
                    add("boolean", "ENABLE_LOG", "true")
                    add("int", "MAX_RETRY_COUNT", "5")
                }
            }
        }
    }
}

方式二：使用buildConfigFields属性（接收Map<String, ClassField>）

如果你需要用Map形式批量配置，可以直接设置buildConfigFields属性，需要先导入ClassField类：

import com.android.build.api.variant.ClassField

android {
    defaultConfig {
        buildConfig = true
    }

    buildTypes {
        release {
            buildConfigFields = [
                "API_BASE_URL": ClassField("String", "API_BASE_URL", "\"https://api.prod.example.com\""),
                "ENABLE_LOG": ClassField("boolean", "ENABLE_LOG", "false"),
                "MAX_RETRY_COUNT": ClassField("int", "MAX_RETRY_COUNT", "3")
            ]
        }

        debug {
            buildConfigFields = [
                "API_BASE_URL": ClassField("String", "API_BASE_URL", "\"https://api.dev.example.com\""),
                "ENABLE_LOG": ClassField("boolean", "ENABLE_LOG", "true"),
                "MAX_RETRY_COUNT": ClassField("int", "MAX_RETRY_COUNT", "5")
            ]
        }
    }
}

注意事项 #

• 字符串类型的常量必须用转义双引号（\"）包裹，否则生成的BuildConfig类中会缺少引号，导致编译错误。
• 若使用Kotlin DSL，语法适配如下：

  android {
      defaultConfig {
          buildConfig = true
      }
  
      buildTypes {
          release {
              buildConfig {
                  fields {
                      add("String", "API_BASE_URL", "\"https://api.prod.example.com\"")
                  }
              }
          }
      }
  }
  

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