| page.title=Support Library |
| |
| @jd:body |
| |
| <div id="qv-wrapper"> |
| <div id="qv"> |
| |
| <h2>In this document</h2> |
| <ol> |
| <li><a href="#overview">Overview</a></li> |
| <li><a href="#revisions">Revisions</a></li> |
| </ol> |
| |
| <h2>See also</h2> |
| <ol> |
| <li><a href="{@docRoot}tools/support-library/features.html"> |
| Support Library Features</a></li> |
| <li><a href="{@docRoot}tools/support-library/setup.html"> |
| Support Library Setup </a></li> |
| </ol> |
| |
| </div> |
| </div> |
| |
| <p>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.</p> |
| |
| <p>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.</p> |
| |
| |
| <h2 id="overview">Overview</h2> |
| |
| <p>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 |
| <a href="{@docRoot}tools/projects/templates.html">code template</a> tools, you will notice that |
| all the Android application templates include one or more of the Support Libraries by default.</p> |
| |
| <p>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 |
| <a href="{@docRoot}tools/support-library/features.html">Support Library Features</a> guide. |
| After that, go to the |
| <a href="{@docRoot}tools/support-library/setup.html">Support Library Setup</a> 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.</p> |
| |
| |
| <h2 id="revisions">Revisions</h2> |
| |
| <p>This section provides details about the Support Library package releases.</p> |
| |
| |
| <div class="toggle-content opened"> |
| <p id="rev21"><a href="#" onclick="return toggleContent(this)"> |
| <img src="{@docRoot}assets/images/triangle-opened.png" class="toggle-content-img" alt="" |
| />Android Support Library, revision 21.0.3</a> <em>(December 2014)</em> |
| </p> |
| <div class="toggle-content-toggleme"> |
| <dl> |
| <dt>Changes for <a href="features.html#v4">v4 support library:</a></dt> |
| <dd> |
| <ul> |
| <li>Added several {@link android.support.v4.app.NotificationCompat.WearableExtender} |
| methods to improve the display of barcodes in notifications on wearable devices. |
| <ul> |
| <li>{@link android.support.v4.app.NotificationCompat.WearableExtender#getHintScreenTimeout getHintScreenTimeout()}</li> |
| <li>{@link android.support.v4.app.NotificationCompat.WearableExtender#setHintScreenTimeout setHintScreenTimeout()}</li> |
| <li>{@link android.support.v4.app.NotificationCompat.WearableExtender#getHintAvoidBackgroundClipping getHintAvoidBackgroundClipping()}</li> |
| <li>{@link android.support.v4.app.NotificationCompat.WearableExtender#setHintAvoidBackgroundClipping setHintAvoidBackgroundClipping()}</li> |
| </ul> |
| </li> |
| </ul> |
| </dd> |
| |
| </div> |
| </div> |
| |
| |
| |
| <div class="toggle-content closed"> |
| <p id="rev21"><a href="#" onclick="return toggleContent(this)"> |
| <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" |
| />Android Support Library, revision 21.0.2</a> <em>(November 2014)</em> |
| </p> |
| <div class="toggle-content-toggleme"> |
| <dl> |
| <dt>Changes for <a href="features.html#v4">v4 support library:</a></dt> |
| <dd> |
| <ul> |
| <li>Added {@link android.support.v4.app.NotificationCompat.CarExtender} |
| class to support Android Auto extensions to notifications.</li> |
| </ul> |
| </dd> |
| <dt>Changes for <a href="features.html#v7-appcompat">v7 appcompat library</a>:</dt> |
| <dd> |
| <ul> |
| <li>Added the {@link android.support.v7.widget.PopupMenu} constructor to support new popup |
| menus.</li> |
| <li>Added support for a Collapse icon description in the {@link android.support.v7.widget.Toolbar} |
| class.</li> |
| <li>Updated the {@link android.support.v7.widget.SearchView} widget to support displaying |
| the {@link android.support.v7.mediarouter.R.attr#commitIcon}. </li> |
| <li>Removed the <code>buttonGravity</code> attribute from the |
| {@link android.support.v7.widget.Toolbar} class. </li> |
| </ul> |
| </dd> |
| <dt>Changes for <a href="features.html#v7-cardview">v7 cardview library</a>:</dt> |
| <dd> |
| <ul> |
| <li>Added {@link android.support.v7.widget.CardView#setCardBackgroundColor} API to |
| support changing the background color of the {@link android.support.v7.widget.CardView}.</li> |
| <li>Changed the {@link android.support.v7.widget.CardView} to more accurately report its |
| opacity value as {@link android.graphics.PixelFormat#TRANSLUCENT}.</li> |
| </ul> |
| </dd> |
| <dt>Changes for <a href="features.html#v7-recyclerview">v7 recyclerview |
| library</a>:</dt> |
| <dd> |
| <ul> |
| <li>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.</li> |
| </ul> |
| </dd> |
| <dt>Changes for <a href="features.html#v17-leanback">v17 leanback library</a>:</dt> |
| <dd> |
| <ul> |
| <li>Added support to generate v4 code fragments. </li> |
| <li>Changed the secondary text color on {@link android.support.v7.widget.CardView}. </li> |
| </ul> |
| </dd> |
| </dl> |
| </div> |
| </div> |
| |
| |
| |
| <div class="toggle-content closed"> |
| <p id="rev21"><a href="#" onclick="return toggleContent(this)"> |
| <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" |
| />Android Support Library, revision 21.0.1</a> <em>(November 2014)</em> |
| </p> |
| <div class="toggle-content-toggleme"> |
| <dl> |
| <dt>Added <a href="{@docRoot}tools/support-library/features.html#multidex"> |
| multidex support library</a> to support multiple |
| <a href="https://source.android.com/devices/tech/dalvik/">Dalvik</a> Executable (DEX) files |
| for multi-dex file support prior to Android 5.0. </li> |
| </dt> |
| </dl> |
| </div> |
| </div> |
| |
| |
| |
| |
| <div class="toggle-content closed"> |
| <p id="rev21"><a href="#" onclick="return toggleContent(this)"> |
| <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" |
| />Android Support Library, revision 21</a> <em>(October 2014)</em> |
| </p> |
| <div class="toggle-content-toggleme"> |
| <dl> |
| <dt>Changes for <a href="features.html#v4">v4 support library:</a></dt> |
| <dd> |
| <ul> |
| <li>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. |
| </li> |
| <li>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.</li> |
| </ul> |
| </dd> |
| <dt>Changes for <a href="features.html#v7-appcompat">v7 appcompat |
| library</a>:</dt> |
| <dd> |
| <ul> |
| <li>Added support for <a href="{@docRoot}design/material/">material |
| design</a> user interfaces.</li> |
| <li>Added {@link android.support.v7.widget.Toolbar}, which generalizes |
| the functionality of {@link android.support.v7.app.ActionBar} for |
| use within app layouts.</li> |
| <li>Updated {@link android.support.v7.app.ActionBarDrawerToggle}, |
| which contains the menu-to-arrow animation</li> |
| <li>Updated common user interface widgets to allow tinting via theme |
| attributes when running on pre-Android 5.0 devices</li> |
| <li>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).</li> |
| </ul> |
| </dd> |
| <dt>New <a href="features.html#v7-cardview">v7 cardview library</a>:</dt> |
| <dd> |
| <ul> |
| <li>Added the {@link android.support.v7.widget.CardView} widget, which |
| provides a material design-compatible implementation for displaying |
| data items.</li> |
| </ul> |
| </dd> |
| <dt>New <a href="features.html#v7-recyclerview">v7 recyclerview |
| library</a>:</dt> |
| <dd> |
| <ul> |
| <li>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.</li> |
| </ul> |
| </dd> |
| <dt>New <a href="features.html#v7-palette">v7 palette library</a>:</dt> |
| <dd> |
| <ul> |
| <li>Added {@link android.support.v7.graphics.Palette} class, |
| which lets you extract prominent colors from an image.</li> |
| </ul> |
| </dd> |
| <dt>New <a href="features.html#v17-leanback">v17 leanback library</a>:</dt> |
| <dd> |
| <ul> |
| <li>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 <a href="{@docRoot}training/tv/playback/index.html">Building TV |
| Playback Apps</a>.</li> |
| </ul> |
| </dd> |
| </dl> |
| </div> |
| </div> |
| |
| <div class="toggle-content closed"> |
| <p><a href="#" onclick="return toggleContent(this)"> |
| <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" |
| />Android Support Library, revision 20</a> <em>(July 2014)</em> |
| </p> |
| <div class="toggle-content-toggleme"> |
| <dl> |
| <dt>Changes for v4 support library:</dt> |
| <dd> |
| <ul> |
| <li>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.</li> |
| <li>Added {@link android.support.v4.app.NotificationCompat.Action.WearableExtender}, |
| which allows actions to be added on wearable notifications.</li> |
| <li>Added {@link android.support.v4.app.NotificationManagerCompat}, which allows you |
| to issue notifications that properly support wearable features.</li> |
| <li>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.</li> |
| <li>Improved the handling of touch feedback in |
| {@link android.support.v4.widget.SwipeRefreshLayout}.</li> |
| </ul> |
| </dd> |
| </dl> |
| </div> |
| </div> |
| |
| <div class="toggle-content closed"> |
| <p><a href="#" onclick="return toggleContent(this)"> |
| <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" |
| />Android Support Library, revision 19.1.0</a> <em>(March 2014)</em> |
| </p> |
| <div class="toggle-content-toggleme"> |
| <dl> |
| <dt>Changes for v4 support library:</dt> |
| <dd> |
| <ul> |
| <li>Added the {@link android.support.v4.widget.SwipeRefreshLayout} class, |
| which enables users to refresh the contents of a view with a vertical |
| swipe gesture.</li> |
| <li>Fixed accessibility issues with navigation drawers.</li> |
| </ul> |
| </dd> |
| |
| <dt>Changes for v7 appcompat library:</dt> |
| <dd> |
| <ul> |
| <li>Fixed background issues with the action bar.</li> |
| </ul> |
| </dd> |
| </dl> |
| </div> |
| </div> |
| |
| <div class="toggle-content closed"> |
| <p><a href="#" onclick="return toggleContent(this)"> |
| <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" |
| />Android Support Library, revision 19.0.1</a> <em>(December 2013)</em> |
| </p> |
| <div class="toggle-content-toggleme"> |
| <dl> |
| <dt>Changes for v4 support library:</dt> |
| <dd> |
| <ul> |
| <li>Improved {@link android.support.v4.print.PrintHelper} by adding asynchronous |
| handling of printing.</li> |
| <li>Fixed the {@link android.support.v4.widget.DrawerLayout} class approximation of |
| the {@link android.view.View#addChildrenForAccessibility addChildrenForAccessibility()} |
| method.</li> |
| <li>Fixed slide drawable mirroring in {@link |
| android.support.v4.app.ActionBarDrawerToggle}.</li> |
| <li>Fixed off-by-one issue when removing an item from a collection iterator.</li> |
| </ul> |
| </dd> |
| |
| <dt>Changes for v7 mediarouter library:</dt> |
| <dd> |
| <ul> |
| <li>Improved route identification by using full component name in the {@link |
| android.support.v7.media.MediaRouteProvider.ProviderMetadata}.</li> |
| <li>Updated {@link android.support.v7.app.MediaRouteChooserDialog} to hide disabled |
| routes.</li> |
| </ul> |
| </dd> |
| |
| <dt>Changes for v8 renderscript library:</dt> |
| <dd> |
| <ul> |
| <li>Added error propagation for the RenderScript thunking layer.</li> |
| </ul> |
| </dd> |
| |
| </dl> |
| </div> |
| </div> |
| |
| |
| <div class="toggle-content closed"> |
| <p><a href="#" onclick="return toggleContent(this)"> |
| <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" |
| />Android Support Library, revision 19</a> <em>(October 2013)</em> |
| </p> |
| <div class="toggle-content-toggleme"> |
| <dl> |
| <dt>Changes for v4 support library:</dt> |
| <dd> |
| <ul> |
| <li>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.</li> |
| <li>Added {@link android.support.v4.print.PrintHelper} class that works with the |
| Print APIs to print images with a minimum of code.</li> |
| <li>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}.</li> |
| <li>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}.</li> |
| <li>Added helper class {@link android.support.v4.view.ScaleGestureDetectorCompat} for |
| accessing new scaling gesture methods.</li> |
| <li>Fixed problem with {@link android.support.v4.app.ActionBarDrawerToggle} in |
| right-to-left language displays.</li> |
| <li>Modified {@link android.support.v4.widget.AutoScrollHelper} option to consume |
| touch events or allow them to be passed through to other views.</li> |
| </ul> |
| </dd> |
| |
| <dt>Changes for v7 mediarouter library:</dt> |
| <dd> |
| <ul> |
| <li>Added support for media playback queuing, setting HTTP header values and media |
| playback duration.</li> |
| <li>Added explicit start, get, and end session actions for explicitly managing media |
| playback sessions with media router.</li> |
| </ul> |
| </dd> |
| </dl> |
| </div> |
| </div> |
| |
| <div class="toggle-content closed"> |
| <p><a href="#" onclick="return toggleContent(this)"> |
| <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" |
| />Android Support Library, revision 18</a> <em>(July 2013)</em> |
| </p> |
| <div class="toggle-content-toggleme"> |
| <dl> |
| <dt>Changes for v4 support library:</dt> |
| <dd> |
| <ul> |
| <li>User interface |
| <ul> |
| <li>Added {@link android.support.v4.text.BidiFormatter} for handling |
| text strings that combine right to left and left to right-formatted text.</li> |
| <li>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.</li> |
| <li>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.</li> |
| </ul> |
| </li> |
| |
| <li>Accessibility |
| <ul> |
| <li>Added {@link android.support.v4.widget.ExploreByTouchHelper} to simplify the |
| implementation of accessibility for custom views.</li> |
| <li>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.</li> |
| <li>Fixed a null pointer exception in {@link android.support.v4.view.ViewPager} when |
| populating an accessibility event.</li> |
| <li>Simplified {@link android.support.v4.view.accessibility.AccessibilityNodeInfoCompat} |
| by changing {@link java.lang.CharSequence} inputs to {@link java.lang.String} objects. |
| </li> |
| <li>Deprecated an {@link android.support.v4.view.accessibility.AccessibilityRecordCompat} |
| constructor that used an {@link java.lang.Object} as input.</li> |
| </ul> |
| </li> |
| |
| <li>Media |
| <ul> |
| <li>Added {@link android.support.v4.media.TransportMediator} helper class to manage |
| media transport control, such as play, pause, skip and other media actions.</li> |
| <li>Added {@link android.support.v4.hardware.display.DisplayManagerCompat} for managing |
| display output to one or more device displays.</li> |
| </ul> |
| </li> |
| |
| <li>Other changes |
| <ul> |
| <li>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.</li> |
| <li>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. |
| </li> |
| </ul> |
| </li> |
| </ul> |
| </dd> |
| |
| <dt>New v7 appcompat library:</dt> |
| <dd> |
| <ul> |
| <li>Added {@link android.support.v7.app.ActionBar} to allow implementation of the |
| action bar user interface <a href="{@docRoot}design/patterns/actionbar.html">design |
| pattern</a> 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.</li> |
| </ul> |
| </dd> |
| |
| <dt>New v7 mediarouter library:</dt> |
| <dd> |
| <p>Added a new mediarouter library that provides support for the <a |
| href="https://developers.google.com/cast/">Google Cast developer preview</a>. |
| 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 <a |
| href="{@docRoot}tools/support-library/features.html#v7-mediarouter">V7 |
| mediarouter library</a> for more information. </p> |
| |
| <p class="caution">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 <a href="https://developers.google.com/cast/">Google Cast |
| developer preview</a>.</p> |
| </dd> |
| |
| </dl> |
| </div> |
| </div> |
| |
| |
| <div class="toggle-content closed"> |
| <p><a href="#" onclick="return toggleContent(this)"> |
| <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" |
| />Android Support Library, revision 13</a> <em>(May 2013)</em> |
| </p> |
| <div class="toggle-content-toggleme"> |
| <dl> |
| <dt>Changes for v4 support library:</dt> |
| <dd> |
| <ul> |
| <li>Added {@link android.support.v4.widget.DrawerLayout} for creating a |
| <a href="{@docRoot}training/implementing-navigation/nav-drawer.html">Navigation |
| Drawer</a> that can be pulled in from the edge of a window.</li> |
| <li>Added {@link android.support.v4.widget.SlidingPaneLayout} widget for creating linked |
| summary and detail views that appropriately adapt to various screen sizes.</li> |
| <li>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}.</li> |
| <li>Added {@link android.support.v4.widget.ViewDragHelper} as a new common component |
| for dragging views within a parent view.</li> |
| <li>Added {@link android.support.v4.widget.ScrollerCompat} to provide {@link |
| android.widget.Scroller} and {@link android.widget.OverScroller} compatibility support. |
| </li> |
| <li>Added {@link android.support.v4.content.FileProvider} to allow sharing of private |
| files between applications.</li> |
| <li>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()}. |
| </li> |
| <li>Fixed an issue with {@link android.support.v4.view.ViewPager} children drawing sort |
| order.</li> |
| <li>Fixed {@link android.support.v4.view.GestureDetectorCompat} to dispatch missing |
| {@link android.view.GestureDetector.SimpleOnGestureListener#onSingleTapConfirmed} calls |
| between tap timeout and long press events.</li> |
| </ul> |
| </dd> |
| |
| <dt>New v7 gridlayout library:</dt> |
| <dd> |
| <ul> |
| <li>Added {@link android.support.v7.widget.GridLayout} to provide support for the |
| {@link android.widget.GridLayout} layout object.</li> |
| <li>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.</li> |
| </ul> |
| </dl> |
| </div> |
| </div> |
| |
| |
| <div class="toggle-content closed"> |
| <p><a href="#" onclick="return toggleContent(this)"> |
| <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" |
| />Android Support Library, revision 12</a> <em>(February 2013)</em> |
| </p> |
| <div class="toggle-content-toggleme"> |
| <dl> |
| <dt>Changes for v4 support library:</dt> |
| <dd> |
| <ul> |
| <li>Improved interaction behavior for {@link android.support.v4.view.ViewPager}.</li> |
| <li>Fixed a bug that could cause {@link android.support.v4.view.ViewPager} to select the |
| wrong page.</li> |
| <li>Fixed use of {@link android.support.v4.view.ViewPager#removeView removeView()} method |
| during layout for {@link android.support.v4.view.ViewPager}.</li> |
| <li>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.</li> |
| </ul> |
| </dd> |
| </dl> |
| </div> |
| </div> |
| |
| |
| <div class="toggle-content closed"> |
| <p><a href="#" onclick="return toggleContent(this)"> |
| <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" |
| />Android Support Library, revision 11</a> <em>(November 2012)</em> |
| </p> |
| <div class="toggle-content-toggleme"> |
| <dl> |
| <dt>Changes for v4 support library:</dt> |
| <dd> |
| <ul> |
| <li>User Interface |
| <ul> |
| <li>Added support for nested {@link android.support.v4.app.Fragment} classes.</li> |
| <li>Added improvements to {@link android.support.v4.app.FragmentManager} debugging. |
| </li> |
| <li>Fixed problem in {@link android.support.v4.app.FragmentTabHost} where fragment |
| and tab interaction could result in a {@link android.widget.ListView} state loss. |
| </li> |
| <li>Fixed issue with user-visible hint in |
| {@link android.support.v4.app.FragmentStatePagerAdapter}.</li> |
| <li>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.</li> |
| <li>Added new features and fixes to {@link android.support.v4.app.TaskStackBuilder} |
| from current release.</li> |
| <li>Fixed {@link android.support.v4.view.PagerTitleStrip} to correctly track the |
| {@link android.support.v4.view.PagerAdapter} currently in use.</li> |
| <li>Fixed display flickering, positioning, and text clipping problems with |
| {@link android.support.v4.view.PagerTitleStrip}.</li> |
| <li>Fixed {@link android.support.v4.view.PagerTabStrip} to properly respect padding |
| when drawing an underline.</li> |
| </ul> |
| </li> |
| <li>Accessibility |
| <ul> |
| <li>Added support for new accessibility gesture and touch event types in |
| {@link android.support.v4.view.accessibility.AccessibilityEventCompat}.</li> |
| <li>Added support for new accessibility APIs in |
| {@link android.support.v4.view.ViewCompat}.</li> |
| <li>Added support for {@link android.support.v4.view.ViewCompat#performAccessibilityAction |
| performAccessibilityAction()} method to {@link android.support.v4.view.ViewCompat}. |
| </li> |
| </ul> |
| </li> |
| <li>Added support for gestures with {@link android.support.v4.view.GestureDetectorCompat}. |
| </li> |
| <li>Added support for performing atomic operations on files using a new |
| {@link android.support.v4.util.AtomicFile} class.</li> |
| <li>Added support for the full set of {@code make} methods in |
| {@link android.support.v4.content.IntentCompat}.</li> |
| <li>Added {@link android.support.v4.util.LruCache#trimToSize trimToSize()} method in |
| {@link android.support.v4.util.LruCache} utility class.</li> |
| <li>Updated {@link android.support.v4.net.ConnectivityManagerCompat} to get NetworkInfo |
| from a {@link android.net.ConnectivityManager#CONNECTIVITY_ACTION} |
| broadcast.</li> |
| </ul> |
| </dd> |
| </dl> |
| </div> |
| </div> |
| |
| |
| <div class="toggle-content closed"> |
| <p><a href="#" onclick="return toggleContent(this)"> |
| <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" |
| />Android Support Library, revision 10</a> <em>(August 2012)</em> |
| </p> |
| <div class="toggle-content-toggleme"> |
| <dl> |
| <dt>Changes for v4 support library:</dt> |
| <dd> |
| <ul> |
| <li>Added support for notification features introduced in Android 4.1 (API level 16) with |
| additions to {@link android.support.v4.app.NotificationCompat}.</li> |
| </ul> |
| </dd> |
| </dl> |
| </div> |
| </div> |
| |
| |
| <div class="toggle-content closed"> |
| <p><a href="#" onclick="return toggleContent(this)"> |
| <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" |
| />Android Support Library, revision 9</a> <em>(June 2012)</em> |
| </p> |
| <div class="toggle-content-toggleme"> |
| <dl> |
| <dt>Changes for v4 support library:</dt> |
| <dd> |
| <ul> |
| |
| <li>User Interface Support |
| <ul> |
| <li>Added {@link android.support.v4.view.PagerTabStrip} support, providing enhanced |
| functionality beyond {@link android.support.v4.view.PagerTitleStrip}.</li> |
| <li>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.</li> |
| <li>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.</li> |
| <li>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.</li> |
| <li>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.</li> |
| <li>Added support for the {@link |
| android.support.v4.view.ViewCompat postOnAnimation()} method in {@link |
| android.support.v4.view.ViewCompat}.</li> |
| <li>Updated {@link android.support.v4.app.NavUtils} to use Android 4.1 (API level 16) |
| <em>Up</em> navigation functionality when available.</li> |
| </ul> |
| </li> |
| |
| <li>Accessibility |
| <ul> |
| <li>Updated accessibility support classes, including {@link |
| android.support.v4.view.accessibility.AccessibilityNodeInfoCompat}, to follow fixes made in Android |
| 4.1 (API level 16).</li> |
| <li>Added support for accessibility scroll actions in {@link |
| android.support.v4.view.ViewPager}.</li> |
| </ul> |
| </li> |
| |
| <li>General improvements |
| <ul> |
| <li>Updated {@link android.support.v4.app.TaskStackBuilder} to reflect API changes in |
| Android 4.1 (API level 16).</li> |
| <li>Enhanced {@link android.support.v4.app.TaskStackBuilder} to allow it to be used |
| from a Service.</li> |
| <li>Added support for {@link android.support.v4.content.IntentCompat EXTRA_HTML_TEXT} |
| to {@link android.support.v4.app.ShareCompat}.</li> |
| <li>Updated {@link android.support.v4.app.NotificationCompat.Builder} to support the |
| {@link android.support.v4.app.NotificationCompat.Builder#setNumber setNumber()} method.</li> |
| <li>Added support in {@link android.support.v4.net.ConnectivityManagerCompat} for the |
| {@link android.support.v4.net.ConnectivityManagerCompat#isActiveNetworkMetered |
| isActiveNetworkMetered()} method.</li> |
| </ul> |
| </li> |
| </ul> |
| </dd> |
| </dl> |
| </div> |
| </div> |
| |
| |
| <div class="toggle-content closed"> |
| <p><a href="#" onclick="return toggleContent(this)"> |
| <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" |
| />Android Support Library, revision 8</a> <em>(April 2012)</em> |
| </p> |
| <div class="toggle-content-toggleme"> |
| <dl> |
| <dt>Changes for v4 support library:</dt> |
| <dd> |
| <ul> |
| <li>Fixed intent flags for {@link android.app.PendingIntent} objects generated |
| by {@link android.support.v4.app.TaskStackBuilder}.</li> |
| <li>Removed unused attributes from the gridlayout library projects to make sure |
| the library can be built with API level 7 and higher.</li> |
| <li>Added {@code .classpath} and {@code .project} files for the gridlayout |
| library project.</li> |
| </ul> |
| </dd> |
| </dl> |
| </div> |
| </div> |
| |
| |
| <div class="toggle-content closed"> |
| <p><a href="#" onclick="return toggleContent(this)"> |
| <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" |
| />Android Support Library, revision 7</a> <em>(March 2012)</em> |
| </p> |
| <div class="toggle-content-toggleme"> |
| <dl> |
| <dt>Changes for v4 support library:</dt> |
| <dd> |
| <ul> |
| <li>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.</li> |
| <li>Added {@link android.support.v4.app.NavUtils} and {@link |
| android.support.v4.app.TaskStackBuilder} to provide support for implementing the |
| <a href="{@docRoot}design/index.html">Android Design</a> guidelines for navigation. These |
| additions include a way to implement the action bar's <em>Up</em> button across versions. |
| For an example implementation of this pattern, see the AppNavigation sample in |
| ({@code <em><sdk></em>/samples/<em><platform></em>/AppNavigation}).</li> |
| <li>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.</li> |
| </ul> |
| </dd> |
| </dl> |
| </div> |
| </div> |
| |
| |
| <div class="toggle-content closed"> |
| <p><a href="#" onclick="return toggleContent(this)"> |
| <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" |
| />Android Support Library, revision 6</a> <em>(December 2011)</em> |
| </p> |
| <div class="toggle-content-toggleme"> |
| |
| <p class="note"><strong>Note:</strong> Reference for support library APIs are now available with |
| the framework references, for example: {@link android.support.v4.app}.</p> |
| <dl> |
| <dt>Changes for v4 support library:</dt> |
| <dd> |
| <ul> |
| <li>Changes to ViewPager: |
| <ul> |
| <li>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.</li> |
| <li>Added {@link android.support.v4.view.PagerAdapter#getPageTitle |
| PagerAdapter.getPageTitle()} to supply title strings for pages, which defaults to no |
| title for each page.</li> |
| <li>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.</li> |
| <li>Updated {@link android.support.v4.view.PagerAdapter} methods to take ViewGroup |
| objects, rather than View to avoid class casting in adapter implementations.</li> |
| <li>Updated {@link android.support.v4.view.ViewPager} to use Launcher-style |
| fling behavior.</li> |
| <li>Bug fixes for user interface interaction and test automation.</li> |
| </ul> |
| </li> |
| |
| <li>Support for Fragments: |
| <ul> |
| <li>Changed {@code setStartDeferred()} method to {@link |
| android.support.v4.app.Fragment#setUserVisibleHint}.</li> |
| <li>Added deferred start for off-screen pages to improve performance.</li> |
| </ul> |
| </li> |
| |
| <li>Support for Accessiblity APIs: |
| <ul> |
| <li>Updated {@link android.support.v4.view.AccessibilityDelegateCompat} methods |
| to return empty lists instead of null.</li> |
| <li>Added new APIs needed by the v4 samples.</li> |
| </ul> |
| </li> |
| |
| </ul> |
| </dd> |
| </dl> |
| </div> |
| </div> |
| |
| <div class="toggle-content closed"> |
| <p><a href="#" onclick="return toggleContent(this)"> |
| <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" |
| />Android Support Library, revision 5</a> <em>(December 2011)</em> |
| </p> |
| <div class="toggle-content-toggleme"> |
| <dl> |
| <dt>Changes for v4 support library:</dt> |
| <dd> |
| <ul> |
| <li>Support for Accessiblity APIs: |
| <ul> |
| <li>Added {@link android.support.v4.view.AccessibilityDelegateCompat} |
| to support {@link android.view.View.AccessibilityDelegate}.</li> |
| |
| <li>Added {@link android.support.v4.view.accessibility.AccessibilityEventCompat} |
| to support {@link android.view.accessibility.AccessibilityEvent}.</li> |
| |
| <li>Added {@link android.support.v4.view.accessibility.AccessibilityManagerCompat} |
| to support {@link android.view.accessibility.AccessibilityManager}.</li> |
| |
| <li>Added {@link android.support.v4.view.accessibility.AccessibilityNodeInfoCompat} |
| to support {@link android.view.accessibility.AccessibilityNodeInfo}.</li> |
| |
| <li>Added {@link android.support.v4.view.accessibility.AccessibilityRecordCompat} |
| to support {@link android.view.accessibility.AccessibilityRecord}.</li> |
| |
| <li>Added {@link |
| android.support.v4.accessibilityservice.AccessibilityServiceInfoCompat} |
| to support {@link android.accessibilityservice.AccessibilityServiceInfo}.</li> |
| |
| <li>Added {@link android.support.v4.view.ViewGroupCompat} |
| to support accessibility features in {@link android.view.ViewGroup}. |
| </li> |
| |
| <li>Modified {@link android.support.v4.view.ViewCompat} |
| to support accessibility features in {@link android.view.View}.</li> |
| </ul> |
| </li> |
| |
| <li>Changes to ViewPager: |
| <ul> |
| <li>Added support for margins between pages. |
| An optional {@link android.graphics.drawable.Drawable} can be provided |
| to fill the margins.</li> |
| <li>Added support for {@link android.widget.EdgeEffect}.</li> |
| <li>Added support for keyboard navigation</li> |
| <li>Added support to control how many pages are kept to either side |
| of the current page.</li> |
| <li>Improved touch physics.</li> |
| <li>Bug fixes for user interface behavior.</li> |
| </ul> |
| </li> |
| </ul> |
| </dd> |
| </dl> |
| </div> |
| </div> |
| |
| <div class="toggle-content closed"> |
| <p><a href="#" onclick="return toggleContent(this)"> |
| <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" |
| />Android Support Library, revision 4</a> <em>(October 2011)</em> |
| </p> |
| <div class="toggle-content-toggleme"> |
| <dl> |
| <dt>Changes for v4 support library:</dt> |
| <dd> |
| <ul> |
| <li>Added <code>EdgeEffectCompat</code> to |
| support {@link android.widget.EdgeEffect}.</li> |
| |
| <li>Added <code>LocalBroadcastManager</code> to allow applications to easily |
| register for and receive intents within a single application without |
| broadcasting them globally.</li> |
| |
| <li>Added support in <code>ViewCompat</code> to check for and set overscroll |
| modes for {@link android.view.View}s on Android 2.3 and later.</li> |
| <li>Changes to Fragment APIs: |
| <ul> |
| <li>Added new APIs to control the visibility of new menus.</li> |
| <li>Added custom animation APIs.</li> |
| <li>Added APIs in <code>FragmentActivity</code> to retain custom, |
| non-configuration instance data.</li> |
| <li>Various bug fixes.</li> |
| </ul> |
| </li> |
| |
| <li>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.</li> |
| |
| </ul> |
| </dd> |
| </dl> |
| </div> |
| </div> |
| |
| |
| <div class="toggle-content closed"> |
| <p><a href="#" onclick="return toggleContent(this)"> |
| <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" |
| />Android Support Library, revision 3</a> <em>(July 2011)</em> |
| </p> |
| <div class="toggle-content-toggleme"> |
| <dl> |
| <dt>Changes for v4 support library:</dt> |
| <dd> |
| <ul> |
| <li>Adds support for {@link android.app.Fragment.SavedState}</li> |
| <li>Adds {@code MotionEventCompat} to support newer {@link |
| android.view.MotionEvent} APIs</li> |
| <li>Adds {@code VelocityTrackerCompat} to support a newer {@link |
| android.view.VelocityTracker} APIs</li> |
| <li>Adds {@code ViewConfigurationCompat} to support a newer {@link |
| android.view.ViewConfiguration} APIs</li> |
| <li>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: |
| <ul> |
| <li>{@code ViewPager}: A {@link android.view.ViewGroup} that manages the |
| layout for the child views, which the user can swipe between.</li> |
| <li>{@code PagerAdapter}: An adapter that populates the {@code ViewPager} with the |
| views that represent each page.</li> |
| <li>{@code FragmentPagerAdapter}: An extension of {@code PagerAdapter} for flipping |
| between fragments.</li> |
| <li>{@code FragmentStatePagerAdapter}: An extension of {@code PagerAdapter} for |
| flipping between fragments that uses the library's support for {@link |
| android.app.Fragment.SavedState}.</li> |
| </ul> |
| </li> |
| </ul> |
| </dd> |
| <dt>New v13 support library:</dt> |
| <dd> |
| <ul> |
| <li>Includes the {@code FragmentPagerAdapter} and {@code FragmentStatePagerAdapter} |
| to support the horizontal paging. |
| <p>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).</p> |
| </li> |
| </ul> |
| </dd> |
| </dl> |
| </div> |
| </div> |
| |
| |
| <div class="toggle-content closed"> |
| <p><a href="#" onclick="return toggleContent(this)"> |
| <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" |
| />Android Support Library, revision 2</a> <em>(May 2011)</em> |
| </p> |
| <div class="toggle-content-toggleme"> |
| <dl> |
| <dt>Changes for v4 library:</dt> |
| <dd> |
| <ul> |
| <li>Support for fragment animations</li> |
| <li>Fix {@link android.support.v4.app.Fragment#onActivityResult Fragment.onActivityResult()} |
| bug</li> |
| </ul> |
| </dd> |
| </dl> |
| </div> |
| </div> |
| |
| |
| <div class="toggle-content closed"> |
| <p><a href="#" onclick="return toggleContent(this)"> |
| <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" |
| />Android Support Library, revision 1</a> <em>(March 2011)</em> |
| </p> |
| <div class="toggle-content-toggleme"> |
| <p>Initial release with the v4 library.</p> |
| </div> |
| </div> |
| |
