支持库包

注意：随着 Support Library 28.0.0 的发布，android.support 包含的库已弃用，并被单独版本化的 Jetpack 库替换，这些库打包为 androidx。Jetpack 库的初始 1.0.0 版本提供了与 Support Library 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 包。

注意：在 Support Library 修订版 24.2.0 之前，只有一个 v4 支持库。为了提高效率，该库被分为多个模块。为了向后兼容，如果您在 Gradle 脚本中列出 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 库

实现各种与 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 库

使用片段添加对封装用户界面和功能的支持，使应用程序能够提供在小型和大型屏幕设备之间调整的布局。此模块依赖于 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 个方法的应用需要使用 multidex 配置。有关使用 multidex 的更多信息，请参阅使用超过 64K 个方法构建应用。

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

com.android.support:multidex:1.0.0

v7 支持库

这些库提供特定的功能集，可以独立于彼此包含在您的应用程序中。

v7 appcompat 库是 Android Jetpack 的一部分。

注意：appcompat 库已迁移到 AndroidX 库，它是 Android Jetpack 组件。请在 Sunflower 演示应用中查看它的使用。

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

注意：此库依赖于 v4 Support Library。

以下是 v7 appcompat 库中包含的一些关键类

ActionBar - 提供操作栏用户界面模式的实现。有关使用操作栏的更多信息，请参阅操作栏开发者指南。
AppCompatActivity - 添加了一个应用程序活动类，可以用作使用 Support Library 操作栏实现的活动的基类。
AppCompatDialog - 添加了一个对话框类，可以用作基于 AppCompat 主题的对话框的基类。
ShareActionProvider - 添加了对标准化共享操作（例如电子邮件或发布到社交应用程序）的支持，这些操作可以包含在操作栏中。

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

com.android.support:appcompat-v7:28.0.0

v7 cardview 库

此库增加了对CardView小部件的支持，使您可以在任何应用程序中显示具有统一外观的卡片中的信息。这些卡片对于 Material Design 实现非常有用，并且广泛用于电视应用程序的布局中。

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

com.android.support:cardview-v7:28.0.0

v7 gridlayout 库

下载 Android Support Libraries 后，此库将增加对GridLayout类的支持，允许您使用矩形单元格网格来排列用户界面元素。有关 v7 gridlayout 库 API 的详细信息，请参阅 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

Support Library r18 中引入的 v7 mediarouter 库 API 在 Support Library 的后续版本中可能会发生更改。目前，我们建议仅将其与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 支持库

preference包提供 API，支持添加首选项对象，例如CheckBoxPreference和ListPreference，供用户修改 UI 设置。

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

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

com.android.support:preference-v7:28.0.0

v8 Support Library

此库提供特定的功能集，可以独立于其他库包含在您的应用程序中。

v8 renderscript 库

此库增加了对RenderScript计算框架的支持。这些 API 包含在android.support.v8.renderscript包中。您应该注意，将这些 API 包含到您的应用程序中的步骤与其他支持库 API _非常不同_。有关在您的应用程序中使用这些 API 的更多信息，请参阅RenderScript开发者指南。

注意：使用支持库的 RenderScript 支持 Android Studio 和基于 Gradle 的构建。renderscript 库位于build-tools/$VERSION/renderscript/文件夹中。

以下示例显示了此库的 Gradle 构建脚本属性

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

v13 Support Library

此库使用(FragmentCompat)类和附加的片段支持类增加了对Fragment用户界面模式的支持。有关片段的更多信息，请参阅Fragments开发者指南。有关 v13 Support Library 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 参考中的preference包。

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

com.android.support:preference-v14:28.0.0

v17 Preference 支持库（适用于电视）

android.support.v17.preference包提供 API，用于在电视设备上提供首选项接口，包括对LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener接口和类（例如BaseLeanbackPreferenceFragment和LeanbackPreferenceFragment）的支持。有关 v17 Preference 支持库 API 的详细信息，请参阅 API 参考中的preference包。

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

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

v17 Leanback 库

android.support.v17.leanback包提供 API，支持在电视设备上构建用户界面。它为电视应用程序提供许多重要的小部件。一些值得注意的类包括

BrowseFragment - 用于创建浏览媒体项目类别和行的主要布局的片段。
DetailsFragment - Leanback 详情屏幕的包装器片段。
PlaybackOverlayFragment - DetailsFragment的子类，用于显示播放控件和相关内容。
SearchFragment - 用于处理搜索的片段。片段接收用户的搜索请求，并将其传递给应用程序提供的SearchResultProvider。SearchResultProvider将搜索结果返回到SearchFragment，后者将其渲染到RowsFragment中。

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

com.android.support:leanback-v17:28.0.0

矢量可绘制对象库

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

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

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

动画矢量可绘制对象库

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

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

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

注释支持库

Annotation包提供 API，支持向您的应用程序添加注释元数据。

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

com.android.support:support-annotations:28.0.0

设计支持库

Design包提供 API，支持向您的应用程序添加 Material Design 组件和模式。

Design Support 库为应用开发者提供了各种 Material Design 组件和模式的支持，例如导航抽屉、浮动操作按钮（FAB）、Snackbar 和标签。

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

com.android.support:design:28.0.0

自定义标签支持库

自定义标签包提供了 API，用于支持在您的应用中添加和管理自定义标签。

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

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

com.android.support:customtabs:28.0.0

百分比支持库

百分比包提供了 API，用于支持在您的应用中添加和管理基于百分比的尺寸。

注意：从 26.0.0 版本开始，百分比支持库已弃用。此模块的客户端应迁移到新的ConstraintLayout小部件，该小部件作为 SDK 管理器中的单独工件提供。

百分比支持库增加了对PercentLayoutHelper.PercentLayoutParams接口和各种类的支持，例如PercentFrameLayout和PercentRelativeLayout。

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

com.android.support:percent:28.0.0

ExifInterface 支持库

Exif 标签直接在 JPEG 或 RAW 文件中存储诸如方向、日期和时间、相机信息以及位置之类的信息。ExifInterface类解包了从 JPEG 和原始 (DNG、CR2、NEF、NRW、ARW、RW2、ORF、PEF、SRW 和 RAF) 格式的文件读取 Exif 信息以及在 JPEG 图像文件中设置 Exif 信息的支持。

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

com.android.support:exifinterface:28.0.0

适用于电视的应用推荐支持库

应用推荐包提供了 API，用于支持在您的在电视设备上运行的应用中添加内容推荐。

应用库增加了对注释的支持，例如ContentRecommendation.ContentMaturity和各种类，例如ContentRecommendation和RecommendationExtender。

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

com.android.support:recommendation:28.0.0

Wear UI 库

此库具有用于构建 Wear 应用用户界面的 API。这些 API 位于android.support.wear.widget包中，它们替换了 Wearable 支持库中的相应 API。

有关更多信息，请参阅使用 Wear UI 库。

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

com.android.support:wear:28.0.0

支持库包

v4 支持库

v4 compat 库

v4 core-utils 库

v4 core-ui 库

v4 media-compat 库

v4 fragment 库

Multidex 支持库

v7 支持库

v7 appcompat 库 是 Android Jetpack 的一部分。

v7 cardview 库

v7 gridlayout 库

v7 mediarouter 库

v7 palette 库

v7 recyclerview 库

v7 Preference 支持库

v8 Support Library

v8 renderscript 库

v13 Support Library

v14 Preference 支持库

v17 Preference 支持库（适用于电视）

v17 Leanback 库

矢量可绘制对象库

动画矢量可绘制对象库

注释支持库

设计支持库

自定义标签支持库

百分比支持库

ExifInterface 支持库

适用于电视的应用推荐支持库

Wear UI 库

v7 appcompat 库是 Android Jetpack 的一部分。