设置 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。
2. 在 SDK Platforms 标签页中，展开 Android 14.0（“UpsideDownCake”） 部分，然后选择 Android SDK Platform 34 软件包。
3. 在 SDK Tools 标签页中，展开 Android SDK Build-Tools 34 部分 然后选择最新的34.x.x版本。
4. 点击应用 >确定以下载并安装所选软件包。

更新应用的 build 配置

如需访问 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 或更高版本，请使用以下 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 项功能。