The Android Support Library package is a set of code libraries that provide
backward-compatible versions of Android framework APIs as well as features that are only available
through the library APIs. Each Support Library is backward-compatible to a specific Android API
level. This design means that your applications can use the libraries' features and still be
compatible with devices running Android 1.6 (API level 4) and up.
This guide provides information about what features are enabled by the Support Libraries,
how to use them in your development environment and information about library releases.
Including the Support Libraries in your Android project is considered a best practice for
application developers, depending on the range of platform versions your app is targeting
and the APIs that it uses. Using the features the libraries provide can help you improve the look of your
application, increase performance and broaden the reach of your application to more users.
If you use the Android
code template tools, you will notice that
all the Android application templates include one or more of the Support Libraries by default.
The Support Libraries each target a base Android API level and each provides a different set
of features. In order to effectively use the libraries, it is important to consider what features
you want to support and understand what features are supported by each library at what Android
API level. To get started, review the
Support Library Features guide.
After that, go to the
Support Library Setup topic to
learn how to incorporate the Support Libraries into your application. For more details
about Support Library APIs, see the {@link android.support.v4.app android.support}
packages in the API reference.
This section provides details about the Support Library package releases.
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:
-
- 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.mediarouter.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:
-
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.