注意:随着支持库 28.0.0 的发布,以 android.support
打包的库已废弃,取而代之的是采用 androidx
打包的各个版本的 Jetpack 库。Jetpack 库的初始 1.0.0 版本与支持库 28.0.0 保持一致,并提供了迁移到新的 androidx
封装的起点。
现有的 android.support
封装库将继续正常运行;不过,它们不会再收到 28.0.0 之后的任何更新,也不会与新的 Jetpack 库兼容。
以往的工件(这里指的是打包为 android.support
的 27 版及更早版本)在 Google Maven 中仍然可用。所有新工件都将打包为 androidx
,并且需要从 android.support
迁移到 androidx
。
我们建议在所有新项目中使用 androidx
库。您还应考虑迁移现有项目,以确保它们继续收到 bug 修复和其他库改进。
Android 支持库包含多个可以添加至应用的库软件包。其中每个库均支持一系列特定的 Android 平台版本和功能。
如需使用以下任一库,您必须将库文件下载到 Android SDK 安装位置中。请按照支持库设置中有关下载支持库的说明完成此步骤。您必须采取其他措施以在应用中包含特定的支持库。有关如何在应用中添加库的重要信息,请参阅下文各个库部分的结尾。
注意:所有支持库软件包的最低 SDK 版本至少采用 API 级别 14。部分软件包需要更高的 API 级别,如下文所述。
v4 支持库
与其他库相比,这些库包含的 API 集合最大,包括对应用组件、界面功能、无障碍功能、数据处理、网络连接以及编程实用工具的支持。
如需了解 v4 支持库提供的类和方法的完整详细信息,请参阅 API 参考文档中的 android.support.v4
软件包。
注意:在支持库修订版 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 库
实现各种与界面相关的组件,例如 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
类的框架实现提供了兼容性 shim。
此库的 Gradle 编译脚本依赖项标识符如下所示:
com.android.support:support-fragment:28.0.0
Multidex 支持库
此库通过多个 Dalvik 可执行文件 (DEX) 为构建应用提供支持。如果应用引用超过 65536 种方法,则必须使用多 dex 配置。如需详细了解如何使用多 dex,请参阅 以超过 64000 种方法编译应用。
此库的 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
- 添加了对话框类,此类可用作 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 支持库后,此库会增加对 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 支持库
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 Studio 和基于 Gradle 的 build 支持将 RenderScript 与支持库配合使用。renderscript 库位于 build-tools/$VERSION/renderscript/
文件夹中。
以下示例展示了此库的 Gradle 编译脚本属性:
defaultConfig { renderscriptTargetApi 18 renderscriptSupportModeEnabled true }
v13 支持库
此库通过 (FragmentCompat
) 类和其他 fragment 支持类增加了对 Fragment 界面模式的支持。如需详细了解 fragment,请参阅 Fragment 开发者指南。如需详细了解 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
软件包提供用于添加偏好设置接口支持的 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
- Fragment,可以创建用于浏览媒体项类别和行的主要布局。DetailsFragment
- 用于 Leanback 详情页面的封装容器 fragment。PlaybackOverlayFragment
- 用于显示播放控件和相关内容的DetailsFragment
的子类。SearchFragment
- 用于处理搜索的 fragment。该 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 支持库
Annotation 软件包提供用于支持向应用添加注解元数据的 API。
此库的 Gradle 编译脚本依赖项标识符如下所示:
com.android.support:support-annotations:28.0.0
Design 支持库
Design 软件包提供用于支持向应用添加 Material Design 组件和模式的 API。
Design 支持库增加了对各种 Material Design 组件和模式的支持,以便应用开发者在此基础上进行构建,例如抽屉式导航栏、悬浮操作按钮 (FAB)、信息提示控件和标签页。
此库的 Gradle 编译脚本依赖项标识符如下所示:
com.android.support:design:28.0.0
Custom Tabs 支持库
Custom Tabs 软件包提供用于支持在应用中添加和管理自定义标签页的 API。
Custom Tabs 支持库增加了对各种类的支持,例如自定义标签页服务和自定义标签页回调。
此软件包需要 API 级别 15 或更高级别。此库的 Gradle 编译脚本依赖项标识符如下所示:
com.android.support:customtabs:28.0.0
Percent 支持库
Percent 软件包提供用于支持在应用中添加和管理基于百分比的维度的 API。
注意:从 26.0.0 版本开始,Percent 支持库已被弃用。此模块的客户端应迁移到新的 ConstraintLayout
微件,此微件作为 SDK 管理器中的单独工件提供。
Percent 支持库增加了对 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
适用于电视的 App Recommendation 支持库
App Recommendation 软件包提供用于支持在电视设备上运行的应用中添加内容推荐的 API。
App 库增加了对注解(例如 ContentRecommendation.ContentMaturity)和各种类(例如 ContentRecommendation 和 RecommendationExtender)的支持。
此软件包需要 API 级别 21 或更高级别。此库的 Gradle 编译脚本依赖项标识符如下所示:
com.android.support:recommendation:28.0.0
Wear 界面库
此库包含用于为 Wear 应用构建界面的 API。这些 API 在 android.support.wear.widget 软件包中提供,可替代 Wearable 支持库中的相应 API。
如需了解详情,请参阅 使用 Wear 界面库。
此库的 Gradle 编译脚本依赖项标识符如下所示:
com.android.support:wear:28.0.0