Gradle升级至7.0.3后buildConfigField报非法前向引用如何解决

你遇到的非法前向引用报错是Android Gradle Plugin 7.x版本调整BuildConfig字段生成顺序导致的：

• 低版本AGP生成BuildConfig.java时，defaultConfig 中定义的字段优先级低于productFlavor、variant动态添加的字段，会排在后面生成
• AGP 7.x后调整了顺序：defaultConfig 字段最先生成，其次是productFlavor字段，最后才是android.applicationVariants.all回调中动态添加的字段
  你在defaultConfig里定义的APPLICATION_LIST_URL引用了后续variant回调才添加的BACKEND_HOST，生成的代码里APPLICATION_LIST_URL出现在BACKEND_HOST定义之前，就触发了Java的非法前向引用编译错误。

方案1（最稳妥，推荐）：把依赖动态变量的字段统一放到variant回调中定义 #

把defaultConfig、productFlavors中所有引用BACKEND_HOST的buildConfigField声明删除，移到android.applicationVariants.all回调中，放在BACKEND_HOST定义之后：

android.applicationVariants.all { variant ->
    def appName = "myApp"
    def backendHost = backendRemote
    // 先定义被依赖的字段
    variant.buildConfigField "String", "AUTH_HOST", backendHost
    variant.buildConfigField "String", "BACKEND_HOST", backendHost
    // 再定义依赖BACKEND_HOST的字段
    variant.buildConfigField "String", "APPLICATION_LIST_URL", 'BACKEND_HOST + "/page"'
    // 按风味区分定义APK_DOWNLOAD_RESOLVE_URL
    if (variant.flavorName == "local") {
        variant.buildConfigField 'String', 'APK_DOWNLOAD_RESOLVE_URL', 'BACKEND_HOST + "DOES_NOT_EXIST"'
    } else if (variant.flavorName == "remote") {
        variant.buildConfigField 'String', 'APK_DOWNLOAD_RESOLVE_URL', 'BACKEND_HOST + "/remote/download"'
    }

    variant.resValue "string", "app_name", appName
    resValue "string", "app_version", "${appName} ${variant.versionName}"
}

方案2：直接拼接字符串值，避免在BuildConfig中引用变量 #

如果你不需要动态依赖运行时的BuildConfig变量，直接在Gradle中把最终值拼接完成后再传入：

// 示例，对应remote风味的配置
buildConfigField 'String', 'APPLICATION_LIST_URL', '"https://myUrl/page"'

这种方式生成的字段不会依赖其他变量，不会触发前向引用问题，适合不同风味配置差异小的场景。

修改完成后执行clean再重新构建项目，打开生成的BuildConfig.java文件，确认BACKEND_HOST的定义出现在所有引用它的字段之前即可。

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