Support Library 修订版存档

此页面提供有关较旧 Support Library 包版本的详细信息。有关最新的 Support Library 版本，请参阅 最新的 Support Library 修订版。

修订版 26.0.0 Beta 2

(2017 年 6 月)

请注意，26.0.0-beta2 是预发布版本。其 API 表面可能会发生变化，并且不一定包含 Support Library 最新稳定版本的特性或错误修复。

重要提示：Support 库现在可通过 Google 的 Maven 存储库获得。您无需从 SDK 管理器下载 Support 存储库。有关更多信息，请参阅 Support 库设置。

新 API

API 差异

错误修复

  • Android O SDK 版本导致 TextView 中的斜体丢失
  • 连接到 MediaBrowserServiceCompat 时出现空指针异常
  • TextInputLayout 必须在 onProvideAutofillStructure() 上设置提示
  • 在 O 上使用 TextView 自动调整大小时出现堆栈溢出

修订版 26.0.0 Beta 1

(2017 年 5 月)

请注意，26.0.0-beta1 是预发布版本。其 API 表面可能会发生变化，并且不一定包含 Support Library 最新稳定版本的特性或错误修复。

重要提示：Support 库现在可通过 Google 的 Maven 存储库获得。您无需从 SDK 管理器下载 Support 存储库。有关更多信息，请参阅 Support 库设置。

重要更改

  • FragmentActivity.setSupportMediaController() 和 FragmentActivity.getSupportMediaController() 已被移除。请使用新的静态 MediaControllerCompat.setMediaController() 和 MediaControllerCompat.getMediaController() 方法。
  • BottomNavigationView 现在在选择已选项目时调用 onNavigationItemReselected()，而不是调用 onNavigationItemSelected()。
  • findViewById() 方法的所有实例现在返回 <T extends View> T 而不是 View。此更改具有以下影响
    • 这可能导致现有代码现在具有不明确的返回类型，例如，如果同时存在 someMethod(View) 和 someMethod(TextView) 来获取对 findViewById() 的调用的结果。
    • 在使用 Java 8 源语言时，当返回类型不受约束时（例如，assertNotNull(findViewById(...)).someViewMethod())），需要显式转换为 View。
    • 非最终 findViewById() 方法（例如，Activity.findViewById()）的覆盖需要更新其返回类型。

新 API

  • FragmentManager 和 Fragment 有一个 isStateSaved() 方法，允许查询事务是否允许在没有状态丢失的情况下执行。这在处理 onClick() 事件并在执行任何事务之前进行检查时尤其有用。
  • AnimatedVectorDrawableCompat 中支持路径运动。路径运动允许一个对象动画师根据一条路径同时更改两个属性；路径在动画师的 XML 中指定为 android:pathData。
  • 基于物理的动画:
    • 新的 FlingAnimation 支持使用初始速度进行动画并平滑减速。
    • DynamicAnimation 的子类支持为任何对象设置自定义属性动画。
    • SpringAnimation 和 FlingAnimation 现在都可以对浮点值进行动画，而无需将 View 或 Object 与其关联。

    有关更多信息，请参阅 弹簧动画 和 抛掷动画 预览页面。

  • XML 中的字体支持:
    • ResourcesCompat.getFont 允许加载字体资源（包括字体系列 XML），这些资源可与 TextView.setTypeface() 一起使用。
    • 在使用 AppCompat 时，TextView 支持通过 android:fontFamily XML 属性指定字体资源或字体系列 XML。
    • 使用 XML 字体系列创建具有样式和粗细变化的字体系列。（如果您使用 Support 库类执行此操作，请使用 app: 属性以及 android: 属性。）
  • 可下载字体
    • 新的 FontsContractCompat 允许您从字体提供程序请求字体，而不是将它们捆绑在您的应用中。
    • 字体也可以在 XML 中请求并在布局中使用。
  • 表情符号兼容库:
    • EmojiCompat 可以处理给定的 CharSequence 并添加 EmojiSpans。
    • EmojiTextView 和其他部件以显示表情符号。
    • FontRequestEmojiCompatConfig 用于从字体提供程序请求表情符号字体。
  • 自动调整大小的 TextView:
    • TextViewCompat 中的新方法以及 XML 属性用于控制 TextView 中的自动调整大小。
  • 支持搜索的 Leanback 播放控件

    • 新增了一个 PlaybackTransportRowPresenter，用于使用 SeekBar 渲染播放控件。
    • 新增了一个 PlaybackTransportControlGlue，它与 PlaybackTransportRowPresenter 协同工作并支持跳转。
    • 新增了一个基类 PlaybackSeekDataProvider，供应用向 PlaybackTransportControlGlue 提供跳转缩略图。
  • 首选项数据存储
    • PreferenceDataStore 现在允许您实现自己的首选项存储，并通过 Preference 和 PreferenceManager 中的新方法进行设置。

已知问题

  • 可下载字体和 Emoji 与 Google Play 服务的集成仅适用于 Google Play 服务 v11 及更高版本，目前可以通过 Google Play 服务测试版计划 获取。

错误修复

  • MediaBrowserCompat.search() API 不起作用（AOSP 问题 262170）
  • ViewCompat.postInvalidateOnAnimation() 抛出异常（AOSP 问题 80146）
  • 已销毁的 Activity 中的片段会调用 onActivityCreated()
  • RecyclerView.isComputingLayout() 应该在预取期间返回 true
  • 当 Fade 过渡被中断并反转时，View 会从头开始动画。（从 Android 框架移植的修复程序。）
  • Transition.Fade 忽略 View 的初始 alpha 值（AOSP 问题 221820）

版本 26.0.0 Alpha 1

（2017 年 3 月）

请注意，26.0.0-alpha1 是预发布版本。其 API 表面可能会发生变化，并且不一定包含 Support Library 最新稳定版本中的功能或错误修复。

重要更改

注意：最小 SDK 版本已提高到 14。因此，许多仅为 API < 14 兼容性而存在的 API 已弃用。这些 API 的客户端应迁移到其框架等效项，如每个弃用 API 的参考页面中所述。

  • support-percent 模块已弃用。此模块的客户端应迁移到新的 ConstraintLayout 小部件，该小部件作为 SDK 管理器中的单独工件提供。
  • support-fragment 模块不再依赖于 support-media-compat 模块。

新 API

添加了许多新类、方法和常量，以提供对 O 预览版中添加的平台 API 的向后兼容支持。

  • IME_FLAG_NO_PERSONALIZED_LEARNING：IME 可以侦听具有私有模式（例如浏览器）的应用的“无学习”标志。此功能可帮助 IME 了解应用是否处于私有模式，以便在应用处于该模式时禁用其学习或自适应功能。

有关 25.2.0 和 26.0.0-alpha1 之间 API 更改的完整列表，请参阅 支持库 API 差异报告。

错误修复

  • 在某些情况下，简单的 AutoTransition 动画可能会因视图“跳跃”而中断。（AOSP 问题 221816）

版本 25.4.0

(2017 年 6 月)

重要提示：Support 库现在可通过 Google 的 Maven 存储库获得。您无需从 SDK 管理器下载 Support 存储库。有关更多信息，请参阅 Support 库设置。

重要更改

  • executePendingTransactions()、commitNow()、popBackStackImmediate() 和类似的事务调用在 FragmentManager 状态更改期间不允许使用。事务的重入执行是不安全的，FragmentManager 现在在其状态更改期间强制执行此操作。
  • 与本次支持库版本同时发布的还有 multidex 版本 1.0.2。此版本包含以下重要更改
    • 允许对 Instrumentation APK 进行多 dex 处理。
    • 弃用 MultiDexTestRunner（应改用 AndroidJUnitRunner）。
    • 提供更好的保护，防止应用出现一些错误的归档文件提取管理。
    • 修复了一个可能导致临时文件被遗弃的错误。
    • 在并发进程中完成时提供更快的安装速度。
    • 修复了 API 19 和 20 上的安装错误。

新增和修改的 API

AnimatedVectorDrawableCompat 支持路径变形和路径插值。路径变形允许形状从一个路径（指定为 android:valueFrom）更改为另一个路径（指定为 android:valueTo），以便提供复杂且吸引人的视觉效果。路径插值允许将 AnimatedVectorDrawableCompat 的插值器指定为路径（在插值器的 XML 中指定为 android:pathData）。

API 差异

已修复的问题

  • 连接到 MediaBrowserServiceCompat 时出现空指针异常
  • MediaBrowserCompat.search() API 不起作用（AOSP 问题 262170）
  • 25.3.0 中 BrowseFragment 的 onItemClicked 回调已损坏
  • 25.3.1 中在 VerticalGridView 中上下滚动时出现 NullPointerException
  • SimpleArrayMap.allocArrays() 中出现 ClassCastException

版本 25.3.1

（2017 年 3 月）

已修复的问题

版本 25.3.0

（2017 年 3 月）

重要更改

从 Gradle 构建时，Support Library 版本元数据将自动添加到 AndroidManifest.xml 中，这简化了在公共版本中跟踪版本的流程。例如

<meta-data android:name="android.support.VERSION" android:value="25.3.0" />

弃用

此版本中已弃用许多方法和类。这些弃用的 API 将在未来版本中删除，开发人员应迁移到其他 API。有关如何从特定 API 迁移的更多信息，请参阅其文档。

ExifInterface
布尔方法 getLatLong(float[]) 已弃用。请改用新方法 getLatLong()，该方法不带参数并返回 double[]。
mediacompat
PlaybackStateCompat.Builder.setErrorMessage(CharSequence) 已弃用。请改用新方法 setErrorMessage(int, CharSequence)，该方法传递错误代码和可选说明。
EXTRA_SUGGESTION_KEYWORDS 已弃用。请改用 MediaBrowserCompat 搜索功能。
v7.recyclerview
LinearLayoutManager.getInitialItemPrefetchCount() 已重命名为 LinearLayoutManager.getInitialPrefetchItemCount()。旧名称仍然受支持，但将在未来版本中删除。

新增和修改的 API

appcompat-v7
新方法 ActionBarDrawerToggle.setDrawerSlideAnimationEnabled(boolean) 简化了禁用导航抽屉切换图标动画的操作。
customtabs
添加了对消息通道的支持。有关详细信息，请参阅 CustomTabsService.requestPostMessageChannel() 和 CustomTabsService.postMessage() 参考。
dynamic-animation
新的基于物理的动画库，提供一组用于构建动态响应用户输入的动画的 API。
leanback-v17
添加了对视差背景的支持。有关详细信息，请参阅 Parallax 参考。
添加了 TimePicker 小部件，用于在电视界面上选择时间。
mediacompat
添加了搜索功能。有关详细信息，请参阅 MediaBrowserCompat.search() 和 MediaBrowserServiceCompat.onSearch() 参考。
添加了对随机播放和重复模式的支持。有关详细信息，请参阅 MediaSessionCompat.setRepeatMode() 和 setShuffleModeEnabled() 参考。

已修复的问题

版本 25.2.0

（2017 年 2 月）

重要更改

已修复的问题

  • 此版本修复了 mediarouter 中的一个严重问题，该问题会导致使用 A2DP 设备和媒体路由 API 时设备无响应，需要重新启动。
  • FragmentManager.FragmentLifecycleCallbacks 类现在是静态的。

已修复的问题

  • 使用屏幕镜像显示幻灯片会导致设备断开与 Wi-Fi 的连接
  • 媒体按钮未正确处理未向 setMediaButtonReceiver() 注册自己的媒体应用
  • VectorDrawable 字符串资源错误（AOSP 问题 232407）
  • TextInputLayout 如果文本由 XML 设置，则会覆盖提示和文本（AOSP 问题 230171）
  • MediaControllerCompat 中存在内存泄漏（AOSP 问题 231441）
  • RecyclerViewLayoutTest.triggerFocusSearchInOnRecycledCallback() 崩溃
  • RecyclerView 在回收视图持有者时崩溃（AOSP 问题 225762）
  • getAllowGeneratedReplies() 对 WearableExtender 内部的操作错误地返回 false

版本 25.1.1

（2017 年 1 月）

重要提示：Support Library 版本 25.1.1 和 25.1.0 中的 android.support.v7.media.MediaRouter 类存在已知错误。如果您的应用使用 v7 MediaRouter，则应更新到 Support Library 版本 25.2.0，该版本修复了此错误。

重要更改

  • 现在可以在片段事务内部和跨事务进行优化。优化片段事务操作可以消除相互抵消的操作。例如，假设同时执行两个事务，一个事务添加片段 A，第二个事务用片段 B 替换片段 A。在这种情况下，第一个操作可能会被取消，并且只添加片段 B。这意味着片段 A 可能不会经历创建/销毁生命周期。

    此优化的副作用是片段的状态更改可能超出预期顺序。例如，假设一个事务添加片段 A，第二个事务添加片段 B，然后第三个事务删除片段 A。在没有优化的情况下，片段 B 可以预期在它被创建时，片段 A 也将存在，因为片段 A 将在片段 B 添加后被删除。通过优化，片段 B 无法确定在 B 创建时片段 A 是否存在，因为片段 A 的创建和销毁可能会被优化移除。

    此优化默认情况下处于禁用状态。要启用优化，请调用 FragmentTransaction.setAllowOptimization(true)。

  • 片段现在可以使用 Fragment.postponeEnterTransition() 和 Fragment.startPostponedEnterTransition() 将其过渡和动画推迟到准备好为止。此 API 类似于与 Activity 过渡一起使用的 Activity.postponeEnterTransition() 和 Activity.startPostponedEnterTransition()。

已修复的问题

修订版 25.1.0

（2016 年 12 月）

重要提示：Support Library 版本 25.1.1 和 25.1.0 中的 android.support.v7.media.MediaRouter 类存在已知错误。如果您的应用使用 v7 MediaRouter，则应更新到 Support Library 版本 25.2.0，该版本修复了此错误。

重要更改

  • 嵌套 RecyclerView 小部件（例如，垂直滚动水平滚动列表的列表）的客户端可以通过提示内部 RecyclerView 小部件的布局管理器在屏幕上滚动之前准备多少项来获得显著的性能提升。调用 LinearLayoutManager.setInitialPrefetchItemCount(N)，其中 N 是每个内部项目可见的视图数。例如，如果您的内部水平列表每次至少显示三个半项目视图，则可以通过调用 LinearLayoutManager.setInitialPrefetchItemCount(4) 来提高性能。这样做允许 RecyclerView 尽早创建所有相关视图，而外部 RecyclerView 正在滚动，这大大减少了滚动期间的卡顿量。
  • FragmentActivity.setSupportMediaController() 和 FragmentActivity.getSupportMediaController() 已弃用。请使用新的静态 MediaControllerCompat.setMediaController() 和 MediaControllerCompat.getMediaController() 方法。
  • 当客户端通过 appcompat 着色指定小部件着色（例如，appcompat:buttonTint）时，客户端负责提供所有必要的状态（例如，“禁用”、“按下”等）。这与使用框架着色时指定小部件着色的方式一致。

新增和修改的 API

已修复的问题

可以在AOSP问题跟踪器上找到完整的公共错误修复列表。

弃用

此版本中已弃用许多方法和类。这些弃用的 API 将在未来版本中删除，开发人员应迁移到其他 API。有关如何从特定 API 迁移的更多信息，请参阅其文档。

版本 25.0.1

(2016年11月)

已修复的问题

可以在AOSP问题跟踪器上找到完整的公共错误修复列表。

版本 25.0.0

(2016年10月)

重要更改

  • ContextCompat构造函数已变为受保护的。此类不应公开实例化，但支持库可以针对较新的API级别进行扩展。
  • ActivityCompat构造函数已变为受保护的。此类不应公开实例化，但支持库可以针对较新的API级别进行扩展。
  • getReferrer(Activity)已变为静态方法。
  • android.support.design.widget.CoordinatorLayout.Behavior.isDirty(CoordinatorLayout, V)已被移除。应移除此方法的任何客户端实现。
  • android.support.v4.media.session.MediaSessionCompat.obtain(Context, Object)已被移除。用法应替换为更合适的名称方法 fromMediaSession()。
  • android.support.v4.media.session.MediaSessionCompat.QueueItem.obtain(Object)已被移除。用法应替换为更合适的名称方法 MediaSessionCompat.QueueItem#fromQueueItem。
  • android.support.v7.widget.Space已被移除。用法应替换为android.support.v4.widget.Space。

新 API

  • android.support.design.widget.BottomNavigationView类实现了Material Design规范中的底部导航模式。
  • 新的 android.support.v13.view.inputmethod包包含用于访问API级别13之后引入的android.view.inputmethod.InputConnection功能的类。
  • android.v7.widget.RecyclerView.DividerItemDecoration类为项目之间的垂直或水平分隔线提供基本实现。
  • 在android.support.v7.app.NotificationCompat、DecoratedCustomViewStyle和DecoratedMediaCustomViewStyle中新增的装饰样式，镜像了平台API 24中添加的类。

已修复的问题

可以在AOSP问题跟踪器上找到完整的公共错误修复列表。

版本 24.2.1

2016年9月

已修复的问题

可以在AOSP问题跟踪器上找到完整的公共错误修复列表。

版本 24.2.0

2016年8月

24.2.0版本包含以下更改

注意：24.2.0版本删除了对Android 2.2（API级别8）及以下版本的支持。仅用于这些系统版本的类和方法现在被标记为已弃用，不应再使用。这些已弃用的类和方法可能会在将来的版本中移除。

v4支持库拆分

在此版本中，v4支持库已拆分为几个较小的模块

support-compat
提供新框架API的兼容包装器，例如Context.getDrawable()和View.performAccessibilityAction()。
support-core-utils
提供许多实用程序类，例如AsyncTaskLoader和PermissionChecker。
support-core-ui
实现各种与UI相关的组件，例如ViewPager、NestedScrollView和ExploreByTouchHelper。
support-media-compat
移植media框架的部分内容，包括MediaBrowser和MediaSession。
support-fragment
移植fragment框架。此模块依赖于support-compat、support-core-utils、support-core-ui和support-media-compat。

为了向后兼容，如果您在Gradle脚本中列出了support-v4，您的APK将包含所有这些模块。但是，为了减小APK大小，我们建议您只列出应用程序所需的特定模块。

API更新

行为更改

  • 如果您使用 appcompat 库的昼夜功能，则系统现在会在昼夜模式更改时（无论是由于时间变化还是由于调用 AppCompatDelegate.setLocalNightMode()）自动重新创建您的活动。
  • Snackbar 现在如果状态栏是半透明的，则会在导航栏后面绘制。

MediaRouter 库

蓝牙设备不再被列为媒体路由。现在仅在 Android 系统级别控制音频到蓝牙设备的路由。

弃用

已弃用的类和方法可能会在将来的版本中删除。您应尽快迁移到这些 API 之外。

  • 以下几个类上的方法仅适用于 API 8 及更低版本，并且不应再使用。而是使用框架实现。
    • android.support.v4.view.KeyEventCompat：替换为 KeyEvent
    • android.support.v4.view.MotionEventCompat：使用 MotionEvent
    • android.support.v4.view.ViewCompat：使用 View
    • android.support.v4.view.ViewConfigurationCompat：使用 ViewConfiguration
  • AccessibilityServiceInfoCompat.getDescription() 已弃用，取而代之的是 AccessibilityServiceInfoCompat.loadDescription()，它返回正确本地化的描述。
  • 您不应直接实例化 ActivityCompat 类。非静态 getReferrer(Activity) 方法将在即将发布的版本中变为静态。
  • CoordinatorLayout.Behavior.isDirty() 已弃用，不再由 CoordinatorLayout 调用。应删除任何实现以及对此方法的任何调用。
  • MediaSessionCompat.obtain() 已弃用，并替换为名称更合适的 fromMediaSession() 方法。
  • MediaSessionCompat.QueueItem.obtain() 已弃用，并替换为名称更合适的 fromQueueItem() 方法。
  • 一些抽象类已被弃用，并替换为更贴近其框架等效项的接口。
  • CustomTabsSession.setToolbarItem() 已弃用，并替换为基于 RemoteViews 的 setSecondaryToolbarViews()。

错误修复

以下已知问题已在 24.2.0 版中修复

  • 确保在第一次测量传递之前调用 setRefreshing(true) 时显示 SwipeRefreshLayout 指示器（AOSP 问题 77712）
  • 防止在更改页面时 TabLayout 闪烁（AOSP 问题 180454）
  • 在 API 级别 11 及更低版本上解组 SavedState 时避免 ClassNotFoundException（AOSP 问题 196430）

可以在 AOSP 问题跟踪器 上找到完整的公共错误修复列表。

修订版 24.1.1

2016 年 7 月

已修复的问题

  • 修复了 24.1.0 版中影响支持库之间共享的资源 ID 的问题。此问题导致依赖于具有资源（例如设计和 appcompat）的支持库的应用程序遇到由资源 ID 不匹配导致的问题。

修订版 24.1.0

2016 年 7 月

针对 v4 支持库 的更改

已修复的问题

修订版 24.0.0

2016 年 6 月

针对 v4 支持库 的更改
  • 添加了 Fragment.commitNow() 以进行同步提交
  • 添加了 NotificationCompat.MessagingStyle 用于多方对话
  • 添加了 NotificationManagerCompat.areNotificationsEnabled() 和 getImportance()

  • MediaSessionCompat 现在镜像了 MediaSession 的功能，并且不再自动调用 setMediaButtonReceiver()

注意： 仅 MediaBrowserServiceCompat 24.0.0 版本与 API 24 及更高版本的 Android 未来版本向前兼容。如果您使用的是早期版本，请更新到此版本以确保兼容性。

针对 v7 appcompat 库 的更改
针对 设计支持库 的更改
针对 v17 Leanback 库 的更改
  • 添加了 OnboardingFragment 以提供首次运行的欢迎和设置流程
针对 自定义标签 的更改
  • 添加了为辅助工具栏提供 RemoteViews 层次结构的支持
  • 添加了 CustomTabsClient.connectAndInitialize() 用于一键预热

版本 23.4.0

2016 年 5 月

针对 v4 支持库 的更改
  • 修复了片段以错误顺序添加的问题。（问题 206901）
  • 修复了滚动出屏幕后应用栏未绘制的问题。（问题 178037）
针对 v7 appcompat 库 的更改
针对 设计支持库 的更改
针对矢量可绘制对象库

版本 23.3.0

2016 年 4 月

针对 v4 支持库 的更改
  • 添加了 AppLaunchChecker 以帮助跟踪用户过去如何启动您的应用。hasStartedFromLauncher() 可让您知道用户之前是否从主屏幕启动过您的应用，或者它是否仅通过其他方式（例如，查看特定网页 URL）启动。
  • 修复了 MediaBrowserServiceCompat.mConnections 中的内存泄漏。（问题 205220）
  • 修复了 ViewPager 翻页时未考虑页面边距的问题。（问题 203816）
  • Fragment.onRequestPermissionsResult() 现在传递给子片段。
针对 v7 appcompat 库 的更改
针对 v7 mediarouter 库 的更改
针对 v7 首选项 库的更改
针对 v7 recyclerview 库 的更改
针对 设计支持库 的更改

版本 23.2.1

2016 年 3 月

针对 v4 支持库 的更改
针对 v7 appcompat 库 的更改
  • 恢复了对矢量资源的依赖，以便使用 appcompat 库 的开发者无需强制使用 VectorDrawable 及其关联的构建标志。
  • 修复了夜间模式与 API 级别 23 的兼容性问题。（问题 201910）
  • 修复了 SwitchCompat 与 API 级别 7 的兼容性问题。（问题 201942）
  • 修复了在 Resources 对象中传播配置值的问题 问题 201928
  • 修复了 android.support.v7.app.NotificationCompat.MediaStyle 取消按钮在 API 级别 21 及以下版本上变为不可见的兼容性问题。（问题 202156）
  • 修复了 AppCompatSpinner 在 API 级别 21 及以下版本上的兼容性崩溃。（问题 202246）
  • 修复了 app:textAllCaps = "false" 样式不起作用的问题。（问题 202117）
  • 修复了恢复 SearchView 时的崩溃。（问题 201836）
  • 修复了使用 AppCompat 着色可绘制资源时发生的内存泄漏。（问题 202379）
  • 修复了 API 级别 11 及以下版本中 KeyEvent 的问题。（问题 202939）
针对 v7 cardview 库 的更改
针对 v7 recyclerview 库 的更改
针对 v7 mediarouter 库 的更改
针对 v17 Leanback 库 的更改
  • 修复了 GridLayout.onAddFocusables() 中导致选择错误项的问题。
  • 修复了 GuidedStepFragment 操作在操作折叠后消失的问题。
针对 设计支持库 的更改
针对 VectorDrawableCompat 的更改
  • 修复了一个错误，该错误导致读取了 android:tintMode 的错误变量。（问题 201907）

版本 23.2.0

2016 年 2 月

针对 v4 Support 库 的更改
  • 添加了 MediaBrowserCompat 以支持 MediaBrowser，以及 MediaBrowserServiceCompat 以支持 MediaBrowserService。这在将媒体应用的后台服务与 UI 组件连接以及与 Android Auto 和 Android Wear 集成时非常有用，而无需 API 级别 21 或更高版本。
  • 系统现在会为嵌套的 FragmentActivity 调用 onActivityResult()。
针对 v7 AppCompat 库 的更改
  • 将夜间模式功能添加到 API 级别 14 及更高版本。根据一天中的时间或特定于应用程序的设置，在 Material 浅色主题和 Material 深色主题 之间切换。
    • 日间和夜间主题可以在此处找到：<sdk>/extras/android/support/v7/appcompat/res/values/themes_daynight.xml
    • AppCompatDelegate.setDefaultNightMode()：通过传递以下常量之一来设置应用程序的默认模式
      • MODE_NIGHT_AUTO
      • MODE_NIGHT_NO
      • MODE_NIGHT_YES
      • MODE_NIGHT_FOLLOW_SYSTEM
    • AppCompatDelegate.setLocalNightMode()：覆盖本地应用程序组件的夜间模式设置。
    • AppCompatDelegate.getDefaultNightMode()：返回默认的夜间模式。
针对 v7 mediarouter 库 的更改
针对 Design Support 库 的更改
  • 添加了对 底部工作表 的支持。交互插件 BottomSheetBehavior 允许 CoordinatorLayout 的子视图充当底部工作表。基类 BottomSheetCallback 提供回调以监视底部工作表事件。
针对 CustomTabs Support 库 的更改
  • Chrome 自定义选项卡 现在允许应用程序除了现有的顶部操作按钮外，还包括带有操作按钮的底部栏。
  • CustomTabsIntent.Builder.addToolBarItem()：向自定义选项卡添加操作按钮。您可以使用此方法添加多个按钮。
  • CustomTabsSession.setToolBarItem()：更新工具栏项目的视觉效果。仅当提供有效的 ID 并且浏览器会话处于前台时，此方法才会成功。
添加了 VectorDrawable 支持库
  • 添加的类
    • VectorDrawableCompat
    • AnimatedVectorDrawableCompat
  • 为在 API 级别 7 或更高版本上运行的应用程序添加了对 VectorDrawable 资产的支持。在 API 级别 11 或更高版本上也支持 AnimatedVectorDrawable 资产。矢量资产可能比图像资产小得多，并且应该通过减少支持多个设备屏幕所需的资产数量来帮助减小应用程序的大小。
  • 此库现在是 v7 AppCompat 库 的依赖项，允许开发人员和 AppCompat 轻松使用矢量可绘制对象。要在 ImageButton 或 ImageView 中使用 VectorDrawableCompat，请使用 app:srcCompat XML 属性或 setImageResource() 方法。
  • 要继续在 API 级别 20 或更低版本上引用属性 ID，请将以下 appt 标志添加到您的 build,gradle 文件中
    • 如果您使用的是 Android Plugin for Gradle 1.5.0 或更低版本，请将以下内容添加到您的 build.gradle 文件中
    • android {
  defaultConfig {
    // Stops the Gradle’s automatic rasterization of vectors
    generatedDensities = []
  }
   // Flag that tells aapt to keep the attribute ids
  aaptOptions {
    additionalParameters "--no-version-vectors"
  }
}
    • 如果您使用的是 Android Plugin for Gradle 2.0.0 或更高版本，请将以下内容添加到您的 build.gradle 文件中
    • android {
  defaultConfig {
    vectorDrawables.useSupportLibrary = true
  }
}
针对 v17 Leanback 库 的更改
  • 为 GuidedStepFragment 添加了新功能，它是一个引导用户完成决策或一系列决策的组件
    • 为 GuidedAction 添加了按钮操作
      • GuidedStepFragment.setButtonActions()：设置用户可以从“操作”视图中选择的 GuidedAction 按钮列表。
    • 描述字段现在可编辑
      • GuidedAction.Builder.descriptionEditable()：当传递 true 时，将操作的描述设置为可编辑。
      • GuidedAction.getEditDescription()：将可编辑描述作为 CharSequence 返回。
    • 添加了子操作的下拉列表
      • GuidedAction.setSubActions()：将 GuidedAction 列表设置为子操作的下拉菜单。
  • 添加了用于 DatePicker 功能的 GuidedDatePickerAction 小部件
    • 日期使用年、月和日列进行选择，并具有可自定义的范围。
    • GuidedDatePickerAction.Builder：GuidedDatePickerAction 对象的构建器类。
    • GuidedDatePickerAction.Builder.datePickerFormat(String datePickerFormat)：通过传递适当的三字符 String（例如 “YMD” 或 “MDY”）来设置所需的日期格式。或者，使用 datePickerFormat XML 属性。
针对 v7 RecyclerView 库 的更改

修订版 23.1.1

2015 年 11 月

针对 v7 recyclerview 库 的更改：
  • 修复了在执行 ItemTouchHelper 实用程序类提供的滑动以关闭操作，然后添加项目时发生的崩溃问题。（问题 190500）
针对 v7 preference 库 的更改：
针对 v17 Leanback 支持库 的更改：
  • 修复了此库中的许多内部问题。
针对 设计支持库 的更改：
  • 向 NavigationView 类添加了 getHeaderView 方法。
  • 修复了在运行 Android 4.0（API 级别 15）及更低版本的设备上，FloatingActionButton 对象的透明背景问题。（问题 183315）

修订版 23.1.0

2015 年 10 月

针对 v4 支持库 的更改：
  • 向 NestedScrollView 控件添加了 OnScrollChangedListener 接口支持。它允许您在滚动 X 或 Y 位置发生变化时接收回调。
  • 添加了 MediaButtonReceiver 类，以将接收到的播放控件转发到管理 MediaSessionCompat 类的服务。 MediaSessionCompat 类有一个构造函数，可以在清单中自动查找媒体按钮接收器。媒体按钮接收器是 处理来自硬件或蓝牙控件的播放控件 的关键部分。
针对 v7 appcompat 库 的更改：
  • 添加了材质设计 Seekbar 和 ImageButton 控件。
  • 更新了 ImageView 控件以支持色调功能。
  • 更新了 SwitchCompat 控件的外观。
针对 v7 mediarouter 库 的更改：
  • 向 MediaRouteChooserDialog 类添加了以下功能
    • 在发现媒体路由提供程序时显示加载页面。
    • 包含设备类型图标，以便于识别设备。
    • 根据当前应用中使用的频率对路由进行排序。
    • 支持横向模式。
  • 向 MediaRouteControllerDialog 类添加了以下功能
    • 识别屏幕投射并提供适当的描述。
    • 支持各种专辑封面大小和纵横比，并异步加载封面。
    • 根据应用的主要颜色自动选择内容颜色。
    • 根据设备上可用的屏幕空间调整对话框布局。
    • 支持横向模式。
针对 v7 palette 库 的更改：
  • 添加了 setRegion() 方法，以支持从 Bitmap 对象的特定区域提取颜色。
针对 v7 recyclerview 库 的更改：
  • 向 ItemAnimator 类添加了改进的动画 API，以实现更好的自定义功能
    • 更改动画不再强制使用 ViewHolder 对象的两个副本，这使得项目内容动画成为可能。此外， ItemAnimator 对象决定它是否要重用相同的 ViewHolder 对象或创建一个新的对象。
    • 新的信息记录 API 使 ItemAnimator 类能够在布局生命周期的正确点灵活地收集数据。此信息稍后将传递到动画回调中。
  • 为这种向后不兼容的 API 更改提供了简单的过渡方案
    • 如果您以前扩展了 ItemAnimator 类，您可以将基类更改为 SimpleItemAnimator，并且您的代码应该像以前一样工作。 SimpleItemAnimator 类通过包装新 API 提供旧 API。
    • 某些方法已从 ItemAnimator 类中移除。以下代码将不再编译

      • Kotlin

      recyclerView.itemAnimator.supportsChangeAnimations = false

      Java

      recyclerView.getItemAnimator().setSupportsChangeAnimations(false)

      您可以用它替换

      Kotlin

      val animator: SimpleItemAnimator? = recyclerView.itemAnimator as? SimpleItemAnimator
animator?.supportsChangeAnimations = false

      Java

      ItemAnimator animator = recyclerView.getItemAnimator();
if (animator instanceof SimpleItemAnimator) {
   ((SimpleItemAnimator) animator).setSupportsChangeAnimations(false);
}
针对 v7、v14 和 v17 首选项支持库的更改
  • 删除了用于控制 EditText 对话框的 API。
针对 v17 Leanback 支持库 的更改：
  • 添加了支持库的 GuidedStepFragment 类版本（扩展 android.support.v4.app.Fragment），并改进了动画和过渡。
  • 更新了 GuidedStepFragment 类，以便可以将其放置在现有内容的顶部。
  • 向 SearchFragment 类添加了注释不同类型的搜索完成的功能。
  • 向 VerticalGridFragment 类添加了交错滑动过渡支持。
针对 设计支持库 的更改：
  • 向 TextInputLayout 控件添加了 字符计数 支持。
  • 通过添加 SCROLL_FLAG_SNAP 常量，向 AppBarLayout 类添加了边缘捕捉支持。滚动结束时，如果视图仅部分可见，则会捕捉视图并将其滚动到其最近的边缘。
  • 通过使用 app:actionLayout 属性或 MenuItemCompat.setActionView() 方法，向 NavigationView 类添加了对自定义视图的支持。
针对 自定义标签支持库 的更改：
  • 向 CustomTabsIntent 类添加了 enableUrlBarHiding() 方法。它允许客户端自定义是否应在向下滚动时自动隐藏 URL 栏。
  • 向 CustomTabsSession 类添加了 setActionButton() 方法。它允许客户端更改已启动的自定义标签中自定义操作按钮的图标。
  • 添加了 TAB_SHOWN 和 TAB_HIDDEN 常量作为 CustomTabsCallback 类的 onNavigationEvent 方法的新事件。

修订版 23.0.1

2015 年 9 月

针对 v7 和 v14 首选项支持库的更改
  • 添加了材质设计布局和样式文件。（问题 183376）
针对 v7 appcompat 库 的更改：
  • 修复了 Fragment 类的崩溃问题，方法是将硬件图层的使用限制在 Android 4.1（API 级别 16）及更高版本。（问题 183896）
  • 修复了当活动已将 Toolbar 类设置为 ActionBar 时硬件按钮无法工作的问题，方法是使用 setSupportActionBar() 方法。（问题 183334）
  • 更新了 AppCompatDialogFragment 类，使其不再抛出 Windows feature must be requested before adding content 错误。（问题 183186）
针对 设计支持库 的更改：
针对 自定义标签支持库 的更改：

修订版 23

2015 年 8 月

添加了新的支持库

有关支持库更改的完整列表，请参阅 支持库 API 差异报告。

修订版 22.2.1

2015 年 7 月

针对 设计支持库 的更改：
  • 向 FloatingActionButton 类添加了 hide() 和 show() 方法，用于以编程方式触发动画。

  • 向 Snackbar 类添加了 LENGTH_INDEFINITE 常量，用于显示 Snackbar 直到其被解除或显示另一个 Snackbar。此外，还添加了 setActionTextColor(int) 和 setActionTextColor(ColorStateList) 方法。
  • 向 TabLayout 类添加了 getSelectedTabPosition() 方法，用于检索当前选定的选项卡。
  • 为 android.support.v7.app.NotificationCompat.MediaStyle 类提供了完全流畅的 API，用于方法链。
  • 向 RecyclerView 添加了便利方法，用于批量插入项目。

有关支持库更改的完整列表，请参阅 支持库 API 差异报告。

版本 22.2.0

2015 年 5 月

添加了 设计支持库：
  • 添加了 TextInputLayout，用于将 EditText 的提示和错误文本显示为浮动标签。
  • 添加了 FloatingActionButton，用于在界面上实现主要操作作为浮动操作按钮，支持默认或迷你尺寸。
  • 添加了 Snackbar，用于提供轻量级反馈，并在动画 Snackbar 中提供可选操作。
  • 添加了 TabLayout，用于实现固定和可滚动的 选项卡，以及与 ViewPager 的轻松集成。
  • 添加了 NavigationView，用于实现 导航抽屉 内容，包括通过 菜单资源 填充菜单项的功能。
  • 添加了 CoordinatorLayout，这是一种通用布局，用于在同级视图之间构建依赖关系，并允许通过 CoordinatorLayout.Behavior 在组件之间轻松进行滚动反应。许多设计库组件依赖于作为 CoordinatorLayout 的子项。
  • 添加了 AppBarLayout，这是一个用于 Toolbar 和其他视图（如 TabLayout）的容器，用于通过滚动屏幕外、在向下滚动时变为可见或在滚动屏幕外/屏幕上之前折叠/展开来对滚动事件做出反应。
  • 添加了 CollapsingToolbarLayout，用于控制 Toolbar 如何折叠。工具栏可以通过以下方式折叠：在工具栏折叠时将组件固定到屏幕顶部，引入组件（如 ImageView）的视差滚动，或在视图部分折叠时添加内容遮罩颜色。
v4 支持库的更改：
v7 appcompat 库的更改

有关支持库更改的完整列表，请参阅 支持库 API 差异报告。

版本 22.1.0

2015 年 4 月

注释库的更改：
  • 添加了注释库，以提供对增强代码检查的支持。注释作为元数据标签添加，您可以将其附加到变量、参数和返回值，以检查方法返回值、传递的参数以及局部变量和字段。
v4 支持库的更改：
v7 appcompat 库的更改
针对 v17 leanback 库 的更改
针对 v7 recyclerview 库 的更改
针对 v8 renderscript 库 的更改

修订版 22

2015 年 3 月

v4 支持库的更改：
v7 appcompat 库的更改
针对 v17 leanback 库 的更改
针对 v7 mediarouter 库 的更改
针对 v7 recyclerview 库 的更改

修订版 21.0.3

2014 年 12 月

v4 支持库的更改：

修订版 21.0.2

2014 年 11 月

v4 支持库的更改：
v7 appcompat 库的更改
  • 添加了 PopupMenu 构造函数以支持新的弹出菜单。
  • 在 Toolbar 类中添加了对折叠图标说明的支持。
  • 更新了 SearchView 小部件以支持显示 commitIcon。
  • 从 Toolbar 类中删除了 buttonGravity 属性。
针对 v7 cardview 库 的更改
针对 v7 recyclerview 库 的更改
针对 v17 leanback 库 的更改
  • 添加了生成 v4 代码片段的支持。
  • 更改了 CardView 上的辅助文本颜色。

修订版 21.0.1

2014 年 11 月

添加了 多 dex 支持库 以支持多个 Dalvik 可执行 (DEX) 文件，以便在 Android 5.0 之前支持多 dex 文件。

修订版 21

2014 年 10 月

v4 支持库的更改：
  • 为运行 Android 5.0（API 级别 21）的设备添加了对 Fragment 过渡的支持。请注意，过渡对运行 Android 4.4 及更低版本的设备无效。
  • 添加了 DocumentFile 以简化在处理文档树时从 File 的过渡。但是，与 Android 4.4（API 级别 19）中添加的平台 DocumentsContract API 相比，此类需要更多的处理开销。因此，在 Android 4.4 及更高版本上运行时，您应该切换到使用 DocumentsContract。
v7 appcompat 库的更改
  • 添加了对 Material Design 用户界面的支持。
  • 添加了 Toolbar，它将 ActionBar 的功能泛化，以便在应用布局中使用。
  • 更新了 ActionBarDrawerToggle，其中包含菜单到箭头的动画。
  • 更新了常见的用户界面小部件，以便在预 Android 5.0 设备上运行时，可以通过主题属性进行着色。
  • 添加了 SwitchCompat，这是 Android 4.0（API 级别 14）中添加的 Switch 小部件的移植。
新的 v7 cardview 库
  • 添加了 CardView 小部件，它提供了一个与 Material Design 兼容的实现，用于显示数据项。
新的 v7 recyclerview 库
  • 添加了 RecyclerView 小部件，它提供了一个灵活的列表视图，用于提供对大型数据集的有限窗口。
新的 v7 palette 库
  • 添加了 Palette 类，它允许您从图像中提取突出的颜色。
新的 v17 leanback 库

修订版 20

2014 年 7 月

v4 support library 的更改

修订版 19.1.0

2014 年 3 月

v4 support library 的更改
  • 添加了 SwipeRefreshLayout 类，它使用户能够通过垂直滑动手势刷新视图的内容。
  • 修复了导航抽屉的可访问性问题。
v7 appcompat library 的更改
  • 修复了操作栏的背景问题。

修订版 19.0.1

2013 年 12 月

v4 support library 的更改
v7 mediarouter library 的更改
针对 v8 renderscript 库 的更改
  • 为 RenderScript 转换层添加了错误传播。

修订版 19

2013 年 10 月

v4 support library 的更改
v7 mediarouter library 的更改
  • 添加了对媒体播放队列、设置 HTTP 标头值和媒体播放持续时间的支持。
  • 添加了显式启动、获取和结束会话操作，以显式管理媒体路由器上的媒体播放会话。

修订版 18

2013 年 7 月

v4 support library 的更改
新的 v7 appcompat 库
  • 添加了 ActionBar 以允许将操作栏用户界面 设计模式 实现回 Android 2.1（API 级别 7）及更高版本。使用此类需要您通过扩展新的 ActionBarActivity 类来实现您的活动。
新的 v7 mediarouter 库

添加了一个新的 mediarouter 库，该库提供对 Google Cast 开发者预览版 的支持。v7 mediarouter 库 API 提供了一种控制媒体通道和流从当前设备到外部屏幕、扬声器和其他目标设备的路由的方法，并向后兼容到 Android 2.1（API 级别 7）。有关更多信息，请参阅 V7 mediarouter 库。

Support Library r18 中引入的 v7 mediarouter 库 API 可能会在 Support Library 的后续版本中发生更改。目前，我们建议仅在与 Google Cast 开发者预览版 结合使用时使用该库。

修订版 13

2013 年 5 月

v4 support library 的更改
新的 v7 gridlayout 库
  • 添加了 GridLayout 以提供对 GridLayout 布局对象的支持。
  • 添加了 android.support.v7.widget.Space，可用于在 GridLayout 布局对象中创建空白区域。

修订版 12

2013年2月

v4 support library 的更改
  • 改进了 ViewPager 的交互行为。
  • 修复了一个可能导致 ViewPager 选择错误页面的错误。
  • 修复了在 ViewPager 的布局期间使用 removeView() 方法的问题。
  • 修复了 SearchViewCompat 中的一个问题，即使用后退按钮关闭搜索时不会清除搜索文本。此修复程序仅适用于主机 API 级别 14 及更高版本。

修订版 11

2012年11月

v4 support library 的更改

修订版 10

2012年8月

v4 support library 的更改
  • 通过在 NotificationCompat 中添加内容，添加了对 Android 4.1（API 级别 16）中引入的通知功能的支持。

修订版 9

2012年6月

v4 support library 的更改

修订版 8

2012年4月

v4 support library 的更改
  • 修复了 TaskStackBuilder 生成的 PendingIntent 对象的意图标志。
  • 从 gridlayout 库项目中删除了未使用的属性，以确保该库可以使用 API 级别 7 及更高版本构建。
  • 为 gridlayout 库项目添加了 .classpath 和 .project 文件。

修订版 7

2012年3月

v4 support library 的更改
  • 添加了 ShareCompat，它提供了用于发送和接收社交分享应用程序内容的辅助类，包括用于将共享数据归因于源应用程序的新元数据。此类还提供了与 Android 4.0 中新的 ShareActionProvider 的兼容集成。
  • 添加了 NavUtils 和 TaskStackBuilder 以提供对实现 Android 设计 指南中导航的支持。这些新增功能包括一种跨版本实现操作栏的“向上”按钮的方法。有关此模式的示例实现，请参阅 (<em><sdk></em>/samples/<em><platform></em>/AppNavigation) 中的 AppNavigation 示例。
  • 添加了 NotificationCompat.Builder 以提供 Android 3.0 的 Notification.Builder 辅助类的兼容性实现，用于创建标准化的系统通知。

修订版 6

2011年12月

注意：支持库 API 的参考现在可与框架参考一起使用，例如：android.support.v4.app。

v4 support library 的更改
  • ViewPager 的更改
    • 为 ViewPager 添加了额外的装饰视图支持。装饰视图可以作为分页器在 XML 布局中的子视图提供。

    • 添加了 PagerAdapter.getPageTitle() 用于提供页面的标题字符串，默认情况下每个页面都没有标题。
    • 添加了 PagerTitleStrip，一个非交互式标题条，可以作为 ViewPager 的子项添加。开发者可以提供文本外观和颜色，以及布局大小和重力信息。
    • 更新了 PagerAdapter 方法，使其采用 ViewGroup 对象而不是 View，以避免适配器实现中的类转换。
    • 更新了 ViewPager 以使用 Launcher 样式的抛掷行为。
    • 修复了用户界面交互和测试自动化的错误。
  • 支持 Fragment
  • 支持辅助功能 API

版本 5

2011年12月

v4 support library 的更改

版本 4

2011 年 10 月

v4 support library 的更改
  • 添加了 EdgeEffectCompat 以支持 EdgeEffect。
  • 添加了 LocalBroadcastManager 以允许应用程序轻松地在单个应用程序内注册和接收意图，而无需在全局范围内广播它们。
  • 在 ViewCompat 中添加了支持，以便在 Android 2.3 及更高版本上检查和设置 View 的滚动超出边界模式。
  • 对 Fragment API 的更改
    • 添加了新的 API 来控制新菜单的可见性。
    • 添加了自定义动画 API。
    • 在 FragmentActivity 中添加了 API 以保留自定义的、非配置的实例数据。
    • 各种错误修复。
  • 修复了一个 Loader 错误，该错误在 Froyo 和更旧版本的平台上取消 AsyncTask 时会导致问题。支持代码现在使用其自己的 AsyncTask 版本以在所有平台版本上保持相同行为。

版本 3

2011 年 7 月

v4 support library 的更改
  • 添加了对 Fragment.SavedState 的支持
  • 添加了 MotionEventCompat 以支持较新的 MotionEvent API
  • 添加了 VelocityTrackerCompat 以支持较新的 VelocityTracker API
  • 添加了 ViewConfigurationCompat 以支持较新的 ViewConfiguration API
  • 所有新的 API（仅在支持库中可用），允许您创建具有水平分页的 UI，允许用户在内容视图之间左右滑动。支持此功能的类包括
    • ViewPager：一个 ViewGroup，它管理子视图的布局，用户可以在这些视图之间滑动。
    • PagerAdapter：一个适配器，使用表示每个页面的视图填充 ViewPager。
    • FragmentPagerAdapter：PagerAdapter 的扩展，用于在片段之间翻转。
    • FragmentStatePagerAdapter：PagerAdapter 的扩展，用于在片段之间翻转，并使用库对 Fragment.SavedState 的支持。
新的 v13 支持库
  • 包括 FragmentPagerAdapter 和 FragmentStatePagerAdapter 以支持水平分页。

    这些与添加到 v4 支持库中的 API 完全相同，但依赖于 Android 3.2 中的其他平台组件。如果您正在开发针对 Android 3.2 及更高版本的应用程序，请使用此库而不是 v4（v4 库中的所有其他 API 已经在 API 级别 13 中可用）。

版本 2

2011 年 5 月

v4 库的更改

版本 1

2011 年 3 月

使用 v4 库的初始版本。