设备兼容性概览

Android 适用于众多类型的设备，例如手机、平板电脑和电视。如此广泛的设备类型能为您的应用带来广大的潜在受众群体。为了能在所有设备上顺利运行，应用必须容许部分设备功能的变化，并提供可适应不同屏幕配置的灵活界面。

为了帮助实现设备兼容性，Android 提供了一个动态应用框架，供您在静态文件中提供特定于配置的应用资源，例如针对不同屏幕尺寸的不同 XML 布局。然后，Android 会根据当前设备配置加载适当的资源。在对应用设计和额外的应用资源进行一些事先规划后，您可以发布单个应用软件包 (APK)，并在各种设备上优化用户体验。

不过，如有必要，您可以指定应用的功能要求，并控制哪些类型的设备可以从 Google Play 商店安装您的应用。本文档介绍了如何控制哪些设备可以访问您的应用，以及如何准备您的应用以覆盖合适的受众群体。

“兼容性”是什么意思？

在 Android 开发方面，兼容性分为两种：设备兼容性和应用兼容性。

由于 Android 是一个开源项目，因此任何硬件制造商都可以制造搭载 Android 操作系统的设备。不过，只有当设备能够正确运行为 Android 执行环境编写的应用时，设备才“与 Android 兼容”。Android 执行环境的确切详细信息由 Android 兼容性计划定义。每台设备都必须通过兼容性测试套件 (CTS) 测试才能被视为兼容。

作为应用开发者，您无需担心设备是否与 Android 兼容，因为只有与 Android 兼容的设备才会包含 Google Play 商店。因此，如果用户从 Google Play 商店安装您的应用，则表示他们使用的是 Android 兼容设备。

不过，您需要考虑您的应用是否与每种可能的设备配置兼容。由于 Android 在多种配置的设备上运行，因此部分功能可能不适用于所有设备。例如，某些设备可能未配备罗盘传感器。如果应用的核心功能需要罗盘传感器，那么应用只能与带有该功能的设备兼容。

控制应用在设备上的可用性

Android 支持您的应用可通过平台 API 使用的各种功能。有些功能基于硬件（例如罗盘传感器），有些功能基于软件（例如应用窗口小工具），有些功能则依赖于平台版本。并非每台设备都支持所有功能，因此您可能需要根据应用所需的功能控制应用在设备上的可用性。

为了尽可能让您的应用获得最庞大的用户群体，请使用单个 APK 或 AAB 支持尽可能多的设备配置。在大多数情况下，为此，您可以在运行时停用可选功能，并为应用资源提供针对不同配置的替代方法（如针对不同屏幕尺寸提供不同布局）。如有必要，您可以根据以下设备特征，通过 Google Play 商店限制应用在特定设备上的可用性：

• 设备功能
• 平台版本
• 屏幕配置

设备功能

为了根据设备功能管理应用的可用性，Android 为可能并非在所有设备上都提供的任何硬件或软件功能定义了功能 ID。例如，罗盘传感器的功能 ID 为 FEATURE_SENSOR_COMPASS，而应用微件的功能 ID 为 FEATURE_APP_WIDGETS。

根据需要，要在用户的设备不具备必要功能时阻止用户安装您的应用，您可以通过应用清单文件中的 <uses-feature> 元素声明这一点。

例如，如果您的应用在缺少罗盘传感器的设备上没有意义，您可以使用以下清单标记将罗盘传感器声明为一项要求：

<manifest ... >
    <uses-feature android:name="android.hardware.sensor.compass"
                  android:required="true" />
    ...
</manifest>

Google Play 商店会将您的应用所需的功能与每个用户的设备上可用的功能进行比较，以确定您的应用是否与每台设备兼容。如果设备不具备您的应用所需的所有功能，则用户无法安装您的应用。

不过，如果应用的主要功能不需要某项设备功能，请将 required 属性设置为 "false"，并在运行时检查是否有该设备功能。如果应用功能在当前设备上不可用，请适当降级相应的应用功能。例如，您可以通过调用 hasSystemFeature() 来查询功能是否可用，如下所示：

Kotlin

if (!packageManager.hasSystemFeature(PackageManager.FEATURE_SENSOR_COMPASS)) {
    // This device doesn't have a compass. Turn off the compass feature.
    disableCompassFeature()
}

Java

PackageManager pm = getPackageManager();
if (!pm.hasSystemFeature(PackageManager.FEATURE_SENSOR_COMPASS)) {
    // This device doesn't have a compass. Turn off the compass feature.
    disableCompassFeature();
}

如需了解您可以用来通过 Google Play 商店控制应用对用户是否可用的所有过滤器，请参阅 Google Play 上的过滤器文档。

注意：一些系统权限会隐式要求具备某项设备功能。例如，如果您的应用请求对 BLUETOOTH 的访问权限，这就隐式要求具备 FEATURE_BLUETOOTH 设备功能。通过在 <uses-feature> 标记中将 required 属性设置为 "false"，您可以停用基于此功能的过滤，并使您的应用可供没有蓝牙的设备使用。如需详细了解隐式要求的设备功能，请参阅隐含功能要求的权限。

平台版本

不同的设备可能会运行不同版本的 Android 平台，例如 Android 12 或 Android 13。每个后续的平台版本通常会添加之前版本中不可用的新 API。为了指明提供哪组 API，每个平台版本都会指定一个 API 级别。例如，Android 12 的 API 级别为 31，而 Android 13 的 API 级别为 33。

您必须在 build.gradle 文件中指定 minSdkVersion 和 targetSdkVersion 值：

Kotlin

android {
    defaultConfig {
        applicationId = "com.example.myapp"

        // Defines the minimum API level required to run the app.
        minSdkVersion(30)

        // Specifies the API level used to test the app.
        targetSdkVersion(33)
        ...
    }
}

Groovy

android {
    defaultConfig {
        applicationId 'com.example.myapp'

        // Defines the minimum API level required to run the app.
        minSdkVersion 30

        // Specifies the API level used to test the app.
        targetSdkVersion 33
        ...
    }
}

如需详细了解 build.gradle 文件，请参阅配置 build。

每个后续版本的 Android 都为使用之前平台版本的 API 构建的应用提供兼容性，因此只要您的应用使用了有说明文档的 Android API，就与未来版本的 Android 兼容。

注意：targetSdkVersion 属性不会阻止您的应用安装在高于指定值的平台版本上，但它很重要，因为它向系统指示您的应用是否继承较新版本中的行为更改。如果您不将 targetSdkVersion 更新到最新版本，则系统会认为您的应用在最新版本上运行时需要向后兼容性。

不过，如果您的应用使用的是较新平台版本中添加的 API，但其主要功能并不需要这些 API，则应在运行时检查 API 级别，并在 API 级别过低时适当降级相应的功能。在这种情况下，请将 minSdkVersion 尽量设置为适用于应用主要功能的最低值，然后将当前系统的版本 SDK_INT 与 Build.VERSION_CODES 中对应于您要检查的 API 级别的代号常量进行比较，如以下示例所示：

Kotlin

if (Build.VERSION.SDK_INT < Build.VERSION_CODES.HONEYCOMB) {
    // Running on something older than API level 11, so disable
    // the drag and drop features that use ClipboardManager APIs.
    disableDragAndDrop()
}

Java

if (Build.VERSION.SDK_INT < Build.VERSION_CODES.HONEYCOMB) {
    // Running on something older than API level 11, so disable
    // the drag and drop features that use ClipboardManager APIs.
    disableDragAndDrop();
}

屏幕配置

Android 可在各种尺寸的设备上运行，包括手机、平板电脑和电视。为了按照屏幕类型对设备进行分类，Android 为每种设备定义了两个特征：屏幕尺寸（屏幕的物理尺寸）和屏幕密度（屏幕上像素的物理密度，称为 DPI）。为了简化不同的配置，Android 将这些变体归纳成组，使它们更容易作为定位目标：

• 四种广义的尺寸：小、标准、大和特大
• 几种广义的密度：mdpi（中）、hdpi（高）、xhdpi（超高）、xxhdpi（超超高）等

默认情况下，您的应用与所有屏幕尺寸和密度兼容，因为系统会根据需要为每个屏幕调整界面布局和图片资源。针对常见的屏幕密度提供优化的位图图片。

请尽可能使用灵活的布局来优化用户体验。 如果存在适用于大规模配置更改（例如纵向和横向或大窗口与小窗口大小）的布局，请考虑提供可灵活应对配置中的较小更改的备用布局。这有助于提升平板电脑、手机和可折叠设备等设备的用户体验。在多窗口模式下，当窗口更改大小时，它也非常有用。

如需了解如何针对不同屏幕创建备用资源以及如何在必要时将应用限制为特定屏幕尺寸，请参阅屏幕兼容性概览并查看大屏幕应用质量指南。

出于业务原因控制应用的可用性

除了根据设备特性限制应用的可用性之外，您可能还需要出于业务或法律原因限制应用的可用性。对于这种情况，Google Play 商店在 Play 管理中心内提供了过滤选项，可让您出于非技术原因（例如用户语言区域或无线运营商）控制应用的可用性。

出于技术兼容性原因（如必备硬件组件）的过滤始终基于 APK 或 AAB 文件中包含的信息。但是，出于非技术原因（如地理语言区域）的过滤始终在 Google Play 管理中心中处理。

其他资源：

应用资源概览

介绍了 Android 应用如何采用将应用资源与应用代码分开的结构，包括如何为特定设备配置提供备用资源。

Google Play 上的过滤器

介绍了 Google Play 商店可通过哪些不同方式阻止您的应用安装到不同设备上。

Android 中的权限

Android 如何通过权限系统来限制应用访问某些 API，该系统要求应用必须先征得用户同意，才能使用这些 API。