android.appwidget類剖析

 隨著android 1.5的普及很多網友發現SDK中多出了appwidget這個框架。作為使用Java語言設計的Widget相比目前主流的W3C Widget有更好的運行效率和底層控制能力，今天我們就android平台上的Widget開發做主要的講解。

首先我們需要在androidmanifest.XML文件中加入receiver節點來接收系統廣播，聲明BroadcastReceiver類的方法可以直接使用intent filter來過濾系統信息，下面來自SDK中的寫法。

<receiver android:name="TestAppWidgetProvider" android:label="@string/cwj" android:icon="@drawable/smart_icon">
<intent-filter>
<action android:name="android.appwidget.action.APPWIDGET_UPDATE" /> //這裡我們需要捕獲的是APPWIDGET_UPDATE這個動作
</intent-filter>
<meta-data android:name="android.appwidget.provider" android:resource="@XML/appwidget_info" /> //定義meta數據，見下面的appwidget-provider
</receiver>

我們定一個AppWidgetProviderInfo 結構，用來描述這個widget的外觀，這裡和layout的布局有些相似，可以設置最小的寬度為40dp，最小高度為30dp。

<appwidget-provider XMLns:android="http://schemas.android.com/apk/res/android" android:minWidth="40dp"
android:minHeight="30dp"
android:updatePeriodMillis="86400000" //回調Timer，單位為毫秒。這裡是1天=60X60X24X1000，android手機的電能有限，頻率不能太高，最好讓用戶自己控制
android:initialLayout="@layout/test_appwidget" //初始化時的主要布局
android:configure="com.android.tests.appwidgethost.TestAppWidgetConfigure" >
</appwidget-provider>

在Widget中主要使用AppWidgetProvider做基類，剛才我們定義的BroadcastReceiver主要是更新動作ACTION_APPWIDGET_UPDATE ，與此之外還有ACTION_APPWIDGET_DELETED、ACTION_APPWIDGET_ENABLED和ACTION_APPWIDGET_DISABLED分別表示刪除是、啟用和禁用時觸發的事件，這裡是系統廣播。我們通過 BroadcastReceiver類的onReceive方法來捕獲。

下面的Java廣播動作獲取代碼如下:

public void onReceive(Context context, Intent intent) {
String action = intent.getAction(); //獲取當前的動作
if (AppWidgetManager.ACTION_APPWIDGET_UPDATE.equals(action)) { //如果是ACTION_APPWIDGET_UPDATE動作則
Bundle extras = intent.getExtras();
if (extras != null) {
int[] appWidgetIds = extras.getIntArray(AppWidgetManager.EXTRA_APPWIDGET_IDS);
if (appWidgetIds != null && appWidgetIds.length > 0) {
this.onUpdate(context, AppWidgetManager.getInstance(context), appWidgetIds);
}
}
}
else if (AppWidgetManager.ACTION_APPWIDGET_DELETED.equals(action)) { //動作2
Bundle extras = intent.getExtras();
if (extras != null) {
int[] appWidgetIds = extras.getIntArray(AppWidgetManager.EXTRA_APPWIDGET_IDS);
if (appWidgetIds != null && appWidgetIds.length > 0) {
this.onDeleted(context, appWidgetIds);
}
}
}
else if (AppWidgetManager.ACTION_APPWIDGET_ENABLED.equals(action)) { //動作3
this.onEnabled(context);
}
else if (AppWidgetManager.ACTION_APPWIDGET_DISABLED.equals(action)) { //動作4
this.onDisabled(context);
}
}

本文我們主要簡單的講述下android平台Widget的框架，以後我們將會通過實際的例子來講解，我們看到這裡的widget和常見的iphone上dashboard等w3c使用Html+JS以AJax方式的小工具不太一樣，不過整體開發起來比android標准的程序更簡單，主要是考慮ui的繪制以及網絡通訊，推薦大家多看看apache通訊類。