设置 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 以下载并安装所选软件包。

更新应用的 build 配置

如需访问 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 或更高版本，请使用以下 Android 14 所对应的值更新应用的 build.gradle 或 build.gradle.kts 文件：

Groovy

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

Kotlin

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

AGP 4.2.0 或更低版本

如果您使用的是 AGP 4.2.0 或更低版本，请使用以下 Android 14 所对应的值更新应用的 build.gradle 或 build.gradle.kts 文件：

Groovy

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

Kotlin

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

后续步骤

如需了解可能影响您的应用的变更，以及如何在应用中测试这些变更，请参阅以下主题：

• 影响所有应用的行为变更
• 仅影响以 Android 14 为目标平台的应用的行为变更

如需详细了解 Android 14 中提供的新 API 和功能，请参阅 Android 14 功能。