Home | History | Annotate | Download | only in appwidget
      1 <body>
      2 <p>Contains the components necessary to create "app widgets", which users can embed in other
      3 applications (such as the home screen) to quickly access application data and services without
      4 launching 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
     11 a 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
     14 do to publish an app widget is
     15 provide a {@link android.content.BroadcastReceiver} that receives the {@link
     16 android.appwidget.AppWidgetManager#ACTION_APPWIDGET_UPDATE} intent
     17 and provide some metadata about the app widget.  Android provides the
     18 {@link android.appwidget.AppWidgetProvider} class, which extends {@link
     19 android.content.BroadcastReceiver}, as a convenience class to define the app widget behavior and aid
     20 in 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
     23 details are left up to the widget hosts.  For example, the home screen has one way of viewing
     24 widgets, but the lock screen could also contain widgets, and it would have a different way of
     25 adding, removing and otherwise managing widgets.</p>
     26 
     27 <p>For information about implementing an app widget host, see the {@link
     28 android.appwidget.AppWidgetHost} class.</p>
     29 
     30 </body>
     31 
     32