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
        }
    }
}