使用flutter_launcher_icons后Flutter构建Android遇颜色资源错误

问题核心 #

使用flutter_launcher_icons修改应用图标后，执行flutter run或flutter build apk时，出现androidx.core库的颜色资源#8a000000无效的编译错误，根源是依赖版本不兼容或资源冲突。

解决步骤 #

• 强制指定兼容的androidx.core版本
  打开项目根目录下的android/build.gradle文件，在allprojects块内添加版本强制策略：

  allprojects {
      repositories {
          google()
          mavenCentral()
      }
      // 添加以下内容
      configurations.all {
          resolutionStrategy {
              force 'androidx.core:core:1.7.0'
          }
      }
  }
  

  选择1.7.0是因为该版本的颜色资源格式不存在编译问题，避免自动拉取有异常的1.8.0版本。

• 彻底清理缓存后重构
  执行以下命令清理Flutter和Gradle缓存，消除旧资源残留：

  flutter clean
  # Mac/Linux用户执行
  rm -rf ~/.gradle/caches
  # Windows用户手动删除 C:\Users\<你的用户名>\.gradle\caches 文件夹
  flutter pub get
  flutter build apk
  

• 重新生成应用图标
  检查pubspec.yaml中的flutter_launcher_icons配置是否正确，确保图标路径无误，然后重新执行生成命令：

  flutter pub run flutter_launcher_icons:main
  

• 升级Android Gradle插件与Gradle版本
  若上述方法无效，尝试升级Android构建工具版本以提升兼容性：

  1. 修改android/build.gradle中的AGP版本：

     buildscript {
         ext.kotlin_version = '1.7.10'
         dependencies {
             classpath 'com.android.tools.build:gradle:7.4.2'
             classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
         }
     }
     

  2. 修改android/gradle/wrapper/gradle-wrapper.properties中的Gradle版本：

     distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip
     

  注意AGP版本与Gradle版本需匹配，可参考官方对应关系调整。

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