設定 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 Meerkat | 2024.3.1 以上版本。

更新應用程式的建構設定

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

android {
    compileSdk = 37
}

android {
    compileSdk = 37
}

Android Studio 可透過 Android SDK 升級工具，提供行為異動的相關資訊。準備好選擇加入 Android 17 的新執行階段行為後，請按照下列步驟更新應用程式的 targetSdk：

android {
    defaultConfig {
        targetSdk = 37
    }
}

android {
    defaultConfig {
        targetSdk = 37
    }
}

手動安裝 SDK

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

1. 依序點選「Tools」>「SDK Manager」。
2. 在「SDK Platforms」分頁中，展開「Android Cinnamon Bun Preview」部分，然後選取「Android SDK Platform Cinnamon Bun」套件。
3. 在「SDK 工具」分頁中，展開「Android SDK Build-Tools 37」部分，然後選取最新的 37.x.x 版本。
4. 按一下「OK」，安裝 SDK。

後續步驟

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

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

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