注意：9.0（API level 28）随新版本的支持库发布，属于该库。该库除了现有的支持库外还包含最新的组件。

p>

您可以继续使用此支持库过去的工件（在这种情况下，版本 27 和更早版▓本，并打包为 ..*）在 Maven 中仍然可用。但是，所有新的库开发都将在库中进行。

我们建议在所有新项目中使用该库。您还应该考虑将现有项目迁移到。

在开发支持多个 API 版本的应用程序时，您可能需〓要一种标准方法来为系统的早期版本提供新功能，或者优雅地回退到等效功能。您可以利用这些库来提供适当的兼容性层，而无需编译代码来处理平台的早期版本。此外，支持库还提供了标准 API 中没有的附加工具类和功能，使开发和支持更多设备变得更加容易。

支持库最初是用于各种应用程序的单个二进制库，但已演变成一套用于应用程序开发的库。在应用程序开发过程中，如果没有必要，现在强烈推荐其中许多库。

本文概述了支持库，以帮助您了解其组件以及如何在您的应用程序中有效地使用它们。

注意：从支持库版本 26.0.0（2017 年 7 月）开始，大多数支持库支持的最低 API 级别已提升到 4.0（API 级别 1 4）。有关详细信息，请参阅本文档中的部分。

支持库的目的

支持库」有一些独特的用途，平台早期版本的向后兼容类只是其中之一。下表提供了应用程序中使用支持库的完整列表：

使用 API 和使用 API

支持库提供的类和方法与框架中的 API 非常相似。考虑到这一点，您可能需要决定是应该使用 API 的框架版本，还是使用等效的支持库。以下指南描述了何时应使用支持库类而不是 API：

由于主机设备平台版本的限制，提供平台 API 类的兼容实现的支持库类可能无法在最新版本中提供完整的功能集。在这种情况下it支持，支持库类会优雅地降级，并且可能无法提供当前平台 API 的所有功能或数据。因此，您应该查看您正在使用的库类和方法的参考文档，并在运行您的应用支持的最早版本平台的设备上进行彻底测试。

注意：支持库并不为每个框架 API 提供等效的类和方法。在某些情况下，您可能需要将框架方法调用放入显式 SDK 版本检查※块中，并提供替代代码来处理设备上不可用的方法。有关在代码中使用版本检查的更多信息，请参阅支持不同的平台版本。

版本支持和⊙包名称

部分支持库包的名称表示它最初支持的最低 API 级别。这些名称使用 v# 表示法，例如 -v4 包。从支持库版本 26.0.0（2017 年 7 月发布）开始，所有支持库包支持的最低 API 级别已更改为 4.0（API 级别 14）. 因此，当使用任何最新版本的支持库时，您不应假设 v# 包符号会指示最低 API 支持级别。最新版本中的这种更改也意味着名称分别为 v4 和 v7 库 for 本质上等价于其支持的最低 API 级别，例如对于 26.0.0 及更高支持库，-v4 和 -v7 包支持的最低 API 级别均为 14 .

支持库版本

支持的库的发布版本（例如 24.2.0 或 25.0.1） 不同于任何库支持的最低版本对应的版本 API 级别。发布版本号可以指示该版本是针对哪个平台 API 版本编译的，因此，该版本的库中可能包含哪些最新的 API。

具体来说，发布版本号的第一部分（例如，版本号 24.2.0 中的 24））通常▆对应于当时可用的平台 API 版本发布了相应的版本。支持库的发布版本级别可以表明该版本集成了相应API级别的一些功ㄨ能，但不应假设它兼容新平台API版本中发布的所有功能。

库依赖项

支持库套件中的大多数库都依赖于一个或多个库。例如it支持，几乎所有的支持库都依赖于 - 包。通常，您无需担心支持库依赖项，因为构建工具通过自动包含依赖库来为您管理库依赖项。

如果您想查看您的应用中包含哪些库和库依赖项，请在您的应用开发项目的构建根目录中运行以下命令以获取有关此项目的依赖项的报告，包括支持库和其他库：

    gradle -q dependencies your-app-project:dependencies
    

有关如何使用将支持库添加到您的开发项目的详细信息，请参阅支持库设置。使用方法详见配置构建系统。

请注意，所有支持库也依赖于一些基础平台。对于最新版本，它取决于 4.0（API 级别 14） 或更高。