运行Flutter时出现Android命名空间映射警告的原因及解决办法

警告内容 #

Warning: Mapping new ns http://schemas.android.com/repository/android/common/02 to old ns http://schemas.android.com/repository/android/common/01 
Warning: Mapping new ns http://schemas.android.com/repository/android/generic/02 to old ns http://schemas.android.com/repository/android/generic/01 
Warning: Mapping new ns http://schemas.android.com/sdk/android/repo/addon2/02 to old ns http://schemas.android.com/sdk/android/repo/addon2/01 
Warning: Mapping new ns http://schemas.android.com/sdk/android/repo/addon2/03 to old ns http://schemas.android.com/sdk/android/repo/addon2/01 
Warning: Mapping new ns http://schemas.android.com/sdk/android/repo/repository2/02 to old ns http://schemas.android.com/sdk/android/repo/repository2/01 
Warning: Mapping new ns http://schemas.android.com/sdk/android/repo/repository2/03 to old ns http://schemas.android.com/sdk/android/repo/repository2/01 
Warning: Mapping new ns http://schemas.android.com/sdk/android/repo/sys-img2/03 to old ns http://schemas.android.com/sdk/android/repo/sys-img2/01 
Warning: Mapping new ns http://schemas.android.com/sdk/android/repo/sys-img2/02 to old ns http://schemas.android.com/sdk/android/repo/sys-img2/01

产生原因 #

这类警告是Android Gradle插件（AGP）版本与SDK仓库的XML命名空间版本不兼容导致的。当你使用的AGP版本较低，而SDK组件（如Build Tools、Platform Tools）已经更新到包含新命名空间（02/03版本）的版本时，旧版AGP无法识别新命名空间，只能将其映射到旧的命名空间（01版本），从而触发警告。

结合你的环境（compileSdkVersion 33），问题大概率是当前AGP版本未适配compileSdk 33对应的新命名空间规范。

解决方法 #

1. 更新Android Gradle插件版本 #

打开项目的android/build.gradle文件，修改dependencies块中的AGP版本，选择与compileSdk 33兼容的版本（推荐7.3.0及以上，比如7.4.2）：

buildscript {
    dependencies {
        classpath 'com.android.tools.build:gradle:7.4.2'
        // 其他依赖...
    }
}

2. 匹配对应Gradle版本 #

AGP版本需要与Gradle版本一一对应，打开android/gradle/wrapper/gradle-wrapper.properties文件，更新distributionUrl为匹配的Gradle版本（比如AGP 7.4.x对应Gradle 7.5）：

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

3. 清理并同步项目 #

在终端执行以下命令，清理旧构建缓存并重新同步：

flutter clean
flutter pub get
flutter run

或者在Android Studio中点击「Sync Project with Gradle Files」按钮完成同步。

4. 检查并更新SDK组件 #

打开Android SDK管理器，确保以下组件为最新且与compileSdk 33兼容：

• Android SDK Build-Tools 33.x
• Android SDK Platform-Tools
• Android SDK Platform 33

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