Note: With the release of Android 9.0 (API level 28) there is
a new version of the support library called
AndroidX which is part of Jetpack.
The AndroidX library
contains the existing support library and also includes the latest Jetpack components.
You can continue to use the support library. Historical artifacts (those versioned 27 and earlier, and packaged as
remain available on Google Maven. However, all new library development
will occur in the AndroidX library.
We recommend using the AndroidX libraries in all new projects. You should also consider migrating existing projects to AndroidX as well.
The Support Libraries provide a wide range of classes for building apps, from fundamental app components, to user interface widgets, to media handling, to TV app components. Many of the classes are backward compatible implementations, but some of them are new features in their own right.
This document provides an overview of the important categories of features available in the support library, and specific classes you should know about when building your app.
For information about how to add support library code to your app development project, see Support Library Setup. For information on how to include specific support library packages in your project, see Support Library Packages.
These Support Library classes provide backward-compatible implementations of important, core platform features. These implementation typically extend earlier versions of the class to handle new methods and features added in more recent releases of the platform. Some of these classes are complete, static implementations of the framework APIs.
ActivityCompat- Includes backward-compatible implementation for recent, key features of activities, such as a Runtime Permissions and animation transitions.
FragmentActivity- Provides backward-compatible implementation for activities to use the support library versions of
AppCompatActivity- Provides Material color themes, widget tinting, and app bar support to earlier devices. Use of this class requires that you use
Theme.AppCompatthemes for consistent visual presentation.
Fragment- Provides a stand-alone implementation of the framework
Fragmentclass. This class must be used with
ContextCompat- Provides support for features introduced in more recent releases of the
Contextclass, including permissions support, file access, and color information.
IntentCompat- Provides support for features introduced in more recent releases of the
Intentclass, including methods for selecting and starting specific activities.
Loader- Provides a static implementation of the framework
Loaderclass, and is the base class for the
Preference- This class and its sub-classes provide implementations of app settings user interface in a backward-compatible way.
ContentResolverCompat- Provides support for features introduced in more recent releases of the
ContentResolverclass, specifically the
query()method with support for cancelling a query in progress.
These support library classes provide implementations of key user interface widgets and behaviors, and help you create more modern app interfaces on earlier devices. A few of these widgets are only available through the support library.
General-purpose layout containers
These support classes provide user interface containers that can be adapted for different design use cases.
RecyclerView- Creates a layout for displaying long lists, using a strategy to avoid high memory consumption. This class allows you to create a limited window view into a larger data set, thus avoiding consuming large amounts of memory when displaying the list. For more information about using
RecyclerView, see the Recycler View guide.
ViewPager- Provides a layout that allows the user to flip left and right through pages of data.
GridLayout- Provides a layout with its children in a rectangular grid, supporting arbitrary spans of contiguous cells and flexible space distribution. This class provides a backward compatible version of the
GridLayoutclass, introduced in Android 4.0 (API level 14).
PercentRelativeLayout- Provide layouts that support percentage based dimensions and margins for its child views and content.
Special-purpose layout containers
These support classes provide compatible implementations of specific layout patterns, such as drawer views that can be pulled from the edge of the screen, sliding panels, and nesting lists within lists.
DrawerLayout- Creates a layout that allows for interactive drawer views to be pulled out from the edge of the view window.
SlidingPaneLayout- Provides a horizontal, multi-pane layout for use at the top level of an app user interface for creating layouts that can smoothly adapt across many different screen sizes, expanding on larger screens and collapsing to fit on smaller screens.
NestedScrollView- A scrolling layout that supports nesting of other scrolling views, allowing you to create lists, with items containing an additional, child lists. These nested lists can contain items that scroll horizontally or vertically, separately from the parent list.
SwipeRefreshLayout- Provides a layout to support refreshing data for lists or other layout with a finger swipe gesture.
Views, dialogs, and widgets
The support libraries provide a number of classes for displaying content and providing user interaction elements in a layout.
CardView- A support library custom class for creating Material Design style display cards. This class is based on FrameLayout with rounded corners and a drop shadow.
AppCompatDialogFragment- Provides a consistently styled dialogs by extending
NotificationCompat- Provides support for newer notification styles in a backward compatible way.
SearchView- Provides a class for the user to enter a search query and submit a request to a search provider, which is primarily intended for use in an app bar.
The support libraries provide a number of classes for implementing Material
Design user interface recommendations. Many of these classes are provided in
CoordinatorLayout- Provides a top-level container for layouts incorporating Material Design components and behavior. This class can also be used as a container for specific interaction with one or more child views.
AppBarLayout- Provides an implementation of many of the scrolling features of Material Design's app bar concept.
FloatingActionButton- Creates floating button for displaying a special type of promoted action. This Material Design user interface element is shown as a circled icon floating above the app user interface. For more information, see Add a Floating Action Button.
DrawerLayout- Creates a navigation drawer—a UI panel that shows your app's main navigation menu. It appears when the user swipes a finger from the left edge of the screen or taps the drawer icon in the app bar. For more information, see Create a Navigation Drawer.
TabLayout- Provides a layout for displaying tabbed pages. This widget is designed for use with the
Snackbar- Provides a widget for displaying lightweight feedback about an operation using the snackbar pop-up.
android.support.v4.view.accessibility package provides
compatibility classes for implementing accessibility features introduced in
API level 14 and later, which allow accessibility services to observe and
identify user interaction with items displayed on screen.
ExploreByTouchHelper- Provides accessibility support in a custom View that represent a collection of view-like logical items.
The Android Support Library provides a backport of the media router functionality to devices running versions of the platform earlier than Android 4.1 (API level 16). These classes allow control of media playback across connected Android devices:
MediaRouter- Enables applications to control the routing of media channels and streams from the current device to external speakers and destination devices.
MediaControllerCompat- Allows an app to interact with an ongoing media session. Apps can provide media control buttons through this mechanism and send other playback commands to the session.
MediaSessionCompat- Provides a remote control interface for media playback, enabling interaction with media controllers, volume keys, media buttons, and transport controls in other apps or on separate devices.
The Android SDK provides libraries to support form factors such as large screens and their associated controllers. An app can depend on the appropriate support library to provide functionality across a wide range of platform versions, and can provide content on external screens, speakers, and other destination devices.
- android.support.v17.leanback.* packages
The Android SDK provides libraries to support watches. These libraries provide functionality to apps that is available to users whenever they are wearing a watch.
- android.support.wear.* packages
The Android Support Library offers a number of features that are not built into the framework. These libraries offer a range of utilities that apps can use.
- android.support.v4.util package