1<body>
2<p>Contains the components necessary to create "app widgets", which users can embed in other
3applications (such as the home screen) to quickly access application data and services without
4launching a new activity.</p>
5
6<p>For more information, see the
7<a href="{@docRoot}guide/topics/appwidgets/index.html">App Widgets</a> guide.</p>
8{@more}
9
10<p>The behavior of an app widget is published by an "app widget provider."  An "app widget host" is
11a component that can contain app widgets (such as the Home screen).</p>
12
13<p>Any application can publish app widgets (as an app widget provider).  All an application needs to
14do to publish an app widget is
15provide a {@link android.content.BroadcastReceiver} that receives the {@link
16android.appwidget.AppWidgetManager#ACTION_APPWIDGET_UPDATE} intent
17and provide some metadata about the app widget.  Android provides the
18{@link android.appwidget.AppWidgetProvider} class, which extends {@link
19android.content.BroadcastReceiver}, as a convenience class to define the app widget behavior and aid
20in handling the broadcasts.</p>
21
22<p>App widget hosts are the containers in which widgets can be placed.  Most of the look and feel
23details are left up to the widget hosts.  For example, the home screen has one way of viewing
24widgets, but the lock screen could also contain widgets, and it would have a different way of
25adding, removing and otherwise managing widgets.</p>
26
27<p>For information about implementing an app widget host, see the {@link
28android.appwidget.AppWidgetHost} class.</p>
29
30</body>
31
32