此页面由 Cloud Translation API 翻译。

支持库软件包

注意：随着 Support Library 28.0.0 的发布，android.support 打包的库已废弃，取而代之的是具有单独版本编号的 Jetpack 库打包为 androidx。初始的 1.0.0 Jetpack 库的版本与支持库 28.0.0 等效，并且提供迁移到新 androidx 的起点

现有的 android.support 打包库将继续正常运行；然而，不会收到 28.0.0 之后的任何更新，并且与新的 Jetpack 库不兼容。历史工件（版本 27 及更早版本，并打包为 android.support 的工件）在 Google Maven 中仍然可用。所有新制品都将打包为 androidx 并需要从 android.support 进行迁移发送至 androidx。

我们建议在所有新项目中使用 androidx 库。您还应该可以考虑迁移现有项目，以确保继续接收问题修复和库的其他改进。

Android 支持库包含多个可以添加的库软件包。其中每个库都支持特定范围的 Android 平台版本和功能集。

要使用以下任意库，您必须将库文件下载到 Android SDK 安装。按照下载支持库的说明操作，网址为：支持库设置完成此步骤。您必须执行额外的步骤才能将特定的支持库添加到部署应用请参阅下文中每个库部分的末尾，了解有关如何将库添加到您的应用中

注意：所有支持的最低 SDK 版本库软件包的最低 API 级别为 14。某些软件包需要更高的 API （如下所述）。

v4 支持库

与其他库相比，这些库包含最大的 API 集，包括对应用组件、界面功能的支持，无障碍功能、数据处理、网络连接和编程实用程序。

有关 v4 支持库，请参阅 API 参考文档中的 android.support.v4 软件包。

注意：在支持库修订版 24.2.0 之前，单一 v4 支持库。该库分为多个模块提高效率。为了实现向后兼容性，如果您列出 support-v4 时，您的应用将包含 v4 模块。不过，为了缩减应用大小应用需要的特定模块。

v4 compat 库

为多种框架 API 提供兼容性封装容器，例如 Context.obtainDrawable()和 View.performAccessibilityAction()。

此库的 Gradle 编译脚本依赖项标识符如下所示：

com.android.support:support-compat:28.0.0

v4 core-utils 库

提供多种实用程序类，例如 AsyncTaskLoader 和 PermissionChecker。

此库的 Gradle 构建脚本依赖项标识符如下所示：

com.android.support:support-core-utils:28.0.0

v4 core-ui 库

实现各种与界面相关的组件，例如 ViewPager、NestedScrollView 和 ExploreByTouchHelper。

此库的 Gradle 构建脚本依赖项标识符如下所示：

com.android.support:support-core-ui:28.0.0

v4 media-compat 库

媒体框架的向后移植部分，包括MediaBrowser和MediaSession。

此库的 Gradle 构建脚本依赖项标识符如下所示：

com.android.support:support-media-compat:28.0.0

v4 fragment 库

添加了对封装界面和功能的支持， fragment、使应用能够提供可在小尺寸和大屏设备。此模块依赖于 compat、core-utils、core-ui 和 media-compat。

注意：v13 支持库提供了 FragmentCompat 类。v4 Fragment 类是一个独立的类，提供了在以后平台版本中增加的错误修复，而 v13 FragmentCompat 类提供的框架实现的兼容性填充码 Fragment 类。

此库的 Gradle 构建脚本依赖项标识符如下所示：

com.android.support:support-fragment:28.0.0

Multidex 支持库

此库支持使用多个 Dalvik 可执行文件 (DEX) 构建应用。如果应用引用超过 65536 种方法，则必须使用多 dex 配置。对于有关使用 MultiDex 的详情，请参阅使用超过 6.4 万种方法构建应用。

此库的 Gradle 构建脚本依赖项标识符如下所示：

com.android.support:multidex:1.0.0

v7 支持库

这些库提供特定的功能集，并且可以包含在您的应用中相互独立

v7 appcompat 库 Android Jetpack 的一部分。

注意：appcompat 库已迁移到 AndroidX 库，它是一个Android Jetpack 组件。在 Sunflower 演示版应用。

此库增加了对操作栏用户界面设计模式。此库支持 Material Design 界面实现。

注意：此库依赖于 v4 支持库。

以下是 v7 appcompat 库中包含的几个关键类：

ActionBar - 提供操作栏的实现界面模式。有关有关如何使用操作栏的信息，请参阅操作栏开发者指南。
AppCompatActivity - 添加了一个应用 activity 类，该类可以用作使用支持库操作栏的 activity 的基类实施。
AppCompatDialog - 添加了可用作基础的对话框类类。
ShareActionProvider - 添加对可包含在操作栏。

此库的 Gradle 编译脚本依赖项标识符如下所示：

com.android.support:appcompat-v7:28.0.0

v7 cardview 库

此库添加了对 CardView 的支持微件，可让您在具有一致外观的卡片内显示信息。这些卡片非常适合用于实现，并且广泛用于 TV 应用的布局。

此库的 Gradle 编译脚本依赖项标识符如下所示：

com.android.support:cardview-v7:28.0.0

v7 gridlayout 库

下载 Android 支持库后，此库会添加对 GridLayout 类，可让您使用矩形单元格网格排列界面元素。如需详细了解 v7 gridlayout 库 API，请参阅 android.support.v7.widget 软件包。

此库的 Gradle 编译脚本依赖项标识符如下所示：

com.android.support:gridlayout-v7:28.0.0

v7 mediarouter 库

此库提供 MediaRouter、MediaRouteProvider 和相关媒体类，支持 Google Cast。

一般而言，v7 mediarouter 库中的 API 提供了一种控制从当前设备到外部屏幕、音箱和其他目标设备。该库包含用于发布应用专属媒体路由提供程序的 API，用于发现和选择目标设备、查看媒体状态等。如需详细了解 v7 mediarouter 库 API 的详细信息，请参阅 API 中的 android.support.v7.media 软件包参考。

此库的 Gradle 编译脚本依赖项标识符如下所示：

com.android.support:mediarouter-v7:28.0.0

支持库中引入的 v7 mediarouter 库 API r18 可能会在以后的支持库修订版中发生更改。目前我们建议您仅将该库用于 Google Cast。

v7 palette 库

v7 Palette 支持库包含 Palette 类，可让您提取图片中突出显示的颜色。例如，音乐应用可以使用 Palette 对象，用于提取主要颜色从专辑封面上挑选的图片，然后用这些颜色来创作一首协调歌曲片头字幕。

此库的 Gradle 编译脚本依赖项标识符如下所示：

com.android.support:palette-v7:28.0.0

v7 recyclerview 库

recyclerview 库添加了 RecyclerView 类。此类支持 RecyclerView 微件，该视图通过提供限制窗口的数据项。

此库的 Gradle 编译脚本依赖项标识符如下所示：

com.android.support:recyclerview-v7:28.0.0

v7 Preference 支持库

通过偏好设置包提供 API 以支持添加首选项对象，例如 CheckBoxPreference 和 ListPreference，用于修改界面设置。

v7 Preference 库增加了对以下接口的支持： Preference.OnPreferenceChangeListener和 Preference.OnPreferenceClickListener，以及类。例如 CheckBoxPreference 和 ListPreference。

此库的 Gradle 编译脚本依赖项标识符如下所示：

com.android.support:preference-v7:28.0.0

v8 支持库

此库提供特定的功能集，并且可以包含在您的应用中与其他库相互独立

v8 renderscript 库

此库增加了对 RenderScript 计算框架。这些 API 包含在 android.support.v8.renderscript 软件包中。您请注意，在应用中添加这些 API 的步骤 与其他支持库 API 不同。详细了解如何使用这些 API 请参阅 RenderScript 开发者指南。

注意：Android 支持将 RenderScript 与支持库搭配使用基于 Studio 和 Gradle 的 build。通过 renderscript 库位于 build-tools/$VERSION/renderscript/ 文件夹中。

以下示例展示了此库的 Gradle 编译脚本属性：

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

v13 支持库

此库增加了对 Fragment 界面模式具有 (FragmentCompat) 类和其他 fragment 支持类。如需详细了解 fragment，请参阅 fragment 开发者指南。如需详细了解如需了解 v13 支持库 API，请参阅 API 参考文档中的 android.support.v13 软件包。

注意：v4 fragment 库提供了 Fragment 类。v4 Fragment 类是一个独立的类，提供了在以后平台版本中增加的错误修复，而 v13 FragmentCompat 类提供的框架实现的兼容性填充码 Fragment 类。

此库的 Gradle 编译脚本依赖项标识符如下所示：

com.android.support:support-v13:28.0.0

v14 Preference 支持库

android.support.v14.preference 软件包提供了用于添加支持的 API 偏好接口，例如 PreferenceFragment.OnPreferenceStartFragmentCallback 和 PreferenceFragment.OnPreferenceStartScreenCallback, 以及一些类， MultiSelectListPreference和 PreferenceFragment。如需详细了解有关 v14 Preference 支持库 API 的信息，请参阅偏好设置 API 参考中的软件包。

此库的 Gradle 编译脚本依赖项标识符如下所示：

com.android.support:preference-v14:28.0.0

适用于电视的 v17 Preference 支持库

android.support.v17.preference 软件包提供了用于提供偏好设置的 API TV 设备上的用户界面，其中包括对 LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener 接口和类，例如 BaseLeanbackPreferenceFragment 和 LeanbackPreferenceFragment。如需详细了解有关 v17 Preference 支持库 API 的信息，请参阅偏好设置 API 参考中的软件包。

此软件包需要 API 级别 17 或更高级别。Gradle 构建脚本此库的依赖项标识符如下所示：

 com.android.support:preference-leanback-v17:28.0.0

v17 Leanback 库

android.support.v17.leanback 软件包提供的 API 来支持构建界面。它提供了一些适用于电视应用的重要微件。一些重要的类包括：

BrowseFragment - 以下各项的 fragment：创建用于浏览媒体类别和行的主要布局项。
DetailsFragment - 封装容器 Leanback 详情屏幕的 Fragment。
PlaybackOverlayFragment - A 是适用于以下对象的 DetailsFragment 的子类：显示播放控件和相关内容。
SearchFragment - 用于处理搜索。fragment 接收用户的搜索请求，并传递传递给应用提供的 SearchResultProvider。SearchResultProvider 会将搜索结果返回到 SearchFragment，渲染它们转换为 RowsFragment。

此软件包需要 API 级别 17 或更高级别。Gradle 构建脚本此库的依赖项标识符如下所示：

com.android.support:leanback-v17:28.0.0

Vector Drawable 库

提供对静态矢量图形的支持。

此库的 Gradle 构建脚本依赖项标识符为如下：

com.android.support:support-vector-drawable:28.0.0

Animated Vector Drawable 库

提供对动画矢量图形的支持。

此库的 Gradle 构建脚本依赖项标识符为如下：

com.android.support:animated-vector-drawable:28.0.0

Annotations 支持库

注解软件包提供用于支持向应用添加注解元数据的 API。

此库的 Gradle 编译脚本依赖项标识符如下所示：

com.android.support:support-annotations:28.0.0

Design 支持库

通过 Design 软件包提供支持向应用添加 Material Design 组件和模式的 API。

设计支持库增加了对各种 Material Design 组件和模式的支持，例如，抽屉式导航栏、悬浮操作按钮 (FAB)，信息条和标签页。

此库的 Gradle 编译脚本依赖项标识符如下所示：

com.android.support:design:28.0.0

Custom Tabs 支持库

通过自定义标签页软件包提供的 API 支持在应用中添加和管理自定义标签页。

自定义标签页支持库增加了对各种类的支持，例如自定义标签页服务和自定义标签页 Callback。

此软件包需要 API 级别 15 或更高级别。此库的 Gradle 编译脚本依赖项标识符如下所示：

com.android.support:customtabs:28.0.0

Percent 支持库

通过百分比软件包提供的 API 支持添加和管理基于百分比的尺寸

注意：从 26.0.0 版开始，Percent 支持库已被弃用。此模块的客户端应迁移到新的 ConstraintLayout 微件，后者作为 SDK 管理器中的单独工件提供。

Percent 支持库增加了对 <ph type="x-smartling-placeholder"></ph> PercentLayoutHelper.PercentLayoutParams 接口以及各种类别， PercentFrameLayout 和 PercentRelativeLayout。

此库的 Gradle 编译脚本依赖项标识符如下所示：

com.android.support:percent:28.0.0

ExifInterface 支持库

Exif 代码存储屏幕方向、日期和时间、相机等信息信息和位置直接在 JPEG 或 RAW 文件中ExifInterface 类取消了对从 JPEG 读取 Exif 信息的支持和原始格式（DNG、CR2、NEF、NRW、ARW、RW2、ORF、PEF、SRW 和 RAF）文件，以及在 JPEG 图片文件上设置 Exif 信息。

此库的 Gradle 构建脚本依赖项标识符如下所示：

com.android.support:exifinterface:28.0.0

适用于电视的 App Recommendation 支持库

通过应用程序建议软件包提供 API，以支持在电视设备上运行的应用中添加内容推荐。

应用库添加了对注解的支持，例如 <ph type="x-smartling-placeholder"></ph> ContentRecommendation.ContentMaturity 和各种类，例如内容推荐和 RecommendationExtender。

此软件包需要 API 级别 21 或更高级别。此库的 Gradle 编译脚本依赖项标识符如下所示：

com.android.support:recommendation:28.0.0

Wear 界面库

此库包含用于为 Wear 应用构建界面的 API。 API <ph type="x-smartling-placeholder"></ph> android.support.wear.widget 软件包，替换穿戴式设备支持库中的相应 API。

如需了解详情，请参阅 <ph type="x-smartling-placeholder"></ph> 使用 Wear 界面库。

此库的 Gradle 构建脚本依赖项标识符如下所示：

com.android.support:wear:28.0.0