ExpiredTargetSdkVersion

2025-07-16

在特定的硬件项目开发中，受部分硬件支持库的限制，项目的目标 SDK 版本可能会设置为已经不受 Google 支持的版本。如果在生成 APK 的过程中出现 ExpiredTargetSdkVersion 错误，那就标志着项目所设定的 targetSdk 已经过期，我们可能需要升级 API 级别或采取其他措施。错误信息如下：

Error: Google Play requires that apps target API level 33 or higher. [ExpiredTargetSdkVersion]
        targetSdk = 28
        ~~~~~~~~~~~~~~

   Explanation for issues of type "ExpiredTargetSdkVersion":
   Configuring your app or sdk to target a recent API level ensures that users
   benefit from significant security and performance improvements, while still
   allowing your app to run on older Android versions (down to the
   minSdkVersion).

   To update your targetSdkVersion, follow the steps from "Meeting Google Play
   requirements for target API level",
   https://developer.android.com/distribute/best-practices/develop/target-sdk.
   html

   https://support.google.com/googleplay/android-developer/answer/113469#targetsdk
   https://developer.android.com/distribute/best-practices/develop/target-sdk.html

错误中明确了 Google Play 对应用程序“目标 API 级别”的最低要求为 33 或更高。这意味着如果程序的目标 SDK 小于 33，程序将无法发布到 Google Play。但我们的项目并没有发布到 Google Play 的需求，另外受硬件支持库的限制，我们只能将目标 SDK 设置为过期版本。但这样是打不出包的，我们需要在配置信息中增加一条抑制注释告诉 Android Studio 的代码检查工具（Lint）忽略此处关于 targetSdkVersion 过期的警告。配置如下：

android {
    namespace = "com.sunzn.master"
    compileSdk = 28

    defaultConfig {
        applicationId = "com.sunzn.master"
        minSdk = 26
        //noinspection ExpiredTargetSdkVersion
        targetSdk = 28
        versionCode = 1
        versionName = "1.0.1"
    }
}

在 targetSdk 上增加注释：//noinspection ExpiredTargetSdkVersion 后，就可以解决打包问题了。

✦ 注意：这个注释只是一个屏蔽 IDE 警告的工具。它不能解决应用因 targetSdk 过低而被 Google Play 拒绝的问题。唯一正确的解决方法是升级你的 targetSdk 到 Google Play 要求的最低版本或更高，并进行充分测试。