page.title=Support Library Revision History page.metaDescription=This page provides details about the Support Library package releases. @jd:body

This page provides details about the Support Library package releases.

Android Support Library, revision 24.0.0 (June 2016)

Changes for v4 Support Library:
  • Added Fragment.commitNow() for synchronous commit
  • Added NotificationCompat.MessagingStyle for multi-party conversations
  • Added NotificationManagerCompat.areNotificationsEnabled() and getImportance()
  • {@link android.support.v4.media.session.MediaSessionCompat} now mirrors the functionality of {@link android.media.session.MediaSession} and no longer calls {@link android.media.session.MediaSession#setMediaButtonReceiver setMediaButtonReceiver()} automatically

Note: Only MediaBrowserServiceCompat in version 24.0.0 is forward-compatible with future versions of Android beyond API 24. If you are using previous versions, update to this version to ensure compatibility.

Changes for v7 appcompat library:
  • Added support for referencing themed {@link android.content.res.ColorStateList} objects from XML
Changes for Design Support Library:
  • Improvements to {@link android.support.design.widget.AppBarLayout} handling of elevation using {@link android.animation.StateListAnimator}
Changes for v17 Leanback library:
  • Added OnboardingFragment to provide first-run welcome and setup flow
Changes for custom tabs:
  • Added support for providing a {@link android.widget.RemoteViews} hierarchy for the secondary toolbar
  • Added CustomTabsClient.connectAndInitialize() for one-line warm up

Android Support Library, revision 23.4.0 (May 2016)

Changes for v4 Support Library:
  • Fixed issue where fragments were added in the wrong order. (Issue 206901)
  • Fixed issue where app bar wasn't drawn after being scrolled offscreen. (Issue 178037)
Changes for v7 appcompat library:
  • Added {@link android.support.v7.app.AppCompatDelegate#setCompatVectorFromResourcesEnabled AppCompatDelegate.setCompatVectorFromResourcesEnabled()} method to re-enable usage of vector drawables in {@link android.graphics.drawable.DrawableContainer} objects on devices running Android 4.4 (API level 19) and lower. See AppCompat v23.2 — Age of the vectors for more information.
  • Fixed an issue in API 23 with AppCompatDelegate.setDefaultNightMode() not loading correct resources in API level 23. (Issue 206573)
  • Fixed issue that could cause {@link java.lang.NullPointerException}. (Issue 207638)
Changes for Design Support Library:
  • Fixed an issue where {@link android.support.design.widget.TextInputLayout} doesn't clear error tint after {@link android.support.design.widget.TextInputLayout#setErrorEnabled setErrorEnabled(false)} on API level 21 - 22 (Issue 202829)
  • Fixed an issue where {@link android.support.design.widget.FloatingActionButton} does not return when animations are disabled. (Issue 206416)
  • Fixed issue in {@link android.support.design.widget.AppBarLayout} snap functionality when used with {@link android.support.design.R.id#scroll}|{@link android.support.design.R.id#enterAlways}|{@link android.support.design.R.id#enterAlwaysCollapsed}|{@link android.support.design.R.id#snap} scroll flags. (Issue 207398)
Changes for Vector Drawable library:
  • Fixed a bug where {@link android.support.graphics.drawable.VectorDrawableCompat} does not render correctly in {@link android.widget.TextView} on API level 23. (Issue 206227)

Android Support Library, revision 23.3.0 (April 2016)

Changes for v4 Support Library:
  • Added AppLaunchChecker to help track how your app has been launched by the user in the past. hasStartedFromLauncher() lets you know if the user has launched your app from the home screen before, or if it has only been started by other means (for example, to view specific web URLs).
  • Fixed a memory leak in MediaBrowserServiceCompat.mConnections. (Issue 205220)
  • Fixed issue where {@link android.support.v4.view.ViewPager} does not account for page margins when flipping page. (Issue 203816)
  • {@link android.support.v4.app.Fragment#onRequestPermissionsResult Fragment.onRequestPermissionsResult()} is now delivered to child fragments.
Changes for v7 appcompat library:
  • Fixed an issue in {@link android.support.v7.widget.AppCompatSpinner} that could cause multiple popups to appear. (Issue 205052)
  • Fixed an issue with how borderless buttons were colored. (Issue 202967)
  • Fixed a compatibility issue between {@link android.support.v7.app.AppCompatDialogFragment } and {@link android.support.v7.app.AlertDialog}. (Issue 204805)
  • Reverted changes to TintResources that were causing memory and configuration issues. (Issue 205236)
Changes for v7 mediarouter library:
  • Fixed {@link android.support.v7.app.MediaRouteControllerDialog} volume slider’s behavior. (Issue 202299)
Changes for v7 Preference library:
  • Fixed issue where {@link android.support.v7.preference.PreferenceFragmentCompat} would crash if dividerHeight is specified. (Issue 204778)
Changes for v7 recyclerview library:
  • Fixed a bug where {@link android.support.v7.widget.RecyclerView} would not invoke scroll callbacks if the range of visible items shrank. (Issue 200987)
  • Fixed a bug where {@link android.support.v7.widget.RecyclerView} would freeze if it was in linear layout, was weighted, and contained images. (Issue 203276)
  • Fixed a crash in {@link android.support.v7.widget.OrientationHelper#getStartAfterPadding OrientationHelper.getStartAfterPadding()}. (Issue 180521)
  • Fixed a crash with usages of android:nestedScrollingEnabled. (Issue 197932)
Changes for Design Support Library:
  • Fixed a bug where a hidden bottom sheet would handle touch events. (Issue 203654)
  • Fixed a layout issue with BottomSheetBehavior when fitsSystemWindows is true. (Issue 203057)
  • Fixed an accessibility issue with {@link android.support.design.widget.Snackbar}. (Issue 182145)
  • Fixed a crash on {@link android.support.design.widget.Snackbar} swipe. (Issue 203924)
  • Fixed a bug in {@link android.support.design.widget.AppBarLayout} with enterAlways. (Issue 203661)
  • Fixed a bug where {@link android.support.design.widget.TextInputLayout} unnecessarily clears {@link android.widget.EditText} object's background color filter. (Issue 203357)

Android Support Library, revision 23.2.1 (March 2016)

Changes for v4 Support Library:
  • Fixed an exception in {@link android.support.v4.graphics.drawable.DrawableCompat#wrap DrawableCompat.wrap()} and {@link android.graphics.drawable.LayerDrawable} on API levels 17 to 19. (Issue 201817)
  • Fixed an {@code ArrayIndexOutOfBoundsException} in {@link android.support.v4.widget.ViewDragHelper#shouldInterceptTouchEvent ViewDragHelper.shouldInterceptTouchEvent()}. (Issue 182262)
  • Fixed a bug in {@link android.support.v4.view.ViewPager} related to scroll calculation for size changes.
  • Fixed a {@code NullPointerException} when {@code DrawerLayout.removeDrawerListener()} is called without a set {@link android.support.v4.widget.DrawerLayout.DrawerListener DrawerLayout.DrawerListener}. (Issue 202478)
  • Fixed a bug where {@link android.support.v4.view.ViewPager} does not set {@link android.view.accessibility.AccessibilityEvent} parameters properly when scrolling.
  • Fixed an issue that caused lag during device rotation when using {@link android.support.v4.graphics.drawable.DrawableCompat#wrap 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 {@link android.graphics.drawable.VectorDrawable} and its associated build flags.
  • Fixed a compatibility issue with Night Mode and API level 23. (Issue 201910)
  • Fixed a compatibility issue with {@link android.support.v7.widget.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 {@link android.support.v7.app.NotificationCompat.MediaStyle NotificationCompat.MediaStyle} cancel button becomes invisible on API level 21 and below. (Issue 202156)
  • Fixed a compatibility crash with {@link android.support.v7.widget.AppCompatSpinner} on API level 21 and below. (Issue 202246)
  • Fixed an issue where the {@code app:textAllCaps = "false"} style did not work. (Issue 202117)
  • Fixed a crash when restoring {@link android.widget.SearchView}. (Issue 201836)
  • Fixed a memory leak that occurs when tinting drawable resources using AppCompat. (Issue 202379)
  • Fixed an issue with {@link android.view.KeyEvent} on API level 11 and lower. (Issue 202939)
Changes for v7 cardview library:
  • Added Night Mode support for {@link android.support.v7.widget.CardView}. (Issue 194497)
Changes for v7 recyclerview library:
  • Fixed bugs related to various measure-spec methods. (Issue 201856)
  • Reduced the lockdown period in which {@link android.support.v7.widget.RecyclerView} does not allow adapter changes while calculating a layout or scroll. (Issue 202046)
  • Fixed a crash when calling {@link android.support.v7.widget.RecyclerView.Adapter#notifyItemChanged notifyItemChanged()} on an item that is out of view. (Issue 202136)
  • Fixed a crash that occurs when {@link android.support.v7.widget.RecyclerView.LayoutManager 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 {@link android.support.v7.media.MediaRouter#getInstance MediaRouter.getInstance()} on API level 17. (Issue 180654)
Changes for v17 Leanback Library:
  • Fixed an issue with {@code GridLayout.onAddFocusables()} that caused the wrong item to be selected.
  • Fixed issue with {@link android.support.v17.leanback.app.GuidedStepFragment} actions disappearing after an action was collapsed.
Changes for Design Support Library:
  • Fixed a {@link android.support.design.widget.TabLayout} crash caused by tab-pooling. (Issue 201827)
  • Fixed a bug in {@link android.support.design.widget.NavigationView} that caused the wrong color to be selected. (Issue 201951)
  • Fixed a bug where {@link android.support.design.widget.FloatingActionButton#setBackgroundTintList setBackgroundTintList()} was no longer able to change the background color. (Issue 201873)
  • Fixed an issue where {@link android.support.design.widget.AppBarLayout} did not completely scroll out of view when used with {@code android:fitsSystemWindows = “true”}. (Issue 201822)
  • Fixed an issue where {@code BottomSheetDialog} did not display short content views correctly. (Issue 201793)
  • Fixed an issue where {@code BottomSheetDialogFragment} moved sporadically when content inside was changed. (Issue 202125)
  • Fixed a crash in TextInputLayout counter link
  • Fixed a crash that occured when {@link android.support.design.widget.TextInputLayout#getCounterMaxLength TextInputLayout.getCounterMaxLength()} restored a saved state. (Issue 202375)
  • Fixed a {@code ClassCastException} that occurred when restoring a {@link android.support.design.widget.CoordinatorLayout} using the saved state of a view that was not a {@link android.support.design.widget.CoordinatorLayout}.
Changes for VectorDrawableCompat:
  • Fixed a bug where the wrong variable was read for {@code android:tintMode}. (Issue 201907)

Android Support Library, revision 23.2.0 (February 2016)

Changes for v4 Support library:
  • Added {@code MediaBrowserCompat} for {@link android.media.browse.MediaBrowser} support, and {@code MediaBrowserServiceCompat} for {@link android.service.media.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 {@link android.support.v4.app.FragmentActivity#onActivityResult onActivityResult()} for a nested {@link android.support.v4.app.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: {@code <sdk>/extras/android/support/v7/appcompat/res/values/themes_daynight.xml}
    • {@code AppCompatDelegate.setDefaultNightMode()}: sets the app’s default mode by passing one of the following constants:
      • {@code MODE_NIGHT_AUTO}
      • {@code MODE_NIGHT_NO}
      • {@code MODE_NIGHT_YES}
      • {@code MODE_NIGHT_FOLLOW_SYSTEM}
    • {@code AppCompatDelegate.setLocalNightMode()}: overrides the night mode setting for the local app component.
    • {@code AppCompatDelegate.getDefaultNightMode()}: returns the default night mode.
Changes for v7 mediarouter library:
  • {@link android.support.v7.app.MediaRouteControllerDialog} now correctly applies custom app theme colors.
Changes for Design support library:
  • Added support for bottom sheets. An interaction plugin, {@code BottomSheetBehavior}, allows a child view of a {@link android.support.design.widget.CoordinatorLayout} to act as a bottom sheet. The base class, {@code 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.
  • {@code CustomTabsIntent.Builder.addToolBarItem()}: adds an action button to a custom tab. You can use this to add multiple buttons.
  • {@code 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:
    • {@code VectorDrawableCompat}
    • {@code AnimatedVectorDrawableCompat}
  • Adds support for {@link android.graphics.drawable.VectorDrawable} assets to apps running on API level 7 or higher. {@link android.graphics.drawable.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 {@code VectorDrawableCompat} within an {@link android.widget.ImageButton} or {@link android.widget.ImageView}, use the {@code app:srcCompat} XML attribute or {@code setImageResource()} method.
  • To keep referencing attribute IDs on API level 20 or lower, add the following {@code appt} flag to your {@code build,gradle} file:
    • If you are building with Android Plugin for Gradle 1.5.0 or lower, add the following to your {@code 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 {@code build.gradle} file:
    • android {
        defaultConfig {
          vectorDrawables.useSupportLibrary = true
        }
      }
      
Changes for v17 Leanback Library:
  • Added new capabilities to {@link android.support.v17.leanback.app.GuidedStepFragment}, which is a component that guides users through a decision or series of decisions:
    • Added button actions to {@link android.support.v17.leanback.widget.GuidedAction}:
      • {@code GuidedStepFragment.setButtonActions()}: sets a list of {@link android.support.v17.leanback.widget.GuidedAction} buttons that the user may select from the Actions view.
    • Description fields are now editable:
      • {@code GuidedAction.Builder.descriptionEditable()}: when passing {@code true}, sets the action’s description to be editable.
      • {@code GuidedAction.getEditDescription()}: returns the editable description as a {@code CharSequence}.
    • Added drop-down lists of sub-actions:
      • {@code GuidedAction.setSubActions()}: sets a {@link android.support.v17.leanback.widget.GuidedAction} list as a drop-down menu of sub-actions.
  • Added the {@code GuidedDatePickerAction} widget for {@link android.widget.DatePicker} functionality:
    • The date is selected using year, month, and day columns and has a customizable range.
    • {@code GuidedDatePickerAction.Builder}: builder class for the {@code GuidedDatePickerAction} object.
    • {@code GuidedDatePickerAction.Builder.datePickerFormat(String datePickerFormat)}: set the desired date format by passing the appropriate three-character {@code String}, e.g. {@code “YMD”} or {@code “MDY”}. Alternatively, use the {@code datePickerFormat} XML attribute.
Changes for v7 RecyclerView library:
  • {@link android.support.v7.widget.RecyclerView} now has an opt-in feature called AutoMeasure which allows {@link android.support.v7.widget.RecyclerView.LayoutManager} to easily wrap content or handle various measurement specifications provided by the parent of the {@link android.support.v7.widget.RecyclerView}. It supports all existing animation capabilities of the {@link android.support.v7.widget.RecyclerView}.
    • If you have a custom {@link android.support.v7.widget.RecyclerView.LayoutManager}, call {@code setAutoMeasureEnabled(true)} to start using the new AutoMeasure API. All built-in {@link android.support.v7.widget.RecyclerView.LayoutManager} objects enable auto-measure by default.
    • {@link android.support.v7.widget.RecyclerView.LayoutManager} no longer ignores some {@link android.support.v7.widget.RecyclerView.LayoutParams} settings, such as {@code 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 {@link android.support.v7.widget.RecyclerView.ViewHolder} with payload information, {@link android.support.v7.widget.DefaultItemAnimator} now disables change animations.
  • You can now modify the {@link android.support.v7.widget.helper.ItemTouchHelper} escape velocity to control swipe sensitivity. To make it easier or harder to swipe, override {@code getSwipeEscapeVelocity(float defaultValue)} and modify {@code defaultValue}.

Android Support Library, revision 23.1.1 (November 2015)

Changes for v7 recyclerview library:
  • Fixed a crash that occurs when you perform a swipe-to-dismiss action that the {@code ItemTouchHelper} utility class provides, and then add an item. (Issue 190500)
Changes for v7 preference library:
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)

Android Support Library, revision 23.1.0 (October 2015)

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.

Android Support Library, revision 23.0.1 (September 2015)

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 {@link android.app.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 {@link android.widget.Toolbar} class to act as the {@link android.app.ActionBar} by using the setSupportActionBar() method. (Issue 183334)
  • Updated the {@link android.support.v7.app.AppCompatDialogFragment} class so it no longer throws the {@code Windows feature must be requested before adding content} error. (Issue 183186)
Changes for Design Support library:
  • Fixed the {@link android.support.design.widget.AppBarLayout} class so it now draws correctly after rotation. (Issue 183109)
  • Fixed the {@link android.support.design.widget.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 {@link android.support.customtabs.CustomTabsSessionToken} from an intent.

Android Support Library, revision 23 (August 2015)

Added new support libraries:

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

Android Support Library, revision 22.2.1 (July 2015)

Changes for Design Support library:
  • Added the {@code hide()} and {@code show()} methods to the {@link android.support.design.widget.FloatingActionButton} class for programmatic triggering of animations.
  • Added the {@code LENGTH_INDEFINITE} constant to the {@link android.support.design.widget.Snackbar} class for showing a snackbar until it is dismissed or another snackbar is shown. Also, added the {@link android.support.design.widget.Snackbar#setActionTextColor(int)} and {@link android.support.design.widget.Snackbar#setActionTextColor(ColorStateList)} methods.
  • Added the {@code getSelectedTabPosition()} method to the {@link android.support.design.widget.TabLayout} class for retrieving the currently selected tab.
  • Provided a fully fluent API for the {@link android.support.v7.app.NotificationCompat.MediaStyle} class for method chaining.
  • Added convenience methods to the {@link android.support.v7.widget.RecyclerView} for batch insertion of items.

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

Android Support Library, revision 22.2.0 (May 2015)

Added Design Support library:
  • Added {@link android.support.design.widget.TextInputLayout} for showing {@link android.widget.EditText} hint and error text as floating labels.
  • Added {@link android.support.design.widget.FloatingActionButton} for implementing a primary action on your interface as a floating action button, supporting either default or mini sizes.
  • Added {@link android.support.design.widget.Snackbar} for providing lightweight feedback with an optional action in an animated snackbar.
  • Added {@link android.support.design.widget.TabLayout} for implementing fixed and scrollable tabs as well as easy integration with {@link android.support.v4.view.ViewPager}.
  • Added {@link android.support.design.widget.NavigationView} for implementing navigation drawer contents, including the ability to inflate menu items via a Menu Resource.
  • Added {@link android.support.design.widget.CoordinatorLayout}, a general purpose layout, used for building dependencies between sibling views and allowing easy scrolling reactions between components via {@link android.support.design.widget.CoordinatorLayout.Behavior}. Many of the Design Library components rely on being a child of a {@link android.support.design.widget.CoordinatorLayout}.
  • Added {@link android.support.design.widget.AppBarLayout}, a container for a {@link android.widget.Toolbar} and other views (such as {@link android.support.design.widget.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 {@link android.support.design.widget.CollapsingToolbarLayout} for controlling how a {@link android.widget.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 {@link android.widget.ImageView}, or adding a content scrim color when the view is partially collapsed.
Changes for v4 support library:
  • Added the {@link android.support.v4.view.accessibility.AccessibilityEventCompat#getContentChangeTypes getContentChangeTypes()} and {@link android.support.v4.view.accessibility.AccessibilityEventCompat#setContentChangeTypes setContentChangeTypes()} methods and related change type fields to the {@link android.support.v4.view.accessibility.AccessibilityEventCompat} class for accessibility event handling.
  • Added the {@link android.support.v4.media.session.PlaybackStateCompat#getActiveQueueItemId getActiveQueueItemId()}, {@link android.support.v4.media.session.PlaybackStateCompat#getCustomActions getCustomActions()}, and {@link android.support.v4.media.session.PlaybackStateCompat#getExtras getExtras()} methods with related state fields to the {@link android.support.v4.media.session.PlaybackStateCompat} class for getting custom actions from the queue.
  • Added the {@link android.support.v4.media.session.PlaybackStateCompat.Builder#addCustomAction addCustomAction()}, {@link android.support.v4.media.session.PlaybackStateCompat.Builder#setActiveQueueItemId setActiveQueueItemId()}, and {@link android.support.v4.media.session.PlaybackStateCompat.Builder#setExtras setExtras()} methods to the {@link android.support.v4.media.session.PlaybackStateCompat.Builder} class for adding custom actions to a playback state.
  • Added the {@link android.support.v4.media.session.PlaybackStateCompat.CustomAction#fromCustomAction fromCustomAction()} and {@link android.support.v4.media.session.PlaybackStateCompat.CustomAction#getCustomAction getCustomAction()} methods to the {@link android.support.v4.media.session.PlaybackStateCompat.CustomAction} class for getting custom actions from the queue.
  • Added the {@link android.support.v4.view.ViewCompat#isAttachedToWindow isAttachedToWindow()}, {@link android.support.v4.view.ViewCompat#offsetLeftAndRight offsetLeftAndRight()}, and {@link android.support.v4.view.ViewCompat#offsetTopAndBottom offsetTopAndBottom()} methods to the {@link android.support.v4.view.ViewCompat} class for working with views.
  • Added the {@link android.support.v4.view.ViewPager#addOnPageChangeListener addOnPageChangeListener()}, {@link android.support.v4.view.ViewPager#clearOnPageChangeListeners clearOnPageChangeListeners()}, and {@link android.support.v4.view.ViewPager#removeOnPageChangeListener removeOnPageChangeListener()} methods to the {@link android.support.v4.view.ViewPager} class for responding to page changes.

    Deprecated the {@link android.support.v4.view.ViewPager#setOnPageChangeListener setOnPageChangeListener()} method.

  • Added the {@link android.support.v4.view.ViewParentCompat#notifySubtreeAccessibilityStateChanged notifySubtreeAccessibilityStateChanged()} method to the {@link android.support.v4.view.ViewParentCompat} class for notifying a view parent that the accessibility state of one of its descendants has changed.
  • Added the {@link android.support.v4.view.ViewPropertyAnimatorCompat#translationZ translationZ()}, {@link android.support.v4.view.ViewPropertyAnimatorCompat#translationZBy translationZBy()}, {@link android.support.v4.view.ViewPropertyAnimatorCompat#z z()}, and {@link android.support.v4.view.ViewPropertyAnimatorCompat#zBy zBy()} methods to the {@link android.support.v4.view.ViewPropertyAnimatorCompat} class for adding animation.
Changes for v7 appcompat library:
  • Added the {@link android.support.v7.app.AppCompatActivity#onWindowStartingSupportActionMode onWindowStartingSupportActionMode()} method to the {@link android.support.v7.app.AppCompatActivity}, {@link android.support.v7.app.AppCompatCallback}, and {@link android.support.v7.app.AppCompatDialog} classes for handling action modes started from the current window.
  • Added the {@link android.support.v7.app.AppCompatDelegate#isHandleNativeActionModesEnabled isHandleNativeActionModesEnabled()} and {@link android.support.v7.app.AppCompatDelegate#setHandleNativeActionModesEnabled setHandleNativeActionModesEnabled()} methods to the {@link android.support.v7.app.AppCompatDelegate} class for handling native action modes.

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

Android Support Library, revision 22.1.0 (April 2015)

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 {@link android.support.v4.graphics.ColorUtils ColorUtils} class to provide a set of color-related utility methods.
  • Added the {@link android.support.v4.graphics.drawable.DrawableCompat#unwrap unwrap()} and {@link android.support.v4.graphics.drawable.DrawableCompat#wrap wrap()} methods to the {@link android.support.v4.graphics.drawable.DrawableCompat} class , allowing you to use {@link android.support.v4.graphics.drawable.DrawableCompat#setTint setTint()}, {@link android.support.v4.graphics.drawable.DrawableCompat#setTintList setTintList()}, and {@link android.support.v4.graphics.drawable.DrawableCompat#setTintMode setTintMode()} on all API level 4 or higher devices.
  • Added the {@link android.support.v4.os.TraceCompat} class to write trace events to the system trace buffer, which can then be collected and visualized using the Systrace tool.
  • Added the {@link android.support.v4.util.CircularIntArray} class to create circular integer array data structures.
  • Added the {@link android.support.v4.util.CircularArray#clear clear()}, {@link android.support.v4.util.CircularArray#removeFromStart removeFromStart()}, and {@link android.support.v4.util.CircularArray#removeFromEnd removeFromEnd()} methods to the {@link android.support.v4.util.CircularArray} class. Also, changed the existing methods in this class to be non-final.
  • Added the {@link android.support.v4.view.InputDeviceCompat} as a helper class to access data in the {@link android.support.v4.view.InputDeviceCompat} class.
  • Added the {@link android.support.v4.view.LayoutInflaterCompat} class as a helper class to access data in the {@link android.support.v4.view.LayoutInflaterCompat} class and added the {@link android.support.v4.view.LayoutInflaterFactory} interface.
  • Added classes, methods, and interfaces to support nested scrolling.
    • Added the {@link android.support.v4.view.NestedScrollingChildHelper} and {@link android.support.v4.view.NestedScrollingParentHelper} helper classes for implementing nested scrolling parent and child views.
    • Added the {@link android.support.v4.view.NestedScrollingChild} interface to be implemented by {@link android.view.View} subclasses.
    • Added the {@link android.support.v4.view.NestedScrollingParent} and {@link android.support.v4.view.ScrollingView} interfaces to support scrolling operations and provide scroll related APIs.
    • Added the {@link android.support.v4.view.ViewGroupCompat#getNestedScrollAxes getNestedScrollAxes()} method to the {@link android.support.v4.view.ViewGroupCompat} class.
    • Added methods to the {@link android.support.v4.view.ViewParentCompat} class to support nested scrolling.
    • Added the {@link android.support.v4.widget.NestedScrollView} class to support nested scrolling parent and child on both new and old versions of Android.
  • Added methods and constants to the {@link android.support.v4.view.MotionEventCompat} class for getting axis values and event source.
  • Updated the {@link android.support.v4.view.accessibility.AccessibilityNodeInfoCompat} class to add methods for errors, content invalidation and labels.
  • Added the following interpolation classes for animation: {@link android.support.v4.view.animation.FastOutLinearInInterpolator}, {@link android.support.v4.view.animation.FastOutSlowInInterpolator}, {@link android.support.v4.view.animation.LinearOutSlowInInterpolator}, {@link android.support.v4.view.animation.LinearOutSlowInInterpolator}, and {@link android.support.v4.view.animation.PathInterpolatorCompat}.
  • Added the {@link android.support.v4.widget.Space} class to create gaps between components in general purpose layouts. This class is deprecated in the gridlayout library.
  • Added the {@link android.support.v4.widget.TextViewCompat} class for accessing features in a {@link android.widget.TextView}.
  • Added a displacement parameter to the {@link android.support.v4.widget.EdgeEffectCompat#onPull onPull()} method in the {@link android.support.v4.widget.EdgeEffectCompat} class.
Changes for v7 appcompat library:
  • Added tint support to appcompat widgets, including {@link android.support.v7.widget.AppCompatAutoCompleteTextView}, {@link android.support.v7.widget.AppCompatButton}, {@link android.support.v7.widget.AppCompatCheckBox}, {@link android.support.v7.widget.AppCompatCheckedTextView}, {@link android.support.v7.widget.AppCompatEditText}, {@link android.support.v7.widget.AppCompatMultiAutoCompleteTextView}, {@link android.support.v7.widget.AppCompatRadioButton}, {@link android.support.v7.widget.AppCompatRatingBar}, {@link android.support.v7.widget.AppCompatSpinner}, and {@link android.support.v7.widget.AppCompatTextView}.
  • Updated the {@link android.support.v7.app.AppCompatActivity} as the base class for activities that use the support library action bar features. This class replaces the deprecated {@link android.support.v7.app.ActionBarActivity}.
  • Added the {@link android.support.v7.app.AppCompatCallback} interface to be implemented for AppCompat to be able to perform callbacks.
  • Added the {@link android.support.v7.app.AppCompatDelegate} abstract class as a delegate you can use to extend AppCompat's support to any activity.
  • Added the {@link android.support.v7.app.AppCompatDialog} class as the base class for AppCompat themed dialogs.
  • Added the spinner style {@link android.support.v7.app.AlertDialog} and {@link android.support.v7.app.AlertDialog.Builder} classes to provide an AppCompat themed {@link android.app.AlertDialog}.
  • Added the {@link android.support.v7.graphics.Palette.Builder} class for generating {@link android.support.v7.graphics.Palette} instances.
    • Added the {@link android.support.v7.graphics.Palette#from} method to the {@link android.support.v7.graphics.Palette} class to start generating a Palette with the returned {@link android.support.v7.graphics.Palette.Builder} instance.
    • Deprecated the {@link android.support.v7.graphics.Palette#generate generate()} and {@link android.support.v7.graphics.Palette#generateAsync generateAsync()} methods.
  • Added the {@link android.support.v7.widget.GridLayout.Spec#getAbsoluteAlignment getAbsoluteAlignment()} method to the {@link android.support.v7.widget.GridLayout.Spec} class.
  • Deprecated use of app:theme for styling {@link android.support.v7.widget.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 {@link android.support.v17.leanback.app.GuidedStepFragment}, {@link android.support.v17.leanback.widget.GuidanceStylist} and {@link android.support.v17.leanback.widget.GuidedActionsStylist} to support creating multi-step decision flows.
Changes for v7 recyclerview library:
  • Added {@link android.support.v7.util.SortedList} classes to display items in a list order and provide notification of changes to the list.
  • Added the {@link android.support.v7.widget.util.SortedListAdapterCallback} class that can bind a sorted list to a {@link android.support.v7.widget.RecyclerView.Adapter} class.
Changes for v8 renderscript library:
  • Added the {@link android.support.v8.renderscript.ScriptIntrinsicHistogram} class for use as a histogram filter.
  • Added the {@link android.support.v8.renderscript.ScriptIntrinsicResize} class for performing a resize of a 2D allocation.

Android Support Library, revision 22 (March 2015)

Changes for v4 support library:
  • Updated the {@link android.support.v4.content.res.ResourcesCompat#getDrawable getDrawable()} method to return a drawable object for a specified specific resource ID, screen density, and theme.
  • Added the {@link android.support.v4.view.ViewCompat#setImportantForAccessibility setImportantForAccessibility()} method so you can indicate if a view should trigger accessibility events.
  • Added the {@link android.support.v4.widget.DrawerLayout#getStatusBarBackgroundDrawable getStatusBarBackgroundDrawable()} method so you can get the status bar background drawable.
  • Added methods to the {@link android.support.v4.app.NotificationCompat.CarExtender.UnreadConversation} class so Android Auto messaging apps can retrieve additional notification data.
  • Added the {@link android.support.v4.widget.SwipeRefreshLayout#getProgressCircleDiameter getProgressCircleDiameter()} method to return the diameter of a circle layout.
  • Changed the default {@link android.support.v4.widget.DrawerLayout DrawerLayout} status bar color to {@link android.R.attr#colorPrimaryDark}.
Changes for v7 appcompat library:
  • Added the spinner style {@link android.support.v7.appcompat.R.style#Base_Widget_AppCompat_Spinner_Underlined}.
  • Added tinted widgets styles with {@link android.support.v7.appcompat.R.style#Widget_AppCompat_AutoCompleteTextView}, {@link android.widget.MultiAutoCompleteTextView}, {@link android.support.v7.appcompat.R.style#TextAppearance_AppCompat_Button}, and {@link android.support.v7.appcompat.R.style#Base_Widget_AppCompat_RatingBar}.
Changes for v17 leanback library:
  • Added the {@link android.support.v17.leanback.widget.ListRowPresenter#getRecycledPoolSize getRecycledPoolSize()} and {@link android.support.v17.leanback.widget.ListRowPresenter#setRecycledPoolSize setRecycledPoolSize()} methods to allow customized recycled pool sizes.
  • Added the {@link android.view.ViewGroup.LayoutParams#WRAP_CONTENT} attribute to the layout width setting to support wrapped content for title icons.
  • Defined {@link android.support.v17.leanback.R.transition} in XML to improve transition updates.
  • Enabled support for right to left layouts.
  • Added the play and pause media key events support to the {@link android.support.v17.leanback.app.PlaybackOverlayFragment} class.
  • Added enter and return transitions to the {@link android.support.v17.leanback.app.BrowseFragment} class and the {@link android.support.v17.leanback.app.DetailsFragment} class.
  • Added the {@link android.support.v17.leanback.widget.ArrayObjectAdapter#replace replace()} method to replace items in an object’s adapter array.
Changes for v7 mediarouter library:
  • Updated Google Cast icons to use the material design style.
  • Updated all the icons used in the {@link android.media.MediaRouter} dialogs to use the material design style.
Changes for v7 recyclerview library:
  • Added the {@link android.support.v7.widget.RecyclerView.ViewHolder#getLayoutPosition getlayoutPosition()} and {@link android.support.v7.widget.RecyclerView.ViewHolder#getAdapterPosition getadapterPosition()} methods to the {@link android.support.v7.widget.RecyclerView} class.
  • Deprecated the classgetChildPosition() and findViewHolderForPosition() methods in the {@link android.support.v7.widget.RecyclerView} class.
  • Deprecated the getPosition() method in the {@link android.support.v7.widget.RecyclerView.ViewHolder} class.
  • Deprecated the getViewPosition() method in the {@link android.support.v7.widget.RecyclerView.LayoutParams} class.

Android Support Library, revision 21.0.3 (December 2014)

Changes for v4 support library:
  • Added several {@link android.support.v4.app.NotificationCompat.WearableExtender} methods to improve the display of barcodes in notifications on wearable devices.
    • {@link android.support.v4.app.NotificationCompat.WearableExtender#getHintScreenTimeout getHintScreenTimeout()}
    • {@link android.support.v4.app.NotificationCompat.WearableExtender#setHintScreenTimeout setHintScreenTimeout()}
    • {@link android.support.v4.app.NotificationCompat.WearableExtender#getHintAvoidBackgroundClipping getHintAvoidBackgroundClipping()}
    • {@link android.support.v4.app.NotificationCompat.WearableExtender#setHintAvoidBackgroundClipping setHintAvoidBackgroundClipping()}

Android Support Library, revision 21.0.2 (November 2014)

Changes for v4 support library:
  • Added {@link android.support.v4.app.NotificationCompat.CarExtender} class to support Android Auto extensions to notifications.
Changes for v7 appcompat library:
  • Added the {@link android.support.v7.widget.PopupMenu} constructor to support new popup menus.
  • Added support for a Collapse icon description in the {@link android.support.v7.widget.Toolbar} class.
  • Updated the {@link android.support.v7.widget.SearchView} widget to support displaying the {@link android.support.v7.appcompat.R.attr#commitIcon}.
  • Removed the buttonGravity attribute from the {@link android.support.v7.widget.Toolbar} class.
Changes for v7 cardview library:
  • Added {@link android.support.v7.widget.CardView#setCardBackgroundColor} API to support changing the background color of the {@link android.support.v7.widget.CardView}.
  • Changed the {@link android.support.v7.widget.CardView} to more accurately report its opacity value as {@link android.graphics.PixelFormat#TRANSLUCENT}.
Changes for v7 recyclerview library:
  • Added {@link android.support.v7.widget.RecyclerView#TOUCH_SLOP_DEFAULT} and {@link android.support.v7.widget.RecyclerView#TOUCH_SLOP_PAGING} constants to the {@link android.support.v7.widget.RecyclerView} class to support touch slop configurations for paging.
Changes for v17 leanback library:
  • Added support to generate v4 code fragments.
  • Changed the secondary text color on {@link android.support.v7.widget.CardView}.

Android Support Library, revision 21.0.1 (November 2014)

Added multidex support library to support multiple Dalvik Executable (DEX) files for multi-dex file support prior to Android 5.0.

Android Support Library, revision 21 (October 2014)

Changes for v4 support library:
  • Added support for {@link android.support.v4.app.Fragment} transitions for devices running Android 5.0 (API level 21). Be aware that transitions have no effect on devices running Android 4.4 and lower.
  • Added {@link android.support.v4.provider.DocumentFile} to ease the transition from {@link java.io.File} while working with document trees. However, this class demands more processing overhead compared to the platform's {@link android.provider.DocumentsContract} API added in Android 4.4 (API level 19). So you should switch to using {@link android.provider.DocumentsContract} when running on Android 4.4 and higher.
Changes for v7 appcompat library:
  • Added support for material design user interfaces.
  • Added {@link android.support.v7.widget.Toolbar}, which generalizes the functionality of {@link android.support.v7.app.ActionBar} for use within app layouts.
  • Updated {@link android.support.v7.app.ActionBarDrawerToggle}, which contains the menu-to-arrow animation
  • Updated common user interface widgets to allow tinting via theme attributes when running on pre-Android 5.0 devices
  • Added {@link android.support.v7.widget.SwitchCompat}, a backport of the {@link android.widget.Switch} widget that was added in Android 4.0 (API level 14).
New v7 cardview library:
  • Added the {@link android.support.v7.widget.CardView} widget, which provides a material design-compatible implementation for displaying data items.
New v7 recyclerview library:
  • Added the {@link android.support.v7.widget.RecyclerView} widget, which provides a flexible list view for providing a limited window into a large data set.
New v7 palette library:
  • Added {@link android.support.v7.graphics.Palette} class, which lets you extract prominent colors from an image.
New v17 leanback library:
  • Added support for building TV user interfaces, including {@link android.support.v17.leanback.app.BrowseFragment}, {@link android.support.v17.leanback.app.DetailsFragment}, and {@link android.support.v17.leanback.app.PlaybackOverlayFragment}. For more information about using these user interface widgets, see Building TV Playback Apps.

Android Support Library, revision 20 (July 2014)

Changes for v4 support library:
  • Added extended notification support for Android Wear in {@link android.support.v4.app.NotificationCompat.WearableExtender}, which allows you to specify wearable-specific features in your notifications.
  • Added {@link android.support.v4.app.NotificationCompat.Action.WearableExtender}, which allows actions to be added on wearable notifications.
  • Added {@link android.support.v4.app.NotificationManagerCompat}, which allows you to issue notifications that properly support wearable features.
  • Added {@link android.support.v4.app.RemoteInput}, which allows a handheld device to receive voice input from a notification that appears on a wearable device.
  • Improved the handling of touch feedback in {@link android.support.v4.widget.SwipeRefreshLayout}.

Android Support Library, revision 19.1.0 (March 2014)

Changes for v4 support library:
  • Added the {@link android.support.v4.widget.SwipeRefreshLayout} class, which enables users to refresh the contents of a view with a vertical swipe gesture.
  • Fixed accessibility issues with navigation drawers.
Changes for v7 appcompat library:
  • Fixed background issues with the action bar.

Android Support Library, revision 19.0.1 (December 2013)

Changes for v4 support library:
  • Improved {@link android.support.v4.print.PrintHelper} by adding asynchronous handling of printing.
  • Fixed the {@link android.support.v4.widget.DrawerLayout} class approximation of the {@link android.view.View#addChildrenForAccessibility addChildrenForAccessibility()} method.
  • Fixed slide drawable mirroring in {@link android.support.v4.app.ActionBarDrawerToggle}.
  • Fixed off-by-one issue when removing an item from a collection iterator.
Changes for v7 mediarouter library:
  • Improved route identification by using full component name in the {@link android.support.v7.media.MediaRouteProvider.ProviderMetadata}.
  • Updated {@link android.support.v7.app.MediaRouteChooserDialog} to hide disabled routes.
Changes for v8 renderscript library
  • Added error propagation for the RenderScript thunking layer.

Android Support Library, revision 19 (October 2013)

Changes for v4 support library:
  • Added support for external Storage APIs with the {@link android.support.v4.content.ContextCompat#getObbDirs getObbDirs()}, {@link android.support.v4.content.ContextCompat#getExternalFilesDirs getExternalFilesDirs()}, {@link android.support.v4.content.ContextCompat#getExternalCacheDirs getExternalCacheDirs()}, and {@link android.support.v4.os.EnvironmentCompat#getStorageState getStorageState()}. These helper methods always return a single file object on devices running Android 4.3 (API level 18) and earlier. When running on Android 4.4 (API level 19) and higher, these methods may return more than one file object.
  • Added {@link android.support.v4.print.PrintHelper} class that works with the Print APIs to print images with a minimum of code.
  • Added drag-to-open user interface support for pop-up menus. For more information, see {@link android.support.v4.widget.PopupMenuCompat} and {@link android.support.v4.widget.ListPopupWindowCompat}.
  • Improved accessibility support with the addition of a {@link android.support.v4.view.accessibility.AccessibilityNodeProviderCompat#findFocus findFocus()} method in {@link android.support.v4.view.accessibility.AccessibilityNodeProviderCompat} and the {@link android.support.v4.view.accessibility.AccessibilityNodeInfoCompat#getLiveRegion getLiveRegion()} method in {@link android.support.v4.view.accessibility.AccessibilityNodeInfoCompat}.
  • Added helper class {@link android.support.v4.view.ScaleGestureDetectorCompat} for accessing new scaling gesture methods.
  • Fixed problem with {@link android.support.v4.app.ActionBarDrawerToggle} in right-to-left language displays.
  • Modified {@link android.support.v4.widget.AutoScrollHelper} option to consume touch events or allow them to be passed through to other views.
Changes for v7 mediarouter library:
  • Added support for media playback queuing, setting HTTP header values and media playback duration.
  • Added explicit start, get, and end session actions for explicitly managing media playback sessions with media router.

Android Support Library, revision 18 (July 2013)

Changes for v4 support library:
  • User interface
    • Added {@link android.support.v4.text.BidiFormatter} for handling text strings that combine right to left and left to right-formatted text.
    • Modified {@link android.support.v4.view.ViewPager} to better handle cases where the pager has a measured width of zero in the initial layout processing.
    • Modified {@link android.support.v4.widget.DrawerLayout} and {@link android.support.v4.widget.SlidingPaneLayout} to not throw exceptions for measurement while the project code is being edited.
  • Accessibility
    • Added {@link android.support.v4.widget.ExploreByTouchHelper} to simplify the implementation of accessibility for custom views.
    • Fixed a problem with {@link android.support.v4.view.ViewPager} incorrectly populating {@link android.support.v4.view.accessibility.AccessibilityEventCompat#TYPE_VIEW_SCROLLED TYPE_VIEW_SCROLLED} accessibility events.
    • Fixed a null pointer exception in {@link android.support.v4.view.ViewPager} when populating an accessibility event.
    • Simplified {@link android.support.v4.view.accessibility.AccessibilityNodeInfoCompat} by changing {@link java.lang.CharSequence} inputs to {@link java.lang.String} objects.
    • Deprecated an {@link android.support.v4.view.accessibility.AccessibilityRecordCompat} constructor that used an {@link java.lang.Object} as input.
  • Media
    • Added {@link android.support.v4.media.TransportMediator} helper class to manage media transport control, such as play, pause, skip and other media actions.
    • Added {@link android.support.v4.hardware.display.DisplayManagerCompat} for managing display output to one or more device displays.
  • Other changes
    • Added {@link android.support.v4.content.WakefulBroadcastReceiver} helper class for implementing a common pattern of detecting a device wakeup event and passing work off to a {@link android.app.Service} while ensuring that the device does not go back to sleep before the handoff is complete.
    • Added two new APIs, {@link android.support.v4.content.AsyncTaskLoader#commitContentChanged commitContentChanged()} and {@link android.support.v4.content.AsyncTaskLoader#rollbackContentChanged rollbackContentChanged()}, to {@link android.support.v4.content.AsyncTaskLoader} to help deal with background updates for data changes that are subsequently canceled.
New v7 appcompat library:
  • Added {@link android.support.v7.app.ActionBar} to allow implementation of the action bar user interface design pattern back to Android 2.1 (API level 7) and higher. Use of this class requires that you implement your activity by extending the new {@link android.support.v7.app.ActionBarActivity} class.
New v7 mediarouter library:

Added a new mediarouter library that provides support for the Google Cast developer preview. The v7 mediarouter library APIs provide a means of controlling the routing of media channels and streams from the current device to external screens, speakers, and other destination devices, with compatibility back to Android 2.1 (API level 7). See V7 mediarouter library for more information.

The v7 mediarouter library APIs introduced in Support Library r18 are subject to change in later revisions of the Support Library. At this time, we recommend using the library only in connection with the Google Cast developer preview.

Android Support Library, revision 13 (May 2013)

Changes for v4 support library:
  • Added {@link android.support.v4.widget.DrawerLayout} for creating a Navigation Drawer that can be pulled in from the edge of a window.
  • Added {@link android.support.v4.widget.SlidingPaneLayout} widget for creating linked summary and detail views that appropriately adapt to various screen sizes.
  • Added {@link android.support.v4.app.ActionBarDrawerToggle} as a way to tie together the functions of {@link android.support.v4.widget.DrawerLayout} and {@link android.app.ActionBar}.
  • Added {@link android.support.v4.widget.ViewDragHelper} as a new common component for dragging views within a parent view.
  • Added {@link android.support.v4.widget.ScrollerCompat} to provide {@link android.widget.Scroller} and {@link android.widget.OverScroller} compatibility support.
  • Added {@link android.support.v4.content.FileProvider} to allow sharing of private files between applications.
  • Updated {@link android.support.v4.view.ViewPager} to throw an exception if the associated {@link android.support.v4.view.PagerAdapter} class is modified without a call to {@link android.support.v4.view.PagerAdapter#notifyDataSetChanged notifyDataSetChanged()}.
  • Fixed an issue with {@link android.support.v4.view.ViewPager} children drawing sort order.
  • Fixed {@link android.support.v4.view.GestureDetectorCompat} to dispatch missing {@link android.view.GestureDetector.SimpleOnGestureListener#onSingleTapConfirmed} calls between tap timeout and long press events.
New v7 gridlayout library:
  • Added {@link android.support.v7.widget.GridLayout} to provide support for the {@link android.widget.GridLayout} layout object.
  • Added {@link android.support.v7.widget.Space} which can be used to create blank areas within a {@link android.support.v7.widget.GridLayout} layout object.

Android Support Library, revision 12 (February 2013)

Changes for v4 support library:
  • Improved interaction behavior for {@link android.support.v4.view.ViewPager}.
  • Fixed a bug that could cause {@link android.support.v4.view.ViewPager} to select the wrong page.
  • Fixed use of {@link android.support.v4.view.ViewPager#removeView removeView()} method during layout for {@link android.support.v4.view.ViewPager}.
  • Fixed issue with {@link android.support.v4.widget.SearchViewCompat} where using the back button to dismiss does not clear the search text. This fix only applies to host API levels 14 and higher.

Android Support Library, revision 11 (November 2012)

Changes for v4 support library:
  • User Interface
    • Added support for nested {@link android.support.v4.app.Fragment} classes.
    • Added improvements to {@link android.support.v4.app.FragmentManager} debugging.
    • Fixed problem in {@link android.support.v4.app.FragmentTabHost} where fragment and tab interaction could result in a {@link android.widget.ListView} state loss.
    • Fixed issue with user-visible hint in {@link android.support.v4.app.FragmentStatePagerAdapter}.
    • Added {@link android.support.v4.view.ViewPager.PageTransformer PageTransformer} interface to {@link android.support.v4.view.ViewPager} to allow applications to supply a custom transition behavior for scrolling.
    • Added new features and fixes to {@link android.support.v4.app.TaskStackBuilder} from current release.
    • Fixed {@link android.support.v4.view.PagerTitleStrip} to correctly track the {@link android.support.v4.view.PagerAdapter} currently in use.
    • Fixed display flickering, positioning, and text clipping problems with {@link android.support.v4.view.PagerTitleStrip}.
    • Fixed {@link android.support.v4.view.PagerTabStrip} to properly respect padding when drawing an underline.
  • Accessibility
    • Added support for new accessibility gesture and touch event types in {@link android.support.v4.view.accessibility.AccessibilityEventCompat}.
    • Added support for new accessibility APIs in {@link android.support.v4.view.ViewCompat}.
    • Added support for {@link android.support.v4.view.ViewCompat#performAccessibilityAction performAccessibilityAction()} method to {@link android.support.v4.view.ViewCompat}.
  • Added support for gestures with {@link android.support.v4.view.GestureDetectorCompat}.
  • Added support for performing atomic operations on files using a new {@link android.support.v4.util.AtomicFile} class.
  • Added support for the full set of {@code make} methods in {@link android.support.v4.content.IntentCompat}.
  • Added {@link android.support.v4.util.LruCache#trimToSize trimToSize()} method in {@link android.support.v4.util.LruCache} utility class.
  • Updated {@link android.support.v4.net.ConnectivityManagerCompat} to get NetworkInfo from a {@link android.net.ConnectivityManager#CONNECTIVITY_ACTION} broadcast.

Android Support Library, revision 10 (August 2012)

Changes for v4 support library:
  • Added support for notification features introduced in Android 4.1 (API level 16) with additions to {@link android.support.v4.app.NotificationCompat}.

Android Support Library, revision 9 (June 2012)

Changes for v4 support library:
  • User Interface Support
    • Added {@link android.support.v4.view.PagerTabStrip} support, providing enhanced functionality beyond {@link android.support.v4.view.PagerTitleStrip}.
    • Fixed various bugs for {@link android.support.v4.view.PagerTitleStrip} and {@link android.support.v4.view.PagerTabStrip}, including {@link android.widget.TextView#setAllCaps setAllCaps} option, title alignment, appearance improvements, minimum width constraints and touch navigation issues.
    • Added support for {@link android.support.v4.view.ViewPager} page gutters, which helps the {@link android.support.v4.view.ViewPager} class provide paging support for content with a large horizontal scroll range, such as a map.
    • Fixed numerous bugs for {@link android.support.v4.view.ViewPager}, including size and data set change problems, page positioning, user interaction, scroll tracking and keyboard navigation problems.
    • Fixed many bugs for {@link android.support.v4.app.Fragment}, including proper handling of {@link android.support.v4.app.Fragment#onActivityResult onActivityResult()} when the target fragment no longer exists, dispatching selection events to invisible fragments, improved {@link android.support.v4.app.FragmentTransaction#replace FragmentTransaction.replace()} behavior and added better state handling for fragments being moved out of view.
    • Added support for the {@link android.support.v4.view.ViewCompat postOnAnimation()} method in {@link android.support.v4.view.ViewCompat}.
    • Updated {@link android.support.v4.app.NavUtils} to use Android 4.1 (API level 16) Up navigation functionality when available.
  • Accessibility
    • Updated accessibility support classes, including {@link android.support.v4.view.accessibility.AccessibilityNodeInfoCompat}, to follow fixes made in Android 4.1 (API level 16).
    • Added support for accessibility scroll actions in {@link android.support.v4.view.ViewPager}.
  • General improvements
    • Updated {@link android.support.v4.app.TaskStackBuilder} to reflect API changes in Android 4.1 (API level 16).
    • Enhanced {@link android.support.v4.app.TaskStackBuilder} to allow it to be used from a Service.
    • Added support for {@link android.support.v4.content.IntentCompat EXTRA_HTML_TEXT} to {@link android.support.v4.app.ShareCompat}.
    • Updated {@link android.support.v4.app.NotificationCompat.Builder} to support the {@link android.support.v4.app.NotificationCompat.Builder#setNumber setNumber()} method.
    • Added support in {@link android.support.v4.net.ConnectivityManagerCompat} for the {@link android.support.v4.net.ConnectivityManagerCompat#isActiveNetworkMetered isActiveNetworkMetered()} method.

Android Support Library, revision 8 (April 2012)

Changes for v4 support library:
  • Fixed intent flags for {@link android.app.PendingIntent} objects generated by {@link android.support.v4.app.TaskStackBuilder}.
  • Removed unused attributes from the gridlayout library projects to make sure the library can be built with API level 7 and higher.
  • Added {@code .classpath} and {@code .project} files for the gridlayout library project.

Android Support Library, revision 7 (March 2012)

Changes for v4 support library:
  • Added {@link android.support.v4.app.ShareCompat}, which provides helper classes for sending and receiving content for social sharing applications, including new metadata for attributing shared data to the source app. This class also provides compatible integration with the new {@link android.widget.ShareActionProvider} in Android 4.0.
  • Added {@link android.support.v4.app.NavUtils} and {@link android.support.v4.app.TaskStackBuilder} to provide support for implementing the Android Design guidelines for navigation. These additions include a way to implement the action bar's Up button across versions. For an example implementation of this pattern, see the AppNavigation sample in ({@code <sdk>/samples/<platform>/AppNavigation}).
  • Added {@link android.support.v4.app.NotificationCompat.Builder} to provide a compatibility implementation of Android 3.0's {@link android.app.Notification.Builder} helper class for creating standardized system notifications.

Android Support Library, revision 6 (December 2011)

Note: Reference for support library APIs are now available with the framework references, for example: {@link android.support.v4.app}.

Changes for v4 support library:
  • Changes to ViewPager:
    • Added extra decorative view support for {@link android.support.v4.view.ViewPager}. Decorative views may be supplied as child views of a pager in XML layout.
    • Added {@link android.support.v4.view.PagerAdapter#getPageTitle PagerAdapter.getPageTitle()} to supply title strings for pages, which defaults to no title for each page.
    • Added {@link android.support.v4.view.PagerTitleStrip}, a non-interactive title strip, that can be added as a child of ViewPager. Developers can supply text appearance and color, as well as layout sizing and gravity information.
    • Updated {@link android.support.v4.view.PagerAdapter} methods to take ViewGroup objects, rather than View to avoid class casting in adapter implementations.
    • Updated {@link android.support.v4.view.ViewPager} to use Launcher-style fling behavior.
    • Bug fixes for user interface interaction and test automation.
  • Support for Fragments:
    • Changed {@code setStartDeferred()} method to {@link android.support.v4.app.Fragment#setUserVisibleHint}.
    • Added deferred start for off-screen pages to improve performance.
  • Support for Accessiblity APIs:
    • Updated {@link android.support.v4.view.AccessibilityDelegateCompat} methods to return empty lists instead of null.
    • Added new APIs needed by the v4 samples.

Android Support Library, revision 5 (December 2011)

Changes for v4 support library:
  • Support for Accessiblity APIs:
    • Added {@link android.support.v4.view.AccessibilityDelegateCompat} to support {@link android.view.View.AccessibilityDelegate}.
    • Added {@link android.support.v4.view.accessibility.AccessibilityEventCompat} to support {@link android.view.accessibility.AccessibilityEvent}.
    • Added {@link android.support.v4.view.accessibility.AccessibilityManagerCompat} to support {@link android.view.accessibility.AccessibilityManager}.
    • Added {@link android.support.v4.view.accessibility.AccessibilityNodeInfoCompat} to support {@link android.view.accessibility.AccessibilityNodeInfo}.
    • Added {@link android.support.v4.view.accessibility.AccessibilityRecordCompat} to support {@link android.view.accessibility.AccessibilityRecord}.
    • Added {@link android.support.v4.accessibilityservice.AccessibilityServiceInfoCompat} to support {@link android.accessibilityservice.AccessibilityServiceInfo}.
    • Added {@link android.support.v4.view.ViewGroupCompat} to support accessibility features in {@link android.view.ViewGroup}.
    • Modified {@link android.support.v4.view.ViewCompat} to support accessibility features in {@link android.view.View}.
  • Changes to ViewPager:
    • Added support for margins between pages. An optional {@link android.graphics.drawable.Drawable} can be provided to fill the margins.
    • Added support for {@link android.widget.EdgeEffect}.
    • Added support for keyboard navigation
    • Added support to control how many pages are kept to either side of the current page.
    • Improved touch physics.
    • Bug fixes for user interface behavior.

Android Support Library, revision 4 (October 2011)

Changes for v4 support library:
  • Added EdgeEffectCompat to support {@link android.widget.EdgeEffect}.
  • Added LocalBroadcastManager to allow applications to easily register for and receive intents within a single application without broadcasting them globally.
  • Added support in ViewCompat to check for and set overscroll modes for {@link android.view.View}s on Android 2.3 and later.
  • Changes to Fragment APIs:
    • Added new APIs to control the visibility of new menus.
    • Added custom animation APIs.
    • Added APIs in FragmentActivity to retain custom, non-configuration instance data.
    • Various bug fixes.
  • Fixed a {@link android.content.Loader} bug that caused issues in canceling {@link android.os.AsyncTask}s when running on Froyo and older versions of the platform. The support code now uses its own version of {@link android.os.AsyncTask} to keep the same behavior on all platform versions.

Android Support Library, revision 3 (July 2011)

Changes for v4 support library:
  • Adds support for {@link android.app.Fragment.SavedState}
  • Adds {@code MotionEventCompat} to support newer {@link android.view.MotionEvent} APIs
  • Adds {@code VelocityTrackerCompat} to support a newer {@link android.view.VelocityTracker} APIs
  • Adds {@code ViewConfigurationCompat} to support a newer {@link android.view.ViewConfiguration} APIs
  • All new APIs (available only in the support library) that allow you to create UIs with horizontal paging, allowing users to swipe left and right between content views. Classes to support this include:
    • {@code ViewPager}: A {@link android.view.ViewGroup} that manages the layout for the child views, which the user can swipe between.
    • {@code PagerAdapter}: An adapter that populates the {@code ViewPager} with the views that represent each page.
    • {@code FragmentPagerAdapter}: An extension of {@code PagerAdapter} for flipping between fragments.
    • {@code FragmentStatePagerAdapter}: An extension of {@code PagerAdapter} for flipping between fragments that uses the library's support for {@link android.app.Fragment.SavedState}.
New v13 support library:
  • Includes the {@code FragmentPagerAdapter} and {@code FragmentStatePagerAdapter} to support the horizontal paging.

    These are exactly the same as the APIs added to the v4 support library, but rely on other platform components in Android 3.2. Use this library instead of v4 if you're developing for Android 3.2 and higher (all other APIs in the v4 library are already available with API level 13).

Android Support Library, revision 2 (May 2011)

Changes for v4 library:
  • Support for fragment animations
  • Fix {@link android.support.v4.app.Fragment#onActivityResult Fragment.onActivityResult()} bug

Android Support Library, revision 1 (March 2011)

Initial release with the v4 library.