-
@@ -63,94 +71,115 @@ page.title=Support Library Features
include the library in your application.
-
- App Components
-
-
-
- {@link android.support.v4.app.Fragment} - - Adds support for encapsulation of user interface and functionality - with Fragments, enabling - applications to provide layouts that adjust between small and - large-screen devices. - - -
- {@link android.support.v4.app.NotificationCompat} - Adds support for rich notification - features. -
- {@link android.support.v4.content.LocalBroadcastManager} - Allows applications to easily - register for and receive intents within a single application without broadcasting them - globally. -
- - User Interface
-
-
-
- {@link android.support.v4.view.ViewPager} - Adds a - {@link android.view.ViewGroup} that manages the layout for the - child views, which the user can swipe between. -
- {@link android.support.v4.view.PagerTitleStrip} - - Adds a non-interactive title strip, that can be added as a child of - {@link android.support.v4.view.ViewPager}. -
- {@link android.support.v4.view.PagerTabStrip} - Adds a - navigation widget for switching between paged views, that can also be used with - {@link android.support.v4.view.ViewPager}. -
- {@link android.support.v4.widget.DrawerLayout} - Adds - support for creating a Navigation Drawer that can be pulled in from the edge of a window. -
- {@link android.support.v4.widget.SlidingPaneLayout} - - Adds widget for creating linked summary and detail views that - appropriately adapt to various screen sizes. -
- - Accessibility
-
-
-
- {@link android.support.v4.widget.ExploreByTouchHelper} - - Adds a helper class for implementing accessibility support for custom views. -
- {@link android.support.v4.view.accessibility.AccessibilityEventCompat} - Adds support for - {@link android.view.accessibility.AccessibilityEvent}. For more information about implementing - accessibility, see Accessibility. - -
- {@link android.support.v4.view.accessibility.AccessibilityNodeInfoCompat} - Adds support - for {@link android.view.accessibility.AccessibilityNodeInfo}. -
- {@link android.support.v4.view.accessibility.AccessibilityNodeProviderCompat} - Adds - support for {@link android.view.accessibility.AccessibilityNodeProvider}. -
- {@link android.support.v4.view.AccessibilityDelegateCompat} - Adds support for - {@link android.view.View.AccessibilityDelegate}. -
- - Content
-
-
-
- {@link android.support.v4.content.Loader} - Adds support for asynchronous loading of data. - The library also provides concrete implementations of this class, including - {@link android.support.v4.content.CursorLoader} and - {@link android.support.v4.content.AsyncTaskLoader}. -
- {@link android.support.v4.content.FileProvider} - Adds support for sharing of private - files between applications. -
- -
+
support-compat+
+
+ -
+ Provides compatibility wrappers for new framework APIs, such as
+
Context.getDrawable()and +View.performAccessibilityAction(). +
+
+ -
+
support-core-utils+
+
+ - + Provides a number of utility classes, such as {@link + android.support.v4.content.AsyncTaskLoader} and {@link + android.support.v4.content.PermissionChecker}. + + +
-
+
support-core-ui+
+
+ - + Implements a variety of UI-related components, such as {@link + android.support.v4.view.ViewPager}, {@link + android.support.v4.widget.NestedScrollView}, and {@link + android.support.v4.widget.ExploreByTouchHelper}. + + +
-
+
support-media-compat+
+
+ - + Backports portions of the media framework, + including {@link android.media.browse.MediaBrowser} and {@link + android.media.session.MediaSession}. + + +
-
+
support-fragment+
+
+ -
+ Backports the fragment
+ framework. This module has dependencies on
support-compat, +support-core-utils,support-core-ui, and +support-media-compat. +
+ - Clients using Custom Tabs can
+ control whether Instant Apps should open. (Note that Instant Apps are not yet
+ generally available.) To enable or disable Instant Apps, call
+
CustomTabsIntent.Builder.setInstantAppsEnabled()or + specify +EXTRA_ENABLE_INSTANT_APPS. By default, Custom Tabs will + default to enabling Instant Apps, when that feature becomes available. +
+
+ - {@link android.support.design.widget.TextInputLayout} adds support for + the + password visibility toggle from the material design specification. + + +
- The new
android.support.transition+ package backports the Transitions framework to API levels 14 + and higher. For more information, see theandroid.support.transitionreference. +
+
+ - The Custom Tabs support library + adds support for using {@link android.widget.RemoteViews} in the secondary + toolbar. The existing {@link + android.support.customtabs.CustomTabsSession#setToolbarItem setToolbarItem()} + method is now deprecated. + + +
- {@link android.support.v7.content.res.AppCompatResources} adds the
+ ability to load a
<vector>(on API level 9 and higher) or +<animated-vector>(on API level 11 and higher) from a + resource ID, by using the newgetDrawable()method. +
+
+ - {@link android.support.design.widget.CoordinatorLayout} now supports
+ defining inset views, and specifying that other views should dodge the inset
+ views. This allows apps to replicate behavior patterns similar to the way
+ {@link android.support.design.widget.FloatingActionButton} moves out of the
+ way of a {@link android.support.design.widget.Snackbar}, but for any
+ arbitrary view children. For more information, see the
+
LayoutParams.insetEdgeand +LayoutParams.dodgeInsetEdgesreference documentation. +
+
+ - The new
+ DiffUtilclass can calculate the difference between two + collections, and can dispatch a list of update operations that are suitable + to be consumed by a {@link android.support.v7.widget.RecyclerView.Adapter}. +
+
+ -
+
+ RecyclerView.OnFlingListenerhas been added to support custom + behavior in response to flings. TheSnapHelper+ class provides an implementation specifically for snapping child views, and + theLinearSnapHelper+ class extends this implementation to provide center-aligned snapping + behavior similar to {@link android.support.v4.view.ViewPager}. +
+
+ - If you use the appcompat library's day/night functionality, the system + now automatically recreates your activity whenever the day/night mode changes + (either because of the time of day, or because of a call to {@link + android.support.v7.app.AppCompatDelegate#setLocalNightMode + AppCompatDelegate.setLocalNightMode()}). + + +
- {@link android.support.design.widget.Snackbar} now draws behind the + navigation bar if the status bar is translucent. + +
- Several methods on the following classes were only required for API 8 and
+ lower, and should no longer be used. Instead, use the framework
+ implementations.
+
-
+
- {@link android.support.v4.view.KeyEventCompat}: Replace with {@link + android.view.KeyEvent} + + +
- {@link android.support.v4.view.MotionEventCompat}: Use {@link + android.view.MotionEvent} + + +
- {@link android.support.v4.view.ViewCompat}: Use {@link + android.view.View} + + +
- {@link android.support.v4.view.ViewConfigurationCompat}: Use {@link + android.view.ViewConfiguration} + +
+
+ -
+ {@link android.support.v4.accessibilityservice.AccessibilityServiceInfoCompat#getDescription
+ AccessibilityServiceInfoCompat.getDescription()}
+ has been deprecated in favor of
+
loadDescription()+ which returns a correctly localized description. +
+
+ - You should not instantiate the
ActivityCompatclass + directly. The non-staticgetReferrer(Activity)method will be + made static in an upcoming release. +
+
+ - {@link android.support.design.widget.CoordinatorLayout.Behavior#isDirty + CoordinatorLayout.Behavior.isDirty()} has been deprecated and is no longer + called by {@link android.support.design.widget.CoordinatorLayout}. Any + implementations, as well as any calls to this method, should be removed. + + +
- {@link android.support.v4.media.session.MediaSessionCompat#obtain
+ MediaSessionCompat.obtain()} has been deprecated and replaced with the more
+ appropriately-named method
+
fromMediaSession(). +
+
+ - {@link
+ android.support.v4.media.session.MediaSessionCompat.QueueItem#obtain
+ MediaSessionCompat.QueueItem.obtain()} has been deprecated and replaced with
+ the more appropriately-named method
+
fromQueueItem(). +
+
+ - Several abstract classes have been deprecated and replaced with
+ interfaces that more closely reflect their framework equivalents.
+
-
+
- {@link
+ android.support.v4.view.accessibility.AccessibilityManagerCompat.AccessibilityStateChangeListenerCompat}
+ has been replaced by the
+
AccessibilityManagerCompat.AccessibilityStateChangeListener+ interface. +
+
+ - {@link
+ android.support.v4.widget.SearchViewCompat.OnCloseListenerCompat} has
+ been replaced by the
SearchViewCompat.OnCloseListenerinterface. +
+
+ - {@link
+ android.support.v4.widget.SearchViewCompat.OnQueryTextListenerCompat }
+ has been replaced by the
SearchViewCompat.OnQueryTextListener+ interface. +
+
+
+ - {@link
+ android.support.v4.view.accessibility.AccessibilityManagerCompat.AccessibilityStateChangeListenerCompat}
+ has been replaced by the
+
- {@link android.support.customtabs.CustomTabsSession#setToolbarItem
+ CustomTabsSession.setToolbarItem()} has been deprecated and replaced by the
+ RemoteViews-based
+
setSecondaryToolbarViews(). +
+ - Ensure
SwipeRefreshLayoutindicator is shown when +setRefreshing(true)is called before the first measurement pass + (AOSP + issue 77712) +
+
+ - Prevent
TabLayoutfrom flickering when changing pages + (AOSP + issue 180454) +
+
+ - Avoid
ClassNotFoundExceptionwhen unmarshalling +SavedStateon API level 11 and lower (AOSP issue + 196430) +
+ - TabLayout.setCustomView(null) results in NullPointerException (AOSP - issue) + issue 214753)
- TabLayout incorrectly highlights custom tabs (
- Make sure you have downloaded the Android Support Repository using the SDK Manager.
- Open the {@code build.gradle} file for your application.
-- Add the support library to the {@code dependencies} section. For example, to add the v4 - support library, add the following lines: +
- Add the support library to the {@code dependencies} section. For + example, to add the v4 core-utils library, add the following lines:
+dependencies { ... - compile "com.android.support:support-v4:24.1.1" + compile "com.android.support:support-core-utils:24.2.0" }+ Caution: Using dynamic dependencies (for example, +
+palette-v7:23.0.+) can cause unexpected version updates and + regression incompatibilities. We recommend that you explicitly specify a + library version (for example,palette-v7:24.2.0). +Using Support Library APIs
Support Library classes that provide support for existing framework APIs typically have the @@ -141,12 +148,12 @@ dependencies {
<uses-sdk - android:minSdkVersion="7" - android:targetSdkVersion="17" /> + android:minSdkVersion="14" + android:targetSdkVersion="23" />
The manifest setting tells Google Play that your application can be installed on devices with Android - 2.1 (API level 7) and higher.
+ 4.0 (API level 14) and higher.If you are using Gradle build files, the
@@ -158,7 +165,7 @@ android { ... defaultConfig { - minSdkVersion 8 + minSdkVersion 16 ... } ... @@ -166,13 +173,15 @@ android {minSdkVersionsetting in the build file overrides the manifest settings.In this case, the build file setting tells Google Play that the default build variant of your - application can be installed on devices with Android 2.2 (API level 8) and higher. For more + application can be installed on devices with Android 4.1 (API level 16) and higher. For more information about build variants, see Build System Overview.
- Note: If you are including the v4 support and v7 appcompat libraries in your - application, you should specify a minimum SDK version of
diff --git a/docs/html/training/transitions/index.jd b/docs/html/training/transitions/index.jd index 53faa01aad8b1..b8f99c84fc93e 100644 --- a/docs/html/training/transitions/index.jd +++ b/docs/html/training/transitions/index.jd @@ -48,11 +48,9 @@ animate changes between view hierarchies. This class also covers how to create c animations."7"(and not -"4"). The highest support library level you include in your application determines - the lowest API version in which it can operate. + Note: If you are including several support libraries, the + minimum SDK version must be the highest version required by any of + the specified libraries. For example, if your app includes both the v14 Preference Support library and the + v17 Leanback library, your minimum + SDK version must be 17 or higher.Note: For Android versions earlier than 4.4.2 (API level 19) -but greater than or equal to Android 4.0 (API level 14), use the
- +but greater than or equal to Android 4.0 (API level 14), use the Android Support +Library'sanimateLayoutChanges-attribute to animate layouts. To learn more, see -Property Animation and -Animating Layout Changes.android.support.transitionpackage.Lessons
v4 Support Library
- -This library is designed to be used with Android 1.6 (API level 4) and higher. It includes the - largest set of APIs compared to the other libraries, including support for application components, - user interface features, accessibility, data handling, network connectivity, and programming - utilities. Here are a few of the key classes included in the v4 library:
- --
-
v4 Support Libraries
- There are many other APIs included in this library. For complete, detailed information about the - v4 Support Library APIs, see the {@link android.support.v4.app android.support.v4} package in the - API reference. + These libraries are designed to be used with Android 2.3 (API level 9) and + higher. They include the largest set of APIs compared to the other libraries, + including support for application components, user interface features, + accessibility, data handling, network connectivity, and programming + utilities.
-Caution: Using dynamic dependencies, especially for higher version -numbers, can cause unexpected version updates and regression incompatibilities.
++ For complete, detailed information about the classes and methods provided by + the v4 support libraries, see the {@link android.support.v4.app + android.support.v4} package in the API reference. +
+ + +
+ Note: Prior to Support Library revision 24.2.0, there was a
+ single v4 support library. That library was divided into multiple modules to
+ improve efficiency. For backwards compatibility, if you list
+ support-v4 in your Gradle script, your APK will include all of
+ the v4 modules. However, to reduce APK size, we recommend that you just list
+ the specific modules your app needs.
+
v4 compat library
+ +
+ Provides compatibility wrappers for a number of framework APIs, such as
+ Context.obtainDrawable() and
+ View.performAccessibilityAction().
+
The Gradle build script dependency identifier for this library is as follows:
-com.android.support:support-v4:24.1.1 +com.android.support:support-compat:24.2.0+
v4 core-utils library
++ Provides a number of utility classes, such as {@link + android.support.v4.content.AsyncTaskLoader} and {@link + android.support.v4.content.PermissionChecker}. +
+ ++ The Gradle build script dependency identifier for this library is as follows: +
+ ++com.android.support:support-core-utils:24.2.0 ++ +
v4 core-ui library
+ ++ Implements a variety of UI-related components, such as {@link + android.support.v4.view.ViewPager}, {@link + android.support.v4.widget.NestedScrollView}, and {@link + android.support.v4.widget.ExploreByTouchHelper}. +
+ ++ The Gradle build script dependency identifier for this library is as follows: +
+ ++com.android.support:support-core-ui:24.2.0 ++ +
v4 media-compat library
+ ++ Backports portions of the media framework, + including {@link android.media.browse.MediaBrowser} and {@link + android.media.session.MediaSession}. +
+ ++ The Gradle build script dependency identifier for this library is as follows: +
+ ++com.android.support:support-media-compat:24.2.0 ++ +
v4 fragment library
+ ++ Adds support for encapsulation of user interface and functionality with + fragments, + enabling applications to provide layouts that adjust between small and + large-screen devices. This module has dependencies on compat, core-utils, core-ui, and media-compat. +
+ ++ The Gradle build script dependency identifier for this library is as follows: +
+ ++com.android.support:support-fragment:24.2.0 +
Multidex Support Library
@@ -173,7 +202,7 @@ com.android.support:multidex:1.0.0v7 Support Libraries
-There are several libraries designed to be used with Android 2.1 (API level 7) and higher. +
There are several libraries designed to be used with Android 2.3 (API level 9) and higher. These libraries provide specific feature sets and can be included in your application independently from each other.
@@ -216,7 +245,7 @@ com.android.support:multidex:1.0.0The Gradle build script dependency identifier for this library is as follows:
-com.android.support:appcompat-v7:24.1.1 +com.android.support:appcompat-v7:24.2.0@@ -231,7 +260,7 @@ implementations, and are used extensively in layouts for TV apps.
The Gradle build script dependency identifier for this library is as follows:
-com.android.support:cardview-v7:24.1.1 +com.android.support:cardview-v7:24.2.0@@ -247,7 +276,7 @@ For detailed information about the v7 gridlayout library APIs, see the
The Gradle build script dependency identifier for this library is as follows:
-com.android.support:gridlayout-v7:24.1.1 +com.android.support:gridlayout-v7:24.2.0@@ -270,7 +299,7 @@ reference.
The Gradle build script dependency identifier for this library is as follows:
-com.android.support:mediarouter-v7:24.1.1 +com.android.support:mediarouter-v7:24.2.0
The v7 mediarouter library APIs introduced in Support Library @@ -290,7 +319,7 @@ title card.
The Gradle build script dependency identifier for this library is as follows:
-com.android.support:palette-v7:24.1.1 +com.android.support:palette-v7:24.2.0@@ -306,7 +335,7 @@ limited window of data items.
The Gradle build script dependency identifier for this library is as follows:
-com.android.support:recyclerview-v7:24.1.1 +com.android.support:recyclerview-v7:24.2.0@@ -329,18 +358,18 @@ such as {@link android.support.v7.preference.CheckBoxPreference} and
The Gradle build script dependency identifier for this library is as follows:
-com.android.support:preference-v7:24.1.1 +com.android.support:preference-v7:24.2.0
v8 Support Library
-This library is designed to be used with Android 2.2 (API level 8) and higher. +
This library is designed to be used with Android 2.3 (API level 9) and higher. This library provides specific feature sets and can be included in your application independently from other libraries.
v8 renderscript library
-This library is designed to be used with Android (API level 8) and higher. It adds support for +
This library is designed to be used with Android 2.3 (API level 9) and higher. It adds support for
the RenderScript computation
framework. These APIs are included in the {@link android.support.v8.renderscript} package. You
should be aware that the steps for including these APIs in your application is very
@@ -380,7 +409,7 @@ defaultConfig {
The Gradle build script dependency identifier for this library is as follows: The Gradle build script dependency identifier for this library is as follows: The Gradle build script dependency identifier for this library is as follows: The Gradle build script dependency identifier for this library is as follows:
-com.android.support:support-v13:24.1.1
+com.android.support:support-v13:24.2.0
@@ -406,7 +435,7 @@ for preference interfaces such as
-com.android.support:preference-v14:24.1.1
+com.android.support:preference-v14:24.2.0
@@ -429,7 +458,7 @@ interface and classes, such as
-com.android.support:preference-leanback-v17:24.1.1
+com.android.support:preference-leanback-v17:24.2.0
@@ -465,7 +494,7 @@ com.android.support:preference-leanback-v17:24.1.1
-com.android.support:leanback-v17:24.1.1
+com.android.support:leanback-v17:24.2.0
@@ -480,7 +509,7 @@ package provides APIs to support adding annotation metadata to your apps.
The Gradle build script dependency identifier for this library is as follows:
-com.android.support:support-annotations:24.1.1 +com.android.support:support-annotations:24.2.0@@ -498,7 +527,7 @@ snackbars, and tabs. <
The Gradle build script dependency identifier for this library is as follows:
-com.android.support:design:24.1.1 +com.android.support:design:24.2.0@@ -519,7 +548,7 @@ Callback.
The Gradle build script dependency identifier for this library is as follows:
-com.android.support:customtabs:24.1.1 +com.android.support:customtabs:24.2.0@@ -543,7 +572,7 @@ PercentRelativeLayout.
The Gradle build script dependency identifier for this library is as follows:
-com.android.support:percent:24.1.1 +com.android.support:percent:24.2.0@@ -566,5 +595,5 @@ RecommendationExtender.
The Gradle build script dependency identifier for this library is as follows:
-com.android.support:recommendation:24.1.1 +com.android.support:recommendation:24.2.0diff --git a/docs/html/topic/libraries/support-library/revisions.jd b/docs/html/topic/libraries/support-library/revisions.jd index 3b25fb0207674..4e14c7054bbdb 100644 --- a/docs/html/topic/libraries/support-library/revisions.jd +++ b/docs/html/topic/libraries/support-library/revisions.jd @@ -6,9 +6,324 @@ page.metaDescription=This page provides details about the Support Library packag
This page provides details about the Support Library package releases.
+
Android Support Library, revision 24.2.0
+ (August 2016)
+
Release 24.2.0 contains the following changes:
+ + + +Note: Release 24.2.0 removes support for + Android 2.2 (API level 8) and lower. Classes and methods that exist only to + serve those system versions are now marked as deprecated and should no longer + be used. These deprecated classes and methods may be removed in a future + release. +
+ +v4 Support Library split
+ +With this release, the v4 Support Library has + been split into several smaller modules:
+ +-
+
For backwards compatibility, if you list support-v4 in your
+Gradle script, your APK will include all of these modules. However, to reduce
+APK size, we recommend that you just list the specific modules your app needs.
+
API updates
+ +-
+
Behavior changes
+ +-
+
Deprecations
+ +Deprecated classes and methods are subject to removal in a future release. You should migrate away from these APIs as soon as possible.
+ +-
+
Bug fixes
+ +The following known issues have been fixed with release 24.2.0:
+ +-
+
+ A complete list of public bug fixes is available on the + AOSP Issue Tracker. +
+ +
+ Android Support Library, revision 24.1.1
(July 2016)