設定 Android 17 SDK

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

取得 Android Studio

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

取得 Android Studio

更新應用程式的建構設定

警告： 如果專案使用的 Android Gradle 外掛程式版本低於 8.9.0-rc01，請先執行 Android Gradle 外掛程式升級助理，將外掛程式升級至 8.9.0-rc01 以上版本。

如要存取 Android 17 API，請開啟應用程式的 build.gradle 或 build.gradle.kts 檔案，然後按照下列方式更新 Android 17 的 compileSdk：

Groovy

android {
    compileSdkPreview = "CinnamonBun"
}

Kotlin

android {
    compileSdkPreview = "CinnamonBun"
}

Android Studio 可透過 Android SDK 升級工具，提供行為變更的相關資訊。準備好為 Android 17 採用新的執行階段行為後，請按照下列方式更新應用程式的 targetSdk：

Groovy

android {
    defaultConfig {
        targetSdkPreview = "CinnamonBun"
    }
}

Kotlin

android {
    defaultConfig {
        targetSdkPreview = "CinnamonBun"
    }
}

手動安裝 SDK

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

1. 按一下「Tools」>「SDK Manager」。
2. 在「SDK Platforms」分頁中，展開「Android Cinnamon Bun Preview」部分，然後選取「Android SDK Platform Cinnamon Bun」套件。
3. 在「SDK Tools」分頁中，展開「Android SDK Build-Tools 37」部分，然後選取最新 37.x.x 版本。這些標籤可能會有後置字元，如 rc1 或 rc2。
4. 按一下「OK」，安裝 SDK。

後續步驟

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

• 影響所有應用程式的行為變更
• 僅影響指定 Android 17 為目標版本的應用程式行為變更

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