Support Library

Changes for v4 support library:

• Improved PrintHelper by adding asynchronous handling of printing.
• Fixed the DrawerLayout class approximation of the addChildrenForAccessibility() method.
• Fixed slide drawable mirroring in 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 MediaRouteProvider.ProviderMetadata.
• Updated MediaRouteChooserDialog to hide disabled routes.

Changes for v8 renderscript library:

• Added error propagation for the RenderScript thunking layer.

Changes for v4 support library:

• Added support for external Storage APIs with the getObbDirs(), getExternalFilesDirs(), getExternalCacheDirs(), and 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 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 PopupMenuCompat and ListPopupWindowCompat.
• Improved accessibility support with the addition of a findFocus() method in AccessibilityNodeProviderCompat and the getLiveRegion() method in AccessibilityNodeInfoCompat.
• Added helper class ScaleGestureDetectorCompat for accessing new scaling gesture methods.
• Fixed problem with ActionBarDrawerToggle in right-to-left language displays.
• Modified 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.

Changes for v4 support library:

• User interface
  • Added BidiFormatter for handling text strings that combine right to left and left to right-formatted text.
  • Modified ViewPager to better handle cases where the pager has a measured width of zero in the initial layout processing.
  • Modified DrawerLayout and SlidingPaneLayout to not throw exceptions for measurement while the project code is being edited.
• Accessibility
  • Added ExploreByTouchHelper to simplify the implementation of accessibility for custom views.
  • Fixed a problem with ViewPager incorrectly populating TYPE_VIEW_SCROLLED accessibility events.
  • Fixed a null pointer exception in ViewPager when populating an accessibility event.
  • Simplified AccessibilityNodeInfoCompat by changing CharSequence inputs to String objects.
  • Deprecated an AccessibilityRecordCompat constructor that used an Object as input.
• Media
  • Added TransportMediator helper class to manage media transport control, such as play, pause, skip and other media actions.
  • Added DisplayManagerCompat for managing display output to one or more device displays.
• Other changes
  • Added WakefulBroadcastReceiver helper class for implementing a common pattern of detecting a device wakeup event and passing work off to a Service while ensuring that the device does not go back to sleep before the handoff is complete.
  • Added two new APIs, commitContentChanged() and rollbackContentChanged(), to AsyncTaskLoader to help deal with background updates for data changes that are subsequently canceled.

New v7 appcompat library:

• Added 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 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.

Changes for v4 support library:

• Added DrawerLayout for creating a Navigation Drawer that can be pulled in from the edge of a window.
• Added SlidingPaneLayout widget for creating linked summary and detail views that appropriately adapt to various screen sizes.
• Added ActionBarDrawerToggle as a way to tie together the functions of DrawerLayout and ActionBar.
• Added ViewDragHelper as a new common component for dragging views within a parent view.
• Added ScrollerCompat to provide Scroller and OverScroller compatibility support.
• Added FileProvider to allow sharing of private files between applications.
• Updated ViewPager to throw an exception if the associated PagerAdapter class is modified without a call to notifyDataSetChanged().
• Fixed an issue with ViewPager children drawing sort order.
• Fixed GestureDetectorCompat to dispatch missing onSingleTapConfirmed(MotionEvent) calls between tap timeout and long press events.

New v7 gridlayout library:

• Added GridLayout to provide support for the GridLayout layout object.
• Added Space which can be used to create blank areas within a GridLayout layout object.

Changes for v4 support library:

• Improved interaction behavior for ViewPager.
• Fixed a bug that could cause ViewPager to select the wrong page.
• Fixed use of removeView() method during layout for ViewPager.
• Fixed issue with 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.

Changes for v4 support library:

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

Changes for v4 support library:

• Added support for notification features introduced in Android 4.1 (API level 16) with additions to NotificationCompat.

Changes for v4 support library:

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

Changes for v4 support library:

• Fixed intent flags for PendingIntent objects generated by TaskStackBuilder.
• Removed unused attributes from the gridlayout library projects to make sure the library can be built with API level 7 and higher.
• Added .classpath and .project files for the gridlayout library project.

Changes for v4 support library:

• Added 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 ShareActionProvider in Android 4.0.
• Added NavUtils and 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 (<sdk>/samples/<platform>/AppNavigation).
• Added NotificationCompat.Builder to provide a compatibility implementation of Android 3.0's Notification.Builder helper class for creating standardized system notifications.

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

Changes for v4 support library:

• Changes to ViewPager:
  • Added extra decorative view support for ViewPager. Decorative views may be supplied as child views of a pager in XML layout.
  • Added PagerAdapter.getPageTitle() to supply title strings for pages, which defaults to no title for each page.
  • Added 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 PagerAdapter methods to take ViewGroup objects, rather than View to avoid class casting in adapter implementations.
  • Updated ViewPager to use Launcher-style fling behavior.
  • Bug fixes for user interface interaction and test automation.
• Support for Fragments:
  • Changed setStartDeferred() method to setUserVisibleHint(boolean).
  • Added deferred start for off-screen pages to improve performance.
• Support for Accessiblity APIs:
  • Updated AccessibilityDelegateCompat methods to return empty lists instead of null.
  • Added new APIs needed by the v4 samples.

Changes for v4 support library:

• Support for Accessiblity APIs:
  • Added AccessibilityDelegateCompat to support View.AccessibilityDelegate.
  • Added AccessibilityEventCompat to support AccessibilityEvent.
  • Added AccessibilityManagerCompat to support AccessibilityManager.
  • Added AccessibilityNodeInfoCompat to support AccessibilityNodeInfo.
  • Added AccessibilityRecordCompat to support AccessibilityRecord.
  • Added AccessibilityServiceInfoCompat to support AccessibilityServiceInfo.
  • Added ViewGroupCompat to support accessibility features in ViewGroup.
  • Modified ViewCompat to support accessibility features in View.
• Changes to ViewPager:
  • Added support for margins between pages. An optional Drawable can be provided to fill the margins.
  • Added support for 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.

Changes for v4 support library:

• Added EdgeEffectCompat to support 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 Views 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 Loader bug that caused issues in canceling AsyncTasks when running on Froyo and older versions of the platform. The support code now uses its own version of AsyncTask to keep the same behavior on all platform versions.

Changes for v4 support library:

• Adds support for Fragment.SavedState
• Adds MotionEventCompat to support newer MotionEvent APIs
• Adds VelocityTrackerCompat to support a newer VelocityTracker APIs
• Adds ViewConfigurationCompat to support a newer 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:
  • ViewPager: A ViewGroup that manages the layout for the child views, which the user can swipe between.
  • PagerAdapter: An adapter that populates the ViewPager with the views that represent each page.
  • FragmentPagerAdapter: An extension of PagerAdapter for flipping between fragments.
  • FragmentStatePagerAdapter: An extension of PagerAdapter for flipping between fragments that uses the library's support for Fragment.SavedState.

New v13 support library:

• Includes the FragmentPagerAdapter and 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).

Changes for v4 library:

• Support for fragment animations
• Fix Fragment.onActivityResult() bug

Initial release with the v4 library.