Skip to content

Most visited

Recently visited

navigation

Support Library Features

The Android Support Library package contains several libraries that can be included in your application. Each of these libraries supports a specific range of Android platform versions and set of features.

This guide explains the important features and version support provided by the Support Libraries to help you decide which of them you should include in your application. In general, we recommend including the v4 support and v7 appcompat libraries, because they support a wide range of Android versions and provide APIs for recommended user interface patterns.

In order to use any of the following libraries, you must download the library files to your Android SDK installation. Follow the directions for downloading the Support Libraries in Support Library Setup to complete this step. You must take additional steps to include a specific Support Library in your application. See the end of each library section below for important information on how to include the library in your application.

v4 Support Libraries

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.

For complete, detailed information about the classes and methods provided by the v4 support libraries, see the 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-compat:24.2.0

v4 core-utils library

Provides a number of utility classes, such as AsyncTaskLoader and 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 ViewPager, NestedScrollView, and 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 MediaBrowser and 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

This library provides support for building apps with multiple Dalvik Executable (DEX) files. Apps that reference more than 65536 methods are required to use multidex configurations. For more information about using multidex, see Building Apps with Over 64K Methods.

The Gradle build script dependency identifier for this library is as follows:

com.android.support:multidex:1.0.0

v7 Support Libraries

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.

v7 appcompat library

This library adds support for the Action Bar user interface design pattern. This library includes support for material design user interface implementations.

Note: This library depends on the v4 Support Library.

Here are a few of the key classes included in the v7 appcompat library:

The Gradle build script dependency identifier for this library is as follows:

com.android.support:appcompat-v7:24.2.0

v7 cardview library

This library adds support for the CardView widget, which lets you show information inside cards that have a consistent look on any app. These cards are useful for material design 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.2.0

v7 gridlayout library

After you download the Android Support Libraries, this library adds support for the GridLayout class, which allows you to arrange user interface elements using a grid of rectangular cells. For detailed information about the v7 gridlayout library APIs, see the android.support.v7.widget package in the API reference.

The Gradle build script dependency identifier for this library is as follows:

com.android.support:gridlayout-v7:24.2.0

v7 mediarouter library

This library provides MediaRouter, MediaRouteProvider, and related media classes that support Google Cast.

In general, the APIs in the v7 mediarouter library provide a means of controlling the routing of media channels and streams from the current device to external screens, speakers, and other destination devices. The library includes APIs for publishing app-specific media route providers, for discovering and selecting destination devices, for checking media status, and more. For detailed information about the v7 mediarouter library APIs, see the android.support.v7.media package in the API reference.

The Gradle build script dependency identifier for this library is as follows:

com.android.support:mediarouter-v7:24.2.0

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 Google Cast.

v7 palette library

The v7 palette support library includes the Palette class, which lets you extract prominent colors from an image. For example, a music app could use a Palette object to extract the major colors from an album cover, and use those colors to build a color-coordinated song title card.

The Gradle build script dependency identifier for this library is as follows:

com.android.support:palette-v7:24.2.0

v7 recyclerview library

The recyclerview library adds the RecyclerView class. This class provides support for the RecyclerView widget, a view for efficiently displaying large data sets by providing a limited window of data items.

The Gradle build script dependency identifier for this library is as follows:

com.android.support:recyclerview-v7:24.2.0

v7 Preference Support Library

The preference package provides APIs to support adding preference objects, such as CheckBoxPreference and ListPreference, for users to modify UI settings.

The v7 Preference library adds support for interfaces, such as Preference.OnPreferenceChangeListener and Preference.OnPreferenceClickListener, and classes, such as CheckBoxPreference and ListPreference.

The Gradle build script dependency identifier for this library is as follows:

com.android.support:preference-v7:24.2.0

v8 Support Library

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 2.3 (API level 9) and higher. It adds support for the RenderScript computation framework. These APIs are included in the android.support.v8.renderscript package. You should be aware that the steps for including these APIs in your application is very different from other support library APIs. For more information about using these APIs in your application, see the RenderScript developer guide.

Note: Use of RenderScript with the support library is supported with Android Studio and Gradle-based builds. The renderscript library is located in the build-tools/$VERSION/renderscript/ folder.

The following example shows the Gradle build script properties for this library:

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

v13 Support Library

This library is designed to be used for Android 3.2 (API level 13) and higher. It adds support for the Fragment user interface pattern with the (FragmentCompat) class and additional fragment support classes. For more information about fragments, see the Fragments developer guide. For detailed information about the v13 Support Library APIs, see the android.support.v13 package in the API reference.

The Gradle build script dependency identifier for this library is as follows:

com.android.support:support-v13:24.2.0

v14 Preference Support Library

The android.support.v14.preference package provides APIs to add support for preference interfaces such as PreferenceFragment.OnPreferenceStartFragmentCallback and PreferenceFragment.OnPreferenceStartScreenCallback, along with classes, such as MultiSelectListPreference and PreferenceFragment. For detailed information about the v14 Preference Support Library APIs, see the preference package in the API reference.

The Gradle build script dependency identifier for this library is as follows:

com.android.support:preference-v14:24.2.0

v17 Preference Support Library for TV

The android.support.v17.preference package provides APIs for providing preference interfaces on TV devices, including support for the LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener interface and classes, such as BaseLeanbackPreferenceFragment and LeanbackPreferenceFragment. For detailed information about the v17 Preference Support Library APIs, see the preference package in the API reference.

The Gradle build script dependency identifier for this library is as follows:

com.android.support:preference-leanback-v17:24.2.0

v17 Leanback Library

The android.support.v17.leanback package provides APIs to support building user interfaces on TV devices. It provides a number of important widgets for TV apps. Some of the notable classes include:

The Gradle build script dependency identifier for this library is as follows:

com.android.support:leanback-v17:24.2.0

Annotations Support Library

The Annotation 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.2.0

Design Support Library

The Design package provides APIs to support adding material design components and patterns to your apps.

The Design Support library adds support for various material design components and patterns for app developers to build upon, such as navigation drawers, floating action buttons (FAB), snackbars, and tabs.

The Gradle build script dependency identifier for this library is as follows:

com.android.support:design:24.2.0

Custom Tabs Support Library

The Custom Tabs package provides APIs to support adding and managing custom tabs in your apps.

The Custom Tabs Support library adds support for various classes, such as Custom Tabs Service and Custom Tabs Callback.

The Gradle build script dependency identifier for this library is as follows:

com.android.support:customtabs:24.2.0

Percent Support Library

The Percent package provides APIs to support adding and managing percentage based dimensions in your app.

The Percent Support library adds support for the PercentLayoutHelper.PercentLayoutParams interface and various classes, such as PercentFrameLayout and PercentRelativeLayout.

The Gradle build script dependency identifier for this library is as follows:

com.android.support:percent:24.2.0

App Recommendation Support Library for TV

The App Recommendation package provides APIs to support adding content recommendations in your app running on TV devices.

The App library adds support for annotations, such as ContentRecommendation.ContentMaturity and various classes, such as ContentRecommendation and RecommendationExtender.

The Gradle build script dependency identifier for this library is as follows:

com.android.support:recommendation:24.2.0
This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.