Flutter项目android/build.gradle异常：flutter_keyboard_visibility命名空间未指定

问题核心 #

报错源于:flutter_keyboard_visibility模块未指定命名空间——这是Android Gradle插件（AGP）7.0版本及以上的强制要求：所有Android库模块必须声明命名空间，否则无法完成构建配置。

可行解决方案 #

• 升级依赖包（优先推荐）
  直接将flutter_keyboard_visibility升级到最新版本，新版本通常已适配AGP的命名空间规则。修改项目pubspec.yaml中的依赖：

  dependencies:
    flutter_keyboard_visibility: ^最新版本号
  

  执行flutter pub get拉取更新后的包即可。

• 手动为目标模块添加命名空间
  若暂时无法升级依赖，可手动修改插件的构建配置文件：

  1. 找到插件本地路径：android/.pub-cache/hosted/pub.dev/flutter_keyboard_visibility-当前版本号/android/build.gradle
  2. 在文件的android代码块中添加命名空间配置：

     android {
         namespace 'com.jrai.flutter_keyboard_visibility'
         // 保留原有其他配置
     }
     

• 全局自动配置命名空间（适配多插件问题）
  若多个第三方插件都存在同类问题，可在根目录android/build.gradle中添加全局规则，自动为所有子库模块设置命名空间：

  subprojects {
      afterEvaluate { project ->
          if (project.hasProperty('android') && project.android instanceof com.android.build.gradle.LibraryExtension) {
              project.android {
                  namespace project.group
              }
          }
      }
  }
  

验证步骤 #

修改完成后，执行flutter clean清理构建缓存，再运行flutter build apk或直接启动项目，确认报错是否消失。

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