更新Android Studio等后出现Google Play API等级要求错误（非Play部署）

核心原因：Gradle插件默认行为变更 #

更新后的Android Gradle Plugin（AGP），尤其是8.0及以上版本，默认内置了与Google Play政策对齐的SDK版本校验逻辑。这个规则是插件层面的硬编码设计，优先覆盖绝大多数开发者发布到Google Play的通用场景，并不会因为你不打算上架Play商店就自动关闭校验。

具体触发场景 #

• AGP版本强制约束：从AGP 8.0开始，官方明确要求targetSdkVersion至少对应最新Android稳定版或前一个稳定版，该规则和是否接入Google Play服务完全无关，只要用了对应版本的AGP就会触发。
• 依赖库的间接要求：如果项目依赖了Google官方库（比如com.google.android.material基础UI库、哪怕是不带Play服务的组件），这些库的更新版本可能会附带匹配Play政策的SDK版本要求，间接触发错误提示。
• Android Studio IDE校验同步：更新后的IDE会同步AGP的规则，在代码编辑、构建阶段主动校验targetSdkVersion，哪怕构建脚本本身能通过，IDE也会弹出警告或错误提示。

快速解决方向 #

• 关闭Play相关校验规则：在模块级build.gradle.kts（或build.gradle）中添加配置，禁用特定校验项：

  android {
      // ...其他配置
      
      lint {
          disable += "OldTargetApi"
          disable += "GoogleAppIndexingWarning"
          // 若有其他Play相关校验提示，可在此追加
      }
  }
  

• 匹配目标设备调整SDK版本：如果你的特定设备系统版本固定，直接将targetSdkVersion和compileSdkVersion设置为设备对应的API等级，既能满足设备兼容性，也能规避不必要的校验错误。

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