模塊級 `build.gradle`**(通常是 `app/build.gradle`)中的 `defaultConfig` 塊:
android {
// ...
defaultConfig {
applicationId "com.example.myapp"
minSdkVersion 21 // 最低支援 API Level
targetSdkVersion 34 // 目標編譯 API Level(建議最新)
versionCode 1
versionName "1.0"
}
}
| 誤區 | 正確理解 |
|---|---|
| 以為改 `AndroidManifest.xml` 的 `uses-sdk` | Gradle 構建時會**覆蓋** Manifest 中的值,以 `build.gradle` 為準。 |
| 以為要在 SDK Manager 下載對應版本才能改 | `minSdkVersion` 僅聲明兼容性,**無需下載該版本 SDK**;但 `compileSdkVersion`/`targetSdkVersion` 需對應 SDK Platform 已安裝。 |
| 直接刪除 SDK 目錄試圖「換版本」 | 會導致構建失敗;正確途徑:SDK Manager 勾選安裝/解除安裝。 |
| 以為 `minSdkVersion` 越低越好 | 過低會丟失新 API、增加適配成本、安全風險;主流 App 現建議 **21+ (Android 5.0)**。 |
productFlavors {
demo {
minSdkVersion 23
}
full {
minSdkVersion 21
}
}
**一句话總結:只動 `app/build.gradle` 裡的 `defaultConfig.minSdkVersion`,Sync 即可,別碰 Manifest、別刪 SDK 目錄。**