支持库软件包

支持库软件包

原文链接：Support Library Packages | Android Developers

Android 支持库含有若干可导入到您的应用的软件包，它们各自支持一定特定范围内的 Android 平台版本和功能特性。

欲使用下列任意一个库，您必须下载库文件到您的 SDK 安装目录，按照支持库设置的指导进行操作即可。在这之后，您还必须将特定的支持库导入到您的应用中，导入每个库的具体方法请参阅相应段落的结尾。

注意：所有支持库软件包所支持的最低 SDK 版本至少是 API 版本 14，有些软件包要求的更高，下面会在注意事项中一一提及。

v4 支持（Support）库

下列各库相对于其他库而言包含了最多的 API，提供了对应用组件、UI 特性、无障碍、数据处理、网络连接和编程实用程序的支持。

欲获取 v4 支持库提供的类和方法的完整详细信息，请参阅 API 文档中的 android.support.v4 软件包。

注意：在支持库修订版本 24.2.0 之前，曾只有一个单独的 v4 支持库，该库后来被分割成若干模块来提升效率。如果您在 Gradle 脚本中列出了 support-v4，您生成的 APK 安装包将包含所有 v4 的模块以向后兼容。然而，我们仍然推荐您只列出您应用所需的特定模块，以便减小 APK 安装包的大小。

v4 compat 库

为若干 Android 框架 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 库

提供了媒体（Media）框架的向后移植，包括 MediaBrowser 和 MediaSession。

在 Gradle 构建脚本中添加对该库的依赖所需的识别符是：

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

v4 fragment 库

提供了 fragment 的 UI 和功能的封装，为应用提供能适应不同尺寸屏幕的布局。该模块依赖于兼容库、核心实用程序库、核心 UI 库和媒体兼容库。

注意：v13 支持库提供了一个 FragmentCompat 类。该 v4 Fragment 类是一个独立的类，提供了之后几个平台版本更新中添加的漏洞修复，而 v13 FragmentCompat 类为框架中的 Fragment 类提供了向后兼容的小型函数库（shim）实现。

在 Gradle 构建脚本中添加对该库的依赖所需的识别符是：

com.android.support:support-fragment:28.0.0

Multidex 支持库

提供了构建 Dalvik 可执行文件（DEX）分包的应用的支持。方法数超过 65,536 的应用要求使用 Dalvik 可执行文件分包的配置。欲了解更多使用 Multidex 的信息，请参阅配置方法数超过 64K 的应用。

在 Gradle 构建脚本中添加对该库的依赖所需的识别符是：

com.android.support:multidex:1.0.0

v7 支持（Support）库

下列各库分别提供了某些特性的集合，且能彼此独立地导入您的应用。

v7 appcompat 库

提供了对于应用操作栏（action bar）的 UI 设计样式，以及 Material Design 的 UI 实现的支持。

注意：该类库依赖于 v4 支持库

如下是 v7 兼容库所含的若干关键类：

ActionBar：提供了应用操作栏的 UI 样式。欲了解使用应用操作栏的更多信息，请参阅应用操作栏文档。
AppCompatActivity：添加了一个应用 activity 类，可充当使用了支持库应用操作栏的activity的基类。
AppCompatDialog：添加了一个对话框类，可充当使用了 AppCompat 主题的对话框的基类。
ShareActionProvider：添加了对于可用在应用操作栏的标准化的分享操作（例如邮件或发布到社交网络）的支持。

注意：v7 appcompat 库是 Android Jetpack 的地基组件（foundation component）之一。请参阅 Sunflower 示例应用。

在 Gradle 构建脚本中添加对该库的依赖所需的识别符是：

com.android.support:appcompat-v7:28.0.0

v7 cardview 库

提供了对于 CardView 部件的支持，从而让您在不同的应用上都能用外观一致的卡片来展示信息。这些卡片在 Material Design 的实现中很重要，并且还广泛用于 TV 应用中的布局。

在 Gradle 构建脚本中添加对该库的依赖所需的识别符是：

com.android.support:cardview-v7:28.0.0

v7 gridlayout 库

当您下载了 Android 支持库后，v7 gridlayout 库提供了 GridLayout 的支持，它允许您用矩形单元格组成的表格来安排 UI 元素。欲了解详细内容，请参阅 API 文档中的 android.support.v7.widget 包。

在 Gradle 构建脚本中添加对该库的依赖所需的识别符是：

com.android.support:gridlayout-v7:28.0.0

v7 mediarouter 库

该库提供了对于 MediaRouter、MediaRouteProvider 及其相关的兼容 Google Cast 的媒体类的支持。

总体而言，v7 mediarouter 库的 API 提供了一种控制媒体频道的路由和从当前设备串流到外部屏幕、音响和其他目标设备的途径，包括：发布与当前应用相关的媒体路由提供者、发现并选择目标设备、检查媒体状态，等等。欲了解详细内容，请参阅 API 文档中的 android.support.v7.media 包。

在 Gradle 构建脚本中添加对该库的依赖所需的识别符是：

com.android.support:mediarouter-v7:28.0.0

修订版本18的支持库里引入的 v7 mediarouter 库 API 有可能会在更新的版本里改动。当前，我们建议您仅在连接 Google Cast 时使用该库。

v7 palette 库

提供了对于 Palette 的支持，它允许您从图像中提取关键颜色。例如，一个音乐应用可以使用一个 Palette 对象来从专辑封面中提取主题色，并使用它们来构建颜色相称的歌曲标题卡片。

在 Gradle 构建脚本中添加对该库的依赖所需的识别符是：

com.android.support:palette-v7:28.0.0

v7 recyclerview 库

添加了 RecyclerView 类，它提供了对 RecyclerView 部件的支持。该类通过一个包含了有限数量元素的窗口，能够高效地展示庞大的数据集合。

在 Gradle 构建脚本中添加对该库的依赖所需的识别符是：

com.android.support:recyclerview-v7:28.0.0

v7 Preference 支持库

preference 包提供了对于添加 UI 设置的偏好设定对象（例如 CheckBoxPreference 和 ListPreference）、接口 Preference.OnPreferenceChangeListener 和 Preference.OnPreferenceClickListener 的支持。

在 Gradle 构建脚本中添加对该库的依赖所需的识别符是：

com.android.support:preference-v7:28.0.0

v8 支持（Support）库

提供了特定特性的集合，可在您的应用中独立使用。

v8 renderscript 库

提供了 RenderScript 计算框架的支持，这些 API 被收入了 android.support.v8.renderscript 包。您应当了解到，将这些 API 导入应用的步骤和导入其他支持库 API 的差异很大。欲了解详细内容，请参阅 API 文档中的RenderScript。

注意：Android Studio 和基于 Gradle 的构建提供了对于与支持库一起使用 RenderScript 的支持。RenderScript 库位于 build-tools/$VERSION/renderscript/ 文件夹。

如下的例子展示了该库的 Gradle 构建脚本属性：

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

v13 支持（Support）库

通过 FragmentCompat 和额外的 fragment 支持类，提供了对于 Fragment UI 样式的支持。欲了解 fragment 的详细内容，请参阅 API 文档中的 Fragments。欲了解 v13 支持库的 API，请参阅 API 文档中的 android.support.v13 包。

注意： v4 fragment 库 提供了一个 Fragment 类，该 v4 Fragment 类是一个独立的类，用于提供较新版本中加入的漏洞修复。而 v13 FragmentCompat 则是为 [Fragment] 类的框架实现提供了兼容性垫片（shim）。

在 Gradle 构建脚本中添加对该库的依赖所需的识别符是：

com.android.support:support-v13:28.0.0

v14 Preference 支持库

android.support.v14.preference 包加入了诸如 PreferenceFragment.OnPreferenceStartFragmentCallback 和PreferenceFragment.OnPreferenceStartScreenCallback 等用于提供偏好设置接口的 API，以及 MultiSelectListPreference 和 PreferenceFragment 等类。欲了解 v14 Preference 支持库 API 的详细内容，请参阅 API 文档中的 preference 包。

在 Gradle 构建脚本中添加对该库的依赖所需的识别符是：

com.android.support:preference-v14:28.0.0

针对 TV 的 v17 Preference 支持库

android.support.v17.preference 包加入了诸如 LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener 等为 TV 设备提供偏好设置接口的 API，以及 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 包提供了支持在 TV 设备上构建 UI 的API，和一系列对于 TV 应用极为重要的部件。如下是其中最著名的若干类：

BrowseFragment：一个fragment，用于创建浏览媒体类别和条目的主界面。
DetailsFragment：一个 fragment 的包装类，用于 Leanback 详细内容的界面。
PlaybackOverlayFragment：一个 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 支持库

提供了为您的应用添加 Material Design 组件和样式的 API，例如：抽屉式导航栏（navigation drawers）、浮动操作按钮（floating action buttons，FAB）、Snackbar 和标签页（Tab）。

在 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，例如：PercentLayoutHelper.PercentLayoutParams 接口，以及 PercentFrameLayout PercentRelativeLayout 等类。

注意：该库已不建议使用在 26.0.0 及更新版本中使用。使用该模块的应用应当迁移至新的 ConstraintLayout 部件，该部件由 SDK 管理器单独提供。

在 Gradle 构建脚本中添加对该库的依赖所需的识别符是：

com.android.support:percent:28.0.0

ExifInterface 支持库

在 JPEG 或 RAW 格式的图片文件中，Exif 标签直接存储了诸如屏幕方向、日期和时间、相机信息和地理坐标等信息。ExifInterface 类提供了解耦的从 JPEG 和 raw（DNG, CR2, NEF, NRW, ARW, RW2, ORF, PEF, SRW and RAF）格式文件中解析 Exif 信息、以及在 JPEG 图像文件中设置 Exif 的功能支持。

在 Gradle 构建脚本中添加对该库的依赖所需的识别符是：

com.android.support:exifinterface:28.0.0

针对 TV 的 App Recommendation 支持库

App Recommendation 包提供了为您的 TV 应用添加内容推荐的 API，例如：ContentRecommendation.ContentMaturity 等注释，以及 ContentRecommendation 和 RecommendationExtender 等类。

该库要求 API 级别 15 或更高的版本。在 Gradle 构建脚本中添加对该库的依赖所需的识别符是：

com.android.support:recommendation:28.0.0

可穿戴设备 UI 库

提供了为可穿戴设备构建 UI 的 API，这些 API 可在 android.support.wear.widget 包中获得，用来替代 Wearable 支持库中的相应版本。

欲了解更多内容，请参阅使用可穿戴 UI 库。

在 Gradle 构建脚本中添加对该库的依赖所需的识别符是：

com.android.support:wear:28.0.0