to top
Android APIs
Added in API level 3
package

android.appwidget

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 behavrio 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.

Classes

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.