Skip to content

Most visited

Recently visited

added in API level 3


Contains the components necessary to create "app widgets", which users can embed in other applications (such as the home screen) to quickly access application data and services without launching a new activity.

For more information, see the App Widgets guide.

The behavior of an app widget is published by an "app widget provider." An "app widget host" is a component that can contain app widgets (such as the Home screen).

Any application can publish app widgets (as an app widget provider). All an application needs to do to publish an app widget is provide a BroadcastReceiver that receives the ACTION_APPWIDGET_UPDATE intent and provide some metadata about the app widget. Android provides the AppWidgetProvider class, which extends BroadcastReceiver, as a convenience class to define the app widget behavior and aid in handling the broadcasts.

App widget hosts are the containers in which widgets can be placed. Most of the look and feel details are left up to the widget hosts. For example, the home screen has one way of viewing widgets, but the lock screen could also contain widgets, and it would have a different way of adding, removing and otherwise managing widgets.

For information about implementing an app widget host, see the AppWidgetHost class.


AppWidgetHost AppWidgetHost provides the interaction with the AppWidget service for apps, like the home screen, that want to embed AppWidgets in their UI. 
AppWidgetHostView Provides the glue to show AppWidget views. 
AppWidgetManager Updates AppWidget state; gets information about installed AppWidget providers and other AppWidget related state. 
AppWidgetProvider A convenience class to aid in implementing an AppWidget provider. 
AppWidgetProviderInfo Describes the meta data for an installed AppWidget provider. 
This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields


Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

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.

Take a short survey?
Help us improve the Android developer experience. (April 2018 — Developer Survey)