Support Library

Changes for v4 Support Library:

• Fixed an exception in DrawableCompat.wrap() and LayerDrawable on API levels 17 to 19. (Issue 201817)
• Fixed an ArrayIndexOutOfBoundsException in ViewDragHelper.shouldInterceptTouchEvent(). (Issue 182262)
• Fixed a bug in ViewPager related to scroll calculation for size changes.
• Fixed a NullPointerException when DrawerLayout.removeDrawerListener() is called without a set DrawerLayout.DrawerListener. (Issue 202478)
• Fixed a bug where ViewPager does not set AccessibilityEvent parameters properly when scrolling.
• Fixed an issue that caused lag during device rotation when using Drawable.wrap(). (Issue 201924)

Changes for v7 appcompat library:

• Reverted dependency on vector assets so that developers using the appcompat library are not forced to use VectorDrawable and its associated build flags.
• Fixed a compatibility issue with Night Mode and API level 23. (Issue 201910)
• Fixed a compatibility issue with SwitchCompat and API level 7. (Issue 201942)
• Fixed an issue with propagating configuration values in Resources objects Issue 201928
• Fixed a compatibility issue where the NotificationCompat.MediaStyle cancel button becomes invisible on API level 21 and below. (Issue 202156)
• Fixed a compatibility crash with AppCompatSpinner on API level 21 and below. (Issue 202246)
• Fixed an issue where the app:textAllCaps = "false" style did not work. (Issue 202117)
• Fixed a crash when restoring SearchView. (Issue 201836)
• Fixed a memory leak that occurs when tinting drawable resources using AppCompat. (Issue 202379)
• Fixed an issue with KeyEvent on API level 11 and lower. (Issue 202939)

Changes for v7 cardview library:

• Added Night Mode support for CardView. (Issue 194497)

Changes for v7 recyclerview library:

• Fixed bugs related to various measure-spec methods. (Issue 201856)
• Reduced the lockdown period in which RecyclerView does not allow adapter changes while calculating a layout or scroll. (Issue 202046)
• Fixed a crash when calling notifyItemChanged() on an item that is out of view. (Issue 202136)
• Fixed a crash that occurs when RecyclerView.LayoutManager adds and removes a view in the same measurement pass. (Issue 193958)

Changes for v7 mediarouter library:

• Fixed a crash that occurs when calling MediaRouter.getInstance() on API level 17. (Issue 180654)

Changes for v17 Leanback Library:

• Fixed an issue with GridLayout.onAddFocusables() that caused the wrong item to be selected.
• Fixed issue with GuidedStepFragment actions disappearing after an action was collapsed.

Changes for Design Support Library:

• Fixed a TabLayout crash caused by tab-pooling. (Issue 201827)
• Fixed a bug in NavigationView that caused the wrong color to be selected. (Issue 201951)
• Fixed a bug where setBackgroundTintList() was no longer able to change the background color. (Issue 201873)
• Fixed an issue where AppBarLayout did not completely scroll out of view when used with android:fitsSystemWindows = “true”. (Issue 201822)
• Fixed an issue where BottomSheetDialog did not display short content views correctly. (Issue 201793)
• Fixed an issue where BottomSheetDialogFragment moved sporadically when content inside was changed. (Issue 202125)
• Fixed a crash in TextInputLayout counter link
• Fixed a crash that occured when TextInputLayout.getCounterMaxLength() restored a saved state. (Issue 202375)
• Fixed a ClassCastException that occurred when restoring a CoordinatorLayout using the saved state of a view that was not a CoordinatorLayout.

Changes for VectorDrawableCompat:

• Fixed a bug where the wrong variable was read for android:tintMode. (Issue 201907)

Changes for v4 Support library:

• Added MediaBrowserCompat for MediaBrowser support, and MediaBrowserServiceCompat for MediaBrowserService support. This is useful when connecting a media app’s background service with UI components, and integrating with Android Auto and Android Wear without requiring API level 21 or higher.
• The system now calls onActivityResult() for a nested FragmentActivity.

Changes for v7 AppCompat library:

• Added Night Mode functionality to API level 14 and higher. Switch between Material Light and Material Dark Themes based on the time of day or app-specific setting.
• • Day and night themes can be found here: <sdk>/extras/android/support/v7/appcompat/res/values/themes_daynight.xml
  • AppCompatDelegate.setDefaultNightMode(): sets the app’s default mode by passing one of the following constants:
  • • MODE_NIGHT_AUTO
    • MODE_NIGHT_NO
    • MODE_NIGHT_YES
    • MODE_NIGHT_FOLLOW_SYSTEM
  • AppCompatDelegate.setLocalNightMode(): overrides the night mode setting for the local app component.
  • AppCompatDelegate.getDefaultNightMode(): returns the default night mode.

Changes for v7 mediarouter library:

• MediaRouteControllerDialog now correctly applies custom app theme colors.

Changes for Design support library:

• Added support for bottom sheets. An interaction plugin, BottomSheetBehavior, allows a child view of a CoordinatorLayout to act as a bottom sheet. The base class, BottomSheetCallback, provides callbacks to monitor bottom sheet events.

Changes for the CustomTabs support library:

• Chrome Custom Tabs now allows apps to include a bottom bar with action buttons in addition to the existing top action button.
• CustomTabsIntent.Builder.addToolBarItem(): adds an action button to a custom tab. You can use this to add multiple buttons.
• CustomTabsSession.setToolBarItem(): updates the visuals for toolbar items. This method will only succeed if it is given a valid id and the browser session is in the foreground.

Added VectorDrawable support library:

• Added Classes:
• • VectorDrawableCompat
  • AnimatedVectorDrawableCompat
• Adds support for VectorDrawable assets to apps running on API level 7 or higher. AnimatedVectorDrawable assets are also supported on API level 11 or higher. Vector assets can be considerably smaller than image assets and should help reduce app size by reducing the amount of assets required to support multiple device screens.
• This library is now a dependency of the v7 AppCompat library, allowing developers and AppCompat to easily use vector drawables. To use VectorDrawableCompat within an ImageButton or ImageView, use the app:srcCompat XML attribute or setImageResource() method.
• To keep referencing attribute IDs on API level 20 or lower, add the following appt flag to your build,gradle file:
• • If you are building with Android Plugin for Gradle 1.5.0 or lower, add the following to your build.gradle file:

  • 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"
      }
    }
    

  • If you are building with Android Plugin for Gradle 2.0.0 or higher, add the following to your build.gradle file:

  • android {
      defaultConfig {
        vectorDrawables.useSupportLibrary = true
      }
    }
    

Changes for v17 Leanback Library:

• Added new capabilities to GuidedStepFragment, which is a component that guides users through a decision or series of decisions:
• • Added button actions to GuidedAction:
  • GuidedStepFragment.setButtonActions(): sets a list of GuidedAction buttons that the user may select from the Actions view.
  • Description fields are now editable:
  • • GuidedAction.Builder.descriptionEditable(): when passing true, sets the action’s description to be editable.
    • GuidedAction.getEditDescription(): returns the editable description as a CharSequence.
  • Added drop-down lists of sub-actions:
  • • GuidedAction.setSubActions(): sets a GuidedAction list as a drop-down menu of sub-actions.
• Added the GuidedDatePickerAction widget for DatePicker functionality:
• • The date is selected using year, month, and day columns and has a customizable range.
  • GuidedDatePickerAction.Builder: builder class for the GuidedDatePickerAction object.
  • GuidedDatePickerAction.Builder.datePickerFormat(String datePickerFormat): set the desired date format by passing the appropriate three-character String, e.g. “YMD” or “MDY”. Alternatively, use the datePickerFormat XML attribute.

Changes for v7 RecyclerView library:

• RecyclerView now has an opt-in feature called AutoMeasure which allows RecyclerView.LayoutManager to easily wrap content or handle various measurement specifications provided by the parent of the RecyclerView. It supports all existing animation capabilities of the RecyclerView.
• • If you have a custom RecyclerView.LayoutManager, call setAutoMeasureEnabled(true) to start using the new AutoMeasure API. All built-in RecyclerView.LayoutManager objects enable auto-measure by default.
  • RecyclerView.LayoutManager no longer ignores some RecyclerView.LayoutParams settings, such as MATCH_PARENT in the scroll direction.

    Note: These lifted restrictions may cause unexpected behavior in your layouts. Make sure you specify the correct layout parameters.

• When updating a RecyclerView.ViewHolder with payload information, DefaultItemAnimator now disables change animations.
• You can now modify the ItemTouchHelper escape velocity to control swipe sensitivity. To make it easier or harder to swipe, override getSwipeEscapeVelocity(float defaultValue) and modify defaultValue.

Changes for v7 recyclerview library:

• Fixed a crash that occurs when you perform a swipe-to-dismiss action that the ItemTouchHelper utility class provides, and then add an item. (Issue 190500)

Changes for v7 preference library:

• Fixed an issue with ProGuard usage. (Issue 183261)

Changes for v17 Leanback Support library:

• Fixed a number of internal issues in this library.

Changes for Design Support library:

• Added the getHeaderView method to the NavigationView class.
• Fixed a transparent background issue for a FloatingActionButton object on devices running Android 4.0 (API level 15) and lower. (Issue 183315)

Changes for v4 Support library:

• Added OnScrollChangedListener interface support to the NestedScrollView widget. It allows you to receive callbacks when the scroll X or Y positions change.
• Added a MediaButtonReceiver class to forward received playback controls to a service that’s managing the MediaSessionCompat class. The MediaSessionCompat class has a constructor that can automatically find a media button receiver in the manifest. A media button receiver is a key part to handling playback controls from hardware or bluetooth controls.

Changes for v7 appcompat library:

• Added material design Seekbar and ImageButton widgets.
• Updated the ImageView widget to support the tint feature.
• Updated the look-and-feel of the SwitchCompat widget.

Changes for v7 mediarouter library:

• Added the following features to the MediaRouteChooserDialog class:
• Displays a loading page while discovering media route providers.
• Includes a device type icon for easier device identification.
• Sorts the routes according to frequency of use in the current app.
• Supports landscape mode.

• Added the following features to the MediaRouteControllerDialog class:
• Recognizes screen casting and provides a proper description.
• Supports various album art sizes and aspect ratios, and loads the art asynchronously.
• Automatically selects the content color based on the primary color of the app.
• Adjusts the dialog layout based on available screen space on the device.
• Supports landscape mode.

Changes for v7 palette library:

• Added the setRegion() method to support extracting color from a specific region of a Bitmap object.

Changes for v7 recyclerview library:

• Added an improved animation API to the ItemAnimator class for better customizations:
• Change animations no longer enforce two copies of the ViewHolder object, which enables item content animations. Also, the ItemAnimator object decides whether it wants to reuse the same ViewHolder object or create a new one.
• The new information record API gives the ItemAnimator class the flexibility to collect data at the correct point in the layout lifecycle. This information is later passed into the animate callbacks.

• Provided an easy transition plan for this backward-incompatible API change:
• If you’ve previously extended the ItemAnimator class, you can change your base class to SimpleItemAnimator and your code should work as before. The SimpleItemAnimator class provides the old API by wrapping the new API.
• Some methods were removed from the ItemAnimator class. The following code will no longer compile:

recyclerView.getItemAnimator().setSupportsChangeAnimations(false)

You can replace it with:

ItemAnimator animator = recyclerView.getItemAnimator();
if (animator instanceof SimpleItemAnimator) {
   ((SimpleItemAnimator) animator).setSupportsChangeAnimations(false);
}
           

Changes for v7, v14, and v17 Preference Support library:

• Removed APIs for controlling EditText dialogs.

Changes for v17 Leanback Support library:

• Added a version of the GuidedStepFragment class for the Support library (extends android.support.v4.app.Fragment), and improved animations and transitions.
• Updated the GuidedStepFragment class so it can be placed on top of existing content.
• Added the ability to annotate different types of search completions to the SearchFragment class.
• Added staggered slide transition support to the VerticalGridFragment class.

Changes for Design Support library:

• Added character counting support to the TextInputLayout widget.
• Added edge snapping support to the AppBarLayout class by adding the SCROLL_FLAG_SNAP constant. When scrolling ends, if the view is only partially visible, the view is snapped and scrolled to its closest edge.
• Added support for custom views to the NavigationView class by using the app:actionLayout attribute or MenuItemCompat.setActionView() method.

Changes for Custom Tabs Support library:

• Added the enableUrlBarHiding() method to the CustomTabsIntent class. It lets the client customize whether the URL bar should be hidden automatically on scroll down.
• Added the setActionButton() method to the CustomTabsSession class. It lets the client change the icon for a custom action button in an already launched custom tab.
• Added the TAB_SHOWN and TAB_HIDDEN constants as new events for the onNavigationEvent method of the CustomTabsCallback class.

Changes for v7 and v14 Preference Support library:

• Added the material design layout and style files. (Issue 183376)

Changes for v7 appcompat library:

• Fixed crash issues for the Fragment class by limiting the use of hardware layers to Android 4.1 (API level 16) and higher. (Issue 183896)
• Fixed an issue where hardware buttons did not work when an activity had set the Toolbar class to act as the ActionBar by using the setSupportActionBar() method. (Issue 183334)
• Updated the AppCompatDialogFragment class so it no longer throws the Windows feature must be requested before adding content error. (Issue 183186)

Changes for Design Support library:

• Fixed the AppBarLayout class so it now draws correctly after rotation. (Issue 183109)
• Fixed the TabLayout class so it now behaves correctly when a user clicks after a swipe. (Issue 183123)

Changes for Custom Tabs Support library:

• Lowered the minSdkVersion value from 16 to 15 for version support.
• Added a way to generate a CustomTabsSessionToken from an intent.

Added new support libraries:

• Custom Tabs Support library
• Percent Support library
• App Recommendation Support library for TV
• v7 Preference Support library
• v14 Preference Support library
• v17 Preference Support library for TV

For a complete list of the Support Library changes, see the Support Library API Differences Report.

Changes for Design Support library:

• Added the hide() and show() methods to the FloatingActionButton class for programmatic triggering of animations.
• Added the LENGTH_INDEFINITE constant to the Snackbar class for showing a snackbar until it is dismissed or another snackbar is shown. Also, added the setActionTextColor(int) and setActionTextColor(ColorStateList) methods.
• Added the getSelectedTabPosition() method to the TabLayout class for retrieving the currently selected tab.
• Provided a fully fluent API for the NotificationCompat.MediaStyle class for method chaining.
• Added convenience methods to the RecyclerView for batch insertion of items.

For a complete list of the Support Library changes, see the Support Library API Differences Report.

Added Design Support library:

• Added TextInputLayout for showing EditText hint and error text as floating labels.
• Added FloatingActionButton for implementing a primary action on your interface as a floating action button, supporting either default or mini sizes.
• Added Snackbar for providing lightweight feedback with an optional action in an animated snackbar.
• Added TabLayout for implementing fixed and scrollable tabs as well as easy integration with ViewPager.
• Added NavigationView for implementing navigation drawer contents, including the ability to inflate menu items via a Menu Resource.
• Added CoordinatorLayout, a general purpose layout, used for building dependencies between sibling views and allowing easy scrolling reactions between components via CoordinatorLayout.Behavior. Many of the Design Library components rely on being a child of a CoordinatorLayout.
• Added AppBarLayout, a container for a Toolbar and other views (such as TabLayout) for reacting to scrolling events by scrolling off the screen, becoming visible in reaction to a downward scroll, or collapsing/uncollapsing before scrolling off/onto the screen.
• Added CollapsingToolbarLayout for controlling how a Toolbar collapses. A toolbar may collapse by: pinning components to the top of the screen while it collapses, introducing parallax scrolling of components such as an ImageView, or adding a content scrim color when the view is partially collapsed.

Changes for v4 support library:

• Added the getContentChangeTypes() and setContentChangeTypes() methods and related change type fields to the AccessibilityEventCompat class for accessibility event handling.
• Added the getActiveQueueItemId(), getCustomActions(), and getExtras() methods with related state fields to the PlaybackStateCompat class for getting custom actions from the queue.
• Added the addCustomAction(), setActiveQueueItemId(), and setExtras() methods to the PlaybackStateCompat.Builder class for adding custom actions to a playback state.
• Added the fromCustomAction() and getCustomAction() methods to the PlaybackStateCompat.CustomAction class for getting custom actions from the queue.
• Added the isAttachedToWindow(), offsetLeftAndRight(), and offsetTopAndBottom() methods to the ViewCompat class for working with views.
• Added the addOnPageChangeListener(), clearOnPageChangeListeners(), and removeOnPageChangeListener() methods to the ViewPager class for responding to page changes.

  Deprecated the setOnPageChangeListener() method.

• Added the notifySubtreeAccessibilityStateChanged() method to the ViewParentCompat class for notifying a view parent that the accessibility state of one of its descendants has changed.
• Added the translationZ(), translationZBy(), z(), and zBy() methods to the ViewPropertyAnimatorCompat class for adding animation.

Changes for v7 appcompat library:

• Added the onWindowStartingSupportActionMode() method to the AppCompatActivity, AppCompatCallback, and AppCompatDialog classes for handling action modes started from the current window.
• Added the isHandleNativeActionModesEnabled() and setHandleNativeActionModesEnabled() methods to the AppCompatDelegate class for handling native action modes.

For a complete list of the Support Library changes, see the Support Library API Differences Report.

Changes for annotations library:

• Added the Annotations library to provide support for enhanced code inspections. Annotations are added as metadata tags that you attach to variables, parameters, and return values to inspect method return values, passed parameters, and local variables and fields.

Changes for v4 support library:

• Added the ColorUtils class to provide a set of color-related utility methods.
• Added the unwrap() and wrap() methods to the DrawableCompat class , allowing you to use setTint(), setTintList(), and setTintMode() on all API level 4 or higher devices.
• Added the TraceCompat class to write trace events to the system trace buffer, which can then be collected and visualized using the Systrace tool.
• Added the CircularIntArray class to create circular integer array data structures.
• Added the clear(), removeFromStart(), and removeFromEnd() methods to the CircularArray class. Also, changed the existing methods in this class to be non-final.
• Added the InputDeviceCompat as a helper class to access data in the InputDeviceCompat class.
• Added the LayoutInflaterCompat class as a helper class to access data in the LayoutInflaterCompat class and added the LayoutInflaterFactory interface.
• Added classes, methods, and interfaces to support nested scrolling.
  • Added the NestedScrollingChildHelper and NestedScrollingParentHelper helper classes for implementing nested scrolling parent and child views.
  • Added the NestedScrollingChild interface to be implemented by View subclasses.
  • Added the NestedScrollingParent and ScrollingView interfaces to support scrolling operations and provide scroll related APIs.
  • Added the getNestedScrollAxes() method to the ViewGroupCompat class.
  • Added methods to the ViewParentCompat class to support nested scrolling.
  • Added the NestedScrollView class to support nested scrolling parent and child on both new and old versions of Android.
• Added methods and constants to the MotionEventCompat class for getting axis values and event source.
• Updated the AccessibilityNodeInfoCompat class to add methods for errors, content invalidation and labels.
• Added the following interpolation classes for animation: FastOutLinearInInterpolator, FastOutSlowInInterpolator, LinearOutSlowInInterpolator, LinearOutSlowInInterpolator, and PathInterpolatorCompat.
• Added the Space class to create gaps between components in general purpose layouts. This class is deprecated in the gridlayout library.
• Added the TextViewCompat class for accessing features in a TextView.
• Added a displacement parameter to the onPull() method in the EdgeEffectCompat class.

Changes for v7 appcompat library:

• Added tint support to appcompat widgets, including AppCompatAutoCompleteTextView, AppCompatButton, AppCompatCheckBox, AppCompatCheckedTextView, AppCompatEditText, AppCompatMultiAutoCompleteTextView, AppCompatRadioButton, AppCompatRatingBar, AppCompatSpinner, and AppCompatTextView.
• Updated the AppCompatActivity as the base class for activities that use the support library action bar features. This class replaces the deprecated ActionBarActivity.
• Added the AppCompatCallback interface to be implemented for AppCompat to be able to perform callbacks.
• Added the AppCompatDelegate abstract class as a delegate you can use to extend AppCompat's support to any activity.
• Added the AppCompatDialog class as the base class for AppCompat themed dialogs.
• Added the spinner style AlertDialog and AlertDialog.Builder classes to provide an AppCompat themed AlertDialog.
• Added the Palette.Builder class for generating Palette instances.
  • Added the from(Bitmap) method to the Palette class to start generating a Palette with the returned Palette.Builder instance.
  • Deprecated the generate() and generateAsync() methods.
• Added the getAbsoluteAlignment() method to the GridLayout.Spec class.
• Deprecated use of app:theme for styling Toolbar. You can now use android:theme for toolbars on all API level 7 and higher devices and android:theme support for all widgets on API level 11 and higher devices.

Changes for v17 leanback library:

• Added GuidedStepFragment, GuidanceStylist and GuidedActionsStylist to support creating multi-step decision flows.

Changes for v7 recyclerview library:

• Added SortedList classes to display items in a list order and provide notification of changes to the list.
• Added the SortedListAdapterCallback class that can bind a sorted list to a RecyclerView.Adapter class.

Changes for v8 renderscript library:

• Added the ScriptIntrinsicHistogram class for use as a histogram filter.
• Added the ScriptIntrinsicResize class for performing a resize of a 2D allocation.