快捷導(dǎo)航

在Android Studio中修改Android版本的兩種主流方法

更新時(shí)間：2025年07月21日 10:30:21 作者：好奇的菜鳥

在 Android 開發(fā)的日常迭代中,我們經(jīng)常需要升級(jí)或降級(jí)項(xiàng)目的 minSdkVersion、targetSdkVersion 與 compileSdkVersion,本文將手把手演示在 Android Studio 里修改 Android 版本的兩種主流做法,并給出易踩的坑與最佳實(shí)踐,需要的朋友可以參考下

引言

在 Android 開發(fā)的日常迭代中，我們經(jīng)常需要升級(jí)或降級(jí)項(xiàng)目的 minSdkVersion、targetSdkVersion 與 compileSdkVersion。升級(jí)可以解鎖新特性和性能優(yōu)化；降級(jí)則可能為了兼容舊機(jī)型或快速驗(yàn)證問題。本文將手把手演示在 Android Studio 里修改 Android 版本的兩種主流做法，并給出易踩的坑與最佳實(shí)踐，幫助你少踩雷、一次過。

一、先厘清三個(gè)關(guān)鍵字段

字段名	作用簡述	常見誤區(qū)
compileSdkVersion	項(xiàng)目編譯時(shí)使用的 SDK 版本，決定你能調(diào)用哪些新 API。	并非越高越好，需與 Gradle 插件、依賴庫匹配。
minSdkVersion	應(yīng)用最低可安裝的 Android 版本。	設(shè)太低會(huì)導(dǎo)致新 API 不可用，設(shè)太高會(huì)丟失大量用戶。
targetSdkVersion	聲明“我已經(jīng)在該版本上充分測試”，影響系統(tǒng)兼容性策略。	必須 ≤ compileSdkVersion，且建議隨 Google Play 要求逐年升級(jí)。

二、方法一：圖形化操作（適合新手）

打開項(xiàng)目后，依次點(diǎn)擊菜單欄：File → Project Structure（或快捷鍵 Ctrl+Alt+Shift+S）。
在左側(cè)選擇 Modules → app → Properties 選項(xiàng)卡。
直接在下拉框里選擇需要的版本：
- Compile Sdk Version：例如 34（Android 14）。
- Min Sdk Version：例如 24（Android 7.0）。
- Target Sdk Version：例如 34（與 Compile 同級(jí)或更低）。
點(diǎn)擊 Apply → OK，Android Studio 會(huì)自動(dòng)觸發(fā) Gradle Sync。
同步完成后，Rebuild Project（Build → Rebuild Project）驗(yàn)證無報(bào)錯(cuò)即可。

三、方法二：直接改 build.gradle.kts（推薦進(jìn)階）

打開模塊級(jí)構(gòu)建腳本（app/build.gradle.kts 或 app/build.gradle），找到 android {} 區(qū)塊：

android {
    compileSdk = 34

    defaultConfig {
        applicationId = "com.example.myapp"
        minSdk = 24
        targetSdk = 34
        versionCode = 1
        versionName = "1.0"
    }
    // ... 其他配置
}

修改后按 Ctrl+S 保存，頂部會(huì)出現(xiàn) “Sync Now” 提示，點(diǎn)擊即可。
如果你喜歡命令行，也可以在終端執(zhí)行：

./gradlew assembleDebug

四、常見報(bào)錯(cuò)與排查清單

現(xiàn)象	可能原因	解決思路
Unresolved reference: Build.VERSION_CODES.TIRAMISU	compileSdk 低于 33	把 compileSdk 升到 33 及以上。
真機(jī)安裝失敗 INSTALL_FAILED_OLDER_SDK	minSdk 高于設(shè)備系統(tǒng)版本	降低 minSdk 或在 gradle 中啟用 abiFilters 分包。
同步時(shí)報(bào) Could not find com.android.tools.build:gradle:X.Y.Z	Gradle 插件版本與 compileSdk 不匹配	打開 gradle/libs.versions.toml 或 project-level build.gradle，升級(jí) com.android.tools.build:gradle 至對應(yīng)版本。

五、最佳實(shí)踐小結(jié)

年度例行升級(jí)：Google Play 每年 8 月左右會(huì)提高 targetSdkVersion 的強(qiáng)制要求，建議提前 1~2 個(gè)季度完成適配。
Lint 檢查：在 Android Studio 中運(yùn)行 Analyze → Inspect Code，可快速發(fā)現(xiàn)高版本 API 在低版本系統(tǒng)上的調(diào)用風(fēng)險(xiǎn)。
多模塊項(xiàng)目：若存在 library 模塊，需確保所有模塊的 minSdk ≤ app 模塊的 minSdk，否則合并時(shí)會(huì)報(bào)錯(cuò)。
版本對照表：收藏官方 API Levels 頁面，隨時(shí)查代號(hào)與版本號(hào)。