設定 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」，然後點選「Show Package Details」。
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 編譯或將 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 功能。