如何在Android Studio中无错误警告设置targetSdk

一、核心问题背景 #

用Android Studio Ladybug 2024.2.1 Patch 2创建Empty Views Activity时，默认生成的build.gradle.kts会因targetSdk低于最新API级别触发警告；将targetSdk对齐compileSdk（35）后出现错误，但应用仍能正常构建运行——这说明问题出在配置兼容层面，而非代码逻辑错误。

二、分步解决步骤 #

1. 消除“未针对最新Android版本”的警告 #

警告的本质是targetSdk未匹配当前compileSdk或Android最新API级别，正确的做法是对齐两者版本，但需同步调整相关配置以避免错误：

• 打开模块级app/build.gradle.kts，确认compileSdk值（默认应为35），将targetSdk修改为相同值：

  android {
      compileSdk = 35
      defaultConfig {
          targetSdk = 35
          // 其他配置...
      }
  }
  

2. 修复targetSdk=35时的错误 #

以下是常见错误的排查与解决方法：

• 依赖库版本过低不兼容API 35：
  检查所有依赖库（AppCompat、Material、ConstraintLayout等）的版本，升级到支持API 35的稳定版。示例：

  dependencies {
      implementation("androidx.appcompat:appcompat:1.7.0")
      implementation("com.google.android.material:material:1.12.0")
      implementation("androidx.constraintlayout:constraintlayout:2.1.4")
  }
  

• Manifest配置不符合API 35要求：
  打开AndroidManifest.xml，检查是否存在废弃配置：

  • 若使用android:allowBackup="true"但未指定android:fullBackupContent，需添加备份规则文件或调整属性；
  • 核对权限声明，确保符合API 35的权限模型（比如部分权限需动态申请或已被移除）。

• AGP版本不匹配：
  Android Studio Ladybug对应AGP版本为8.2.x，确认根目录build.gradle.kts中的AGP版本是否适配：

  plugins {
      id("com.android.application") version "8.2.2" apply false
      id("org.jetbrains.kotlin.android") version "1.9.22" apply false
  }
  

  可通过File > Project Structure > Project查看官方推荐版本并升级。

• 编译环境版本兼容问题：
  API 35推荐使用Java 17，在模块级build.gradle.kts中配置：

  android {
      compileOptions {
          sourceCompatibility = JavaVersion.VERSION_17
          targetCompatibility = JavaVersion.VERSION_17
      }
      kotlinOptions {
          jvmTarget = "17"
      }
  }
  

3. 验证与收尾 #

修改完成后：

1. 点击右上角Sync Project with Gradle Files同步配置；
2. 执行Build > Clean Project + Build > Rebuild Project；
3. 确认警告和错误是否消失。

三、特殊情况：错误仍存在但应用可运行 #

若同步后仍有错误但应用正常运行，大概率是IDE缓存或静态分析误报：

• 执行File > Invalidate Caches... > Invalidate and Restart重启IDE清除缓存；
• 临时调整Lint规则抑制误报（仅临时使用，确认问题后建议恢复）：

  android {
      lint {
          disable("TargetApi")
          abortOnError = false
      }
  }
  

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