設定 Android 15 SDK

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

取得 Android Studio

Android 15 SDK 包含與部分較低版本 Android Studio 不相容的變更。為了在 Android 15 SDK 上獲得最佳開發體驗,請使用 Android Studio 的最新預先發布版。請記住,系統支援同時安裝多個版本,因此您不必解除安裝現有的 Android Studio 版本。

取得 Android Studio

安裝 SDK

在 Android Studio 中,您可以依照下列方式安裝 Android 15 SDK:

  1. 按一下「Tools」>「SDK Manager」
  2. 在「SDK Platforms」分頁中,展開「Android VanillaIceCream Preview」區段,然後選取「Android SDK Platform VanillaIceCream」套件。
  3. 在「SDK Tools」分頁中,展開「Android SDK Build-Tools 35」部分,然後選取最新的 35.x.x 版本。這些標籤可能會有後置字串,例如 rc1rc2
  4. 按一下「OK」,安裝 SDK。

更新應用程式的建構設定

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

AGP 7.0.0 以上版本

如果您使用 AGP 7.0.0 以上版本,請將應用程式的 build.gradlebuild.gradle.kts 檔案更新為下列 Android 15 的值:

Groovy

android {
    compileSdkPreview "VanillaIceCream"
    ...
    defaultConfig {
        targetSdkPreview "VanillaIceCream"
    }
}

Kotlin

android {
    compileSdkPreview = "VanillaIceCream"
    ...
    defaultConfig {
        targetSdkPreview = "VanillaIceCream"
    }
}

AGP 4.2.0 以下版本

如果您使用 AGP 4.2.0 以下版本,請將應用程式的 build.gradlebuild.gradle.kts 檔案更新為下列 Android 15 的值:

Groovy

android {
    compileSdkVersion "android-VanillaIceCream"
    ...
    defaultConfig {
        targetSdkVersion "android-VanillaIceCream"
    }
}

Kotlin

android {
    compileSdkVersion = "android-VanillaIceCream"
    ...
    defaultConfig {
        targetSdkVersion = "android-VanillaIceCream"
    }
}

後續步驟

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

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