Android开发指南-窗口小部件（App Widgets）

               

应用程序窗口小部件App Widgets

应用程序窗口小部件（Widget）是微小的应用程序视图，可以被嵌入到其它应用程序中（比如桌面）并接收周期性的更新。你可以通过一个App Widget provider来发布一个Widget。可以容纳其它App Widget的应用程序组件被称为App Widget宿主。下面的截屏显示了一个音乐App Widget。

   

这篇文章描述了如何使用App Widget Provider发布一个App Widget。

基础知识The Basics

为了创建一个App Widget，你需要下面这些：

AppWidgetProviderInfo 对象

描述一个App Widget元数据，比如App Widget的布局，更新频率，以及AppWidgetProvider 类。这应该在XML里定义。

AppWidgetProvider 类的实现

定义基本方法以允许你编程来和App Widget连接，这基于广播事件。通过它，当这个App Widget被更新，启用，禁用和删除的时候，你都将接收到广播通知。

视图布局

为这个App Widget定义初始布局，在XML中。

另外，你可以实现一个App Widget配置活动。这是一个可选的活动Activity，当用户添加App Widget时加载并允许他在创建时来修改App Widget的设置。

下面的章节描述了如何建立这些组件：

在清单中声明一个应用小部件

首先，在应用程序AndroidManifest.xml文件中声明AppWidgetProvider 类，比如：

<receiver android:name="ExampleAppWidgetProvider" >

    <intent-filter>

        <action android:name="android.appwidget.action.APPWIDGET_UPDATE"