Android中Widget实例

应用程序窗口小部件（Widget）是微小的应用程序视图，可以被嵌入到其它应用程序中（比如桌面）并接收周期性的更新。

为了创建一个Widget，需要AppWidgetProviderInfo与AppWidgetProvider。AppWidgetProviderInfo主要为Widget描述metadata，如Widget的布局，更新频率和AppWidgetProvider类，这在xml里面定义。AppWidgetProvider定义基本的方法允许你基于广播事件与Widget进行交互。通过它，当Widget更新，可用，不可用或者删除的时候，你将收到广播。

下面的截屏显示本实例的效果图：

此Widget很简单，就是以闹铃面板为背景，在上面显示字符串。

由于涉及的文件比较多，先看一下文件存放目录图：

注：在res/drawable-ldpi/加入背景资源图片。可以看到res下面有三个文件夹：drawable-hdpi, drawable-ldpi, drawable-mdpi.三个文件夹分别对应不同的屏幕分辨率。

• drawable-hdpi里面存放高分辨率的图片，如：WVGA (480x800)，FWVGA (480x854)

• drawable-mdpi里面存放中等分辨率的图片，如HVGA (320x480)

• drawable-ldpi里面存放低分辨率的图片，如QVGA (240x320)

为了使我们的程序满足不同分辨率的机型，Android在res下面分别建立不同文件夹，我们可以把不同分辨率机型的图片放在不同目录下面。

源代码如下：

首先，申明AppWidgetProvider类在应用的AndroidManifest.xml文件里 ：

• AndroidManifest.xml:

<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.android.test" android:versionCode="1" android:versionName="1.0"> <application android:icon="@drawable/clockgoog_dial" android:label="@string/app_name"> <receiver android:name=".TestWidget" android:label="@string/app_name"> <intent-filter> <action android:name="android.appwidget.action.APPWIDGET_UPDATE" /> </intent-filter> <meta-data android:name="android.appwidget.provider" android:resource="@xml/widget_provider" /> </receiver> </application> <uses-sdk android:minSdkVersion="7" /> </manifest>

注：<receiver>元素需要andriod:name属性，它指明被Widget使用的AppWidgetProvider.

<intent-filter>元素必须包含带有android:name属性的<action>元素。这一属性指明AppWigetProvider可接收ACTION_APPWIDGET_UPDATE广播。这是你必须明确声明的唯一广播。AppWidgetManager自动发送Widget广播到AppWidgetProvider。

<meta-data>元素指明AppWidgetProviderInfo资源，需要如下属性：

• android:name-指明元数据名称。使用android.appwidget.provider把数据指定为对AppWidgetProviderInfo的描述。
• android:resource-指明AppWidgetProviderInfo资源的位置。

其次，增加AppWidgetProviderInfor元数据在res/xml/widget_provider.xml中:

• res/xml/widget_provider.xml:

<?xml version="1.0" encoding="utf-8"?> <appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android" android:minWidth="50dip" android:minHeight="50dip" android:updatePeriodMillis="10000" android:initialLayout="@layout/main"/>

注：AppWidgetProviderInfo定义基本的Widget属性，如最小布局维数，初始的布局资源，更新Widget频率和在创建时间启动Activity的配置。在XML资源里使用单一的<appwidget-provider>元素定义AppWidgetProviderInfo对象并且把它保存在工程的res/xml/文件夹下。

然后，创建Widget布局文件在res/layout/main.xml中：

• res/layout/main.xml:

<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:orientation="vertical" android:layout_width="fill_parent" android:layout_height="fill_parent" android:background="@drawable/clockgoog_dial"> <TextView android:id="@+id/textview" android:layout_width="fill_parent" android:layout_height="wrap_content" android:text="@string/hello" android:textSize="10px" android:textColor="#ff0000"/> </LinearLayout>

注：你必须在XML里为你的Widget定义一个初始的布局文件，然后保存在工程的res/layout/目录下。如果你熟悉在XML中声明布局，那么创建Widget布局是简单的。你可以使用View对象设计你的Widget，然而你必须注意Widget基于RemoteViews，它并不支持布局或者view控件中的每一种。

最后，使用AppWidgetProvider类在TestWidget.java中：

package com.android.test; import android.appwidget.AppWidgetManager; import android.appwidget.AppWidgetProvider; import android.content.Context; public class TestWidget extends AppWidgetProvider { /** Called when the activity is first created. */ @Override public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) { super.onUpdate(context, appWidgetManager, appWidgetIds); } }

注：继承于BroadcastReceiver的AppWidgetProvider类是一种很方便处理Widget广播的类。AppWidgetProvider只接收与Widget相关的事件广播，如当Widget更新，删除，可用和不可用的时候。当这些广播事件发生的时候，AppWidgetProvider收到如下的方法调用：onUpdated,onDeleted,onEnabled,onDisabled,onReceive。

最重要的AppWidgetProvider回调函数是onUpdated，因为当每一个Widget增加的时候它都会被调用（除非你使用配置Activity）。如果你的Widget接收任意用户交互事件，那么你需要在回调函数中注册事件handler。如果你的Widget没有创建临时文件或者数据库，或者执行需要clean－up的工作，那么onUpdated可能是你需要注册的唯一回调函数。

如果需要了解详细的Widget信息，请参考Android官方文档：file:///work/android-sdk-linux_x86-1.6_r1/docs/guide/topics/appwidgets/index.html。