怎么升级到API安卓14

API安卓14是Google预计于2023年8月发布的最新的安卓系统版本，它对应于Android 14操作系统，也被称为Android Tiramisu1。API安卓14将带来许多新的功能和改进，例如各应用语言偏好设定、语法变化API、屏幕截图检测等2。如果您想在您的应用中使用API安卓14，并测试您的应用与Android 14的兼容性，您需要设置API安卓14 SDK。本文将介绍如何在Android Studio中设置API安卓14 SDK，并在Android 14上构建和运行您的应用。

获取Android Studio

API安卓14 SDK包含了与某些旧版Android Studio不兼容的变更。为了获得API安卓14 SDK的最佳开发体验，请使用Android Studio Chipmunk | 2021.2.1或更高版本3。您可以从这里下载最新版的Android Studio。

安装SDK

在Android Studio中，您可以按如下方式安装API安卓14 SDK：

• 依次点击 Tools > SDK Manager 。
• 在 SDK Platforms 标签页中，选择 Android Tiramisu Preview 。
• 在 SDK Tools 标签页中，选择 Android SDK Build-Tools 34 。
• 点击 OK 安装 SDK。

更新应用的build配置

如需访问API安卓14并测试您的应用与Android 14的兼容性，请打开模块级 build.gradle 或 build.gradle.kts 文件，并使用API安卓14所对应的值对它们进行更新：如何设置这些值的格式取决于您所使用的Android Gradle插件 (AGP) 版本。

注意：如果您尚未准备好完全支持Android 14，您仍然可以使用可调试的应用、Android 14设备和兼容性框架来执行应用兼容性测试，而无需更改应用以使其与SDK兼容或以此为目标平台。

AGP 7.0.0或更高版本

如果您使用的是AGP 7.0.0或更高版本，请使用以下API安卓14所对应的值更新应用的 build.gradle 或 build.gradle.kts 文件：

android {
    compileSdk "34"
    defaultConfig {
        targetSdk "34"
    }
}

AGP 4.2.0或更低版本

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

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

后续步骤

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

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

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

可能遇到的问题与解决方法

在设置和使用API安卓14 SDK时，您可能会遇到一些问题和错误。以下是一些常见问题和解决方法：

编译错误：找不到符号

如果您在编译时遇到类似于以下内容的错误：

error: cannot find symbol
import android.graphics.BlendMode;
                      ^
symbol:   class BlendMode
location: package android.graphics

这可能是因为您使用了一个不支持API安卓14的AGP版本。请确保您使用的是AGP 7.0.0或更高版本，并且在项目级 build.gradle 或 build.gradle.kts 文件中指定了正确的依赖项：

buildscript {
    dependencies {
        classpath 'com.android.tools.build:gradle:7.0.0'
    }
}

运行错误：INSTALL_FAILED_OLDER_SDK

如果您在运行时遇到类似于以下内容的错误：

Installation did not succeed.
The application could not be installed: INSTALL_FAILED_OLDER_SDK
The application's minSdkVersion is newer than the device API level.

这可能是因为您的应用的 minSdkVersion 大于您的设备或模拟器的API级别。请确保您的设备或模拟器运行的是Android 14或更高版本，并且在模块级 build.gradle 或 build.gradle.kts 文件中指定了正确的 minSdkVersion：

android {
    defaultConfig {
        minSdk "34"
    }
}

运行错误：INSTALL_PARSE_FAILED_NO_CERTIFICATES

如果您在运行时遇到类似于以下内容的错误：

Installation did not succeed.
The application could not be installed: INSTALL_PARSE_FAILED_NO_CERTIFICATES
APK signature verification failed.

这可能是因为您的应用没有正确地签名。请确保您使用了有效的签名证书，并且在模块级 build.gradle 或 build.gradle.kts 文件中指定了正确的签名配置：

android {
    signingConfigs {
        release {
            storeFile file("my-release-key.jks")
            storePassword "password"
            keyAlias "my-alias"
            keyPassword "password"
        }
    }
    buildTypes {
        release {
            signingConfig signingConfigs.release
        }
    }
}