設定 Android 14 SDK

如要使用 Android 14 API 進行開發，並以 Android 14 的行為變更測試應用程式，則需要設定 Android 14 SDK。請按照本頁的操作說明，在 Android Studio 中設定 Android 14 SDK，並在 Android 14 上建構並執行應用程式。

取得 Android Studio

Android 14 SDK 包含與部分較低版本 Android Studio 不相容的變更。為了在 Android 14 SDK 上獲得最佳開發體驗，請使用 Android Studio Flamingo | 2022.2.1 以上版本。

取得 Android Studio

安裝 SDK

在 Android Studio 中，您可以依照下列方式安裝 Android 14 SDK：

1. 按一下「Tools」>「SDK Manager」。
2. 在「SDK Platforms」分頁中，展開「Android 14.0 (「UpsideDownCake」)」部分，然後選取「Android SDK Platform 34」套件。
3. 在「SDK Tools」分頁中，展開「Android SDK Build-Tools 34」部分，然後選取最新的 34.x.x 版本。
4. 依序點選「Apply」>「OK」，下載並安裝所選套件。

更新應用程式的建構設定

如要存取 Android 14 API 並測試應用程式與 Android 14 的相容性，請開啟模組層級的 build.gradle 或 build.gradle.kts 檔案，然後更新 Android 14 的值。這個值的格式取決於您使用的 Android Gradle 外掛程式 (AGP) 版本。

注意： 如果您尚未準備好全面支援 Android 14，仍可使用可進行偵錯的應用程式、Android 14 裝置以及相容性架構，執行應用程式相容性測試，不必變更應用程式來編譯或指定 SDK。

AGP 7.0.0 以上版本

如果您使用 AGP 7.0.0 以上版本，請將應用程式的 build.gradle 或 build.gradle.kts 檔案更新為下列 Android 14 的值：

Groovy

android {
    compileSdk 34
    ...
    defaultConfig {
        targetSdk 34
    }
}

Kotlin

android {
    compileSdk = 34
    ...
    defaultConfig {
        targetSdk = 34
    }
}

AGP 4.2.0 以下版本

如果您使用 AGP 4.2.0 以下版本，請將應用程式的 build.gradle 或 build.gradle.kts 檔案更新為下列 Android 14 的值：

Groovy

android {
    compileSdkVersion "34"
    ...
    defaultConfig {
        targetSdkVersion "34"
    }
}

Kotlin

android {
    compileSdkVersion = "34"
    ...
    defaultConfig {
        targetSdkVersion = "34"
    }
}

後續步驟

如要瞭解可能會影響應用程式的變更，以及如何在應用程式中測試這些變更，請詳閱下列主題：

• 影響所有應用程式的行為變更
• 只影響指定 Android 14 應用程式的行為變更

如要進一步瞭解 Android 14 所提供的新 API 和功能，請參閱 Android 14 功能。