支持库包

注意：随着 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 支持库。

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

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

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

com.android.support:appcompat-v7:28.0.0

v7 cardview 库

此库添加了对CardView 组件的支持，该组件允许您在卡片内显示信息，这些卡片在任何应用程序中都具有统一的外观。这些卡片对于材料设计实现很有用，并且在电视应用程序的布局中被广泛使用。

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

com.android.support:cardview-v7:28.0.0

v7 gridlayout 库

下载 Android 支持库后，此库添加了对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

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

v7 首选项库添加了对接口（如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 开发者指南。

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

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

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

v13 支持库

此库使用 (FragmentCompat) 类和其他片段支持类添加了对Fragment 用户界面模式的支持。有关片段的更多信息，请参阅Fragments 开发者指南。有关 v13 支持库 API 的详细信息，请参阅 API 参考中的android.support.v13 包。

注意：v4 片段库提供了一个Fragment 类。v4 Fragment 类是一个独立的类，它提供了在更高平台版本中添加的错误修复，而 v13 FragmentCompat 类为框架实现的Fragment 类提供了兼容性垫片。

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

com.android.support:support-v13:28.0.0

v14 首选项支持库

android.support.v14.preference 包提供 API 以支持添加首选项接口，例如PreferenceFragment.OnPreferenceStartFragmentCallback 和PreferenceFragment.OnPreferenceStartScreenCallback，以及类，例如MultiSelectListPreference 和PreferenceFragment。有关 v14 首选项支持库 API 的详细信息，请参阅 API 参考中的preference 包。

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

com.android.support:preference-v14:28.0.0

v17 用于电视的的首选项支持库

android.support.v17.preference 包提供 API 以在电视设备上提供首选项接口，包括对LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener 接口和类（如BaseLeanbackPreferenceFragment 和LeanbackPreferenceFragment）的支持。有关 v17 首选项支持库 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 以支持向您的应用程序添加材料设计组件和模式。

设计支持库为应用程序开发者添加了各种材料设计组件和模式的支持，例如导航抽屉、浮动操作按钮（FAB）、Snackbar 和选项卡。

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

com.android.support:design:28.0.0

自定义选项卡支持库

Custom Tabs 包提供 API 以支持在您的应用程序中添加和管理自定义选项卡。

自定义选项卡支持库添加了对各种类的支持，例如Custom Tabs Service 和Custom Tabs Callback。

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

com.android.support:customtabs:28.0.0

百分比支持库

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

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

Percent Support 库增加了对 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

适用于 TV 的应用推荐支持库

App Recommendation 包提供了 API，用于支持在您的应用（在 TV 设备上运行）中添加内容推荐。

App 库增加了对注释的支持，例如 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