Android 2.3 Gingerbread

Package android.appwidget

Android allows applications to publish views to be embedded in other applications.

See:
          Description

Class Summary
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.
 

Package android.appwidget Description

Android allows applications to publish views to be embedded in other applications. These views are called widgets, and are published by "AppWidget providers." The component that can contain widgets is called a "AppWidget host."

For more information, see the AppWidgets documentation in the Dev Guide.

AppWidget Providers

Any application can publish widgets. All an application needs to do to publish a widget is to have a BroadcastReceiver that receives the AppWidgetManager.ACTION_APPWIDGET_UPDATE intent, and provide some meta-data about the widget. Android provides the AppWidgetProvider class, which extends BroadcastReceiver, as a convenience class to aid in handling the broadcasts.

AppWidget Hosts

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 more information on implementing your own widget host, see the AppWidgetHost class.


Android 2.3 Gingerbread