升级Android Gradle Plugin从7.1.3到7.2.2致项目构建失败

一、"Cannot query the value of property 'namespace'" 错误排查方向 #

• 检查app/build.gradle里的namespace配置：AGP 7.0+要求直接在android块下用固定字符串声明namespace，如果用变量、读取外部配置等动态方式赋值，就会触发这个错误
• 排查第三方插件或自定义脚本：部分第三方插件、自定义Gradle任务可能在项目配置完成前就尝试读取namespace属性，导致冲突
• 核对Gradle版本兼容性：AGP 7.2.2必须搭配Gradle 7.3.3版本使用，版本不匹配会引发配置阶段的异常

二、可能的修复方案 #

• 修正namespace配置方式：直接在android块里用字符串写死包名，别用动态逻辑，示例：

  android {
      namespace "com.your.package.name"
      // 其他配置项
  }
  

  避免使用project.property("xxx")这类动态赋值的写法
• 调整插件应用顺序：如果是第三方插件导致的问题，把com.android.application插件放在所有其他插件前面应用
• 匹配对应Gradle版本：修改项目根目录gradle/wrapper/gradle-wrapper.properties里的distributionUrl：

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

• 回退AGP先解决原始问题：如果暂时搞不定AGP升级的错误，先回退到7.1.3版本，转而处理Android 10及以下的"应用未安装"问题：
  • 检查targetSdkVersion和minSdkVersion配置，确保覆盖Android 10版本
  • 验证签名文件一致性：签名不匹配会导致安装后无法启动，确认release包使用的签名和上架时完全一致
  • 排查包名冲突：部分用户设备可能存在同名应用的残留数据，可引导用户清除相关数据后重新安装

三、Android Gradle Plugin 7.2版本变更日志位置 #

AGP 7.2的变更日志不用去外部官网找，在Android Studio内置文档里就能查看：

• 打开Android Studio，点击顶部菜单Help > Help Documentation
• 在搜索栏输入"Android Gradle Plugin 7.2 Release Notes"，即可找到对应版本的详细变更内容
• 也可以在项目根目录的build.gradle中，将鼠标悬停在AGP版本号上，点击弹出的"Open Documentation"链接查看

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