支持库功能指南

注意:随着 Android 9.0 (API 级别 28) 的发布,支持库的新的版本被称为 AndroidX,它是 Jetpack 的一部分。AndroidX 库包含现有的支持库,还包括最新的 Jetpack 组件。

您可以继续使用支持库。历史工件(版本 27 及更早版本,并打包为 android.support.*)将在 Google Maven 上继续提供。但是,所有新的库开发将在 AndroidX 库中进行。

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

支持库提供各种用于构建应用程序的类,从基本应用程序组件到用户界面小部件,再到媒体处理,再到电视应用程序组件。许多类是向后兼容的实现,但其中一些是它们本身的新功能。

本文档概述了支持库中可用的重要功能类别,以及构建应用程序时应了解的特定类。

有关如何将支持库代码添加到应用程序开发项目的信息,请参阅 支持库设置。有关如何在项目中包含特定支持库包的信息,请参阅 支持库包

应用程序组件

这些支持库类提供重要的核心平台功能的向后兼容实现。这些实现通常扩展较早版本的类以处理在平台的更新版本中添加的新方法和功能。其中一些类是框架 API 的完整静态实现。

用户界面

这些支持库类提供关键用户界面小部件和行为的实现,并帮助您在早期设备上创建更现代的应用程序界面。其中一些小部件只能通过支持库获得。

通用布局容器

这些支持类提供可以适应不同设计用例的用户界面容器。

  • RecyclerView - 创建用于显示长列表的布局,使用策略来避免高内存消耗。此类允许您创建对较大数据集的有限窗口视图,从而在显示列表时避免消耗大量内存。有关使用 RecyclerView 的更多信息,请参阅 Recycler View 指南。
  • ViewPager - 提供允许用户在数据页之间左右翻页的布局。
  • GridLayout - 提供一个布局,其子项位于矩形网格中,支持任意跨越连续单元格和灵活的空间分配。此类提供 GridLayout 类的向后兼容版本,该版本在 Android 4.0 (API 级别 14) 中引入。
  • PercentFrameLayoutPercentRelativeLayout - 提供支持基于百分比的尺寸和边距的布局,适用于其子视图和内容。

注意:ViewPagerRecyclerViewPercentFrameLayoutPercentRelativeLayout 类仅在支持库中可用。

专用布局容器

这些支持类提供了特定布局模式的兼容实现,例如可以从屏幕边缘拉出的抽屉视图、滑动面板以及列表中的嵌套列表。

  • DrawerLayout - 创建一个布局,允许交互式 抽屉视图 从视图窗口的边缘拉出。
  • SlidingPaneLayout - 为在应用程序用户界面的顶层使用提供水平多窗格布局,用于创建可以在多种屏幕尺寸上平滑适应的布局,在较大屏幕上扩展并在较小屏幕上折叠以适应。
  • NestedScrollView - 一个滚动布局,支持嵌套其他滚动视图,允许您创建列表,其中项目包含一个额外的子列表。这些嵌套列表可以包含水平或垂直滚动的项目,与父列表分开。
  • SwipeRefreshLayout - 提供一个布局来支持通过手指滑动手势刷新列表或其他布局中的数据。

视图、对话框和小部件

支持库提供了一些类,用于在布局中显示内容和提供用户交互元素。

  • CardView - 用于创建 Material Design 风格的显示卡的支持库自定义类。此类基于具有圆角和阴影的 FrameLayout。
  • AppCompatDialogFragment - 通过扩展 DialogFragment 并使用 AppCompatDialog,提供一致风格的对话框。
  • NotificationCompat - 为以向后兼容的方式提供较新的通知样式提供支持。
  • SearchView - 提供一个类,供用户输入搜索查询并向搜索提供者提交请求,主要用于应用程序栏中。

Material Design

支持库提供了一些类,用于实现 Material Design 用户界面推荐。

  • CoordinatorLayout - 为包含 Material Design 组件和行为的布局提供顶级容器。此类也可以用作与一个或多个子视图进行特定交互的容器。
  • AppBarLayout - 提供 Material Design 的 应用程序栏概念 中许多滚动功能的实现。
  • FloatingActionButton - 创建浮动按钮,用于显示特殊类型的推广操作。此 Material Design 用户界面元素显示为悬浮在应用程序用户界面上方的圆形图标。有关更多信息,请参阅 添加浮动操作按钮
  • DrawerLayout - 创建导航抽屉——一个显示应用程序主导航菜单的 UI 面板。当用户从屏幕左侧边缘滑动手指或点击应用程序栏中的抽屉图标时,它将出现。有关更多信息,请参阅 创建导航抽屉
  • TabLayout - 提供一个布局用于显示选项卡页。此小部件设计用于与 ViewPager 类一起使用。
  • Snackbar - 提供一个小部件,用于使用 snackbar 弹出窗口 显示有关操作的轻量级反馈。

图形

android.support.graphics.drawable 包提供了对 矢量可绘制对象 的支持。通过使用矢量可绘制对象,您可以将多个 PNG 资源替换为单个矢量图形,该图形在 XML 中定义。

VectorDrawableCompat 为 API 级别 9 及更高版本提供对矢量可绘制对象的支持。 AnimatedVectorDrawableCompat 为 API 级别 11 及更高版本提供对动画矢量可绘制对象的支持。

无障碍功能

android.support.v4.view.accessibility 包提供了用于实现 API 级别 14 及更高版本中引入的无障碍功能的兼容类,这些功能允许无障碍服务观察和识别用户与屏幕上显示的项目的交互。

媒体播放

Android 支持库提供了 媒体路由器 功能的向后移植,用于运行早于 Android 4.1(API 级别 16)的平台版本的设备。这些类允许跨连接的 Android 设备控制媒体播放。

  • MediaRouter - 使应用程序能够控制媒体通道和流从当前设备到外部扬声器和目标设备的路由。
  • MediaControllerCompat - 允许应用程序与正在进行的媒体会话进行交互。应用程序可以通过此机制提供媒体控制按钮并向会话发送其他播放命令。
  • MediaSessionCompat - 为媒体播放提供远程控制接口,使其他应用程序或独立设备上的媒体控制器、音量键、媒体按钮和传输控制能够进行交互。

电视应用程序

Android SDK 提供了库来支持大屏幕等外形尺寸及其相关控制器。应用程序可以依赖于适当的支持库以在广泛的平台版本中提供功能,并可以在外部屏幕、扬声器和其他目标设备上提供内容。

可穿戴应用程序

Android SDK 提供了库来支持手表。这些库为应用程序提供了功能,这些功能在用户佩戴手表时可供用户使用。

实用程序

Android 支持库提供了一些框架中未内置的功能。这些库提供了一系列应用程序可以使用的实用程序。