Jollen 的 Android 教學,#25: HelloAppWidgetProvider.ja

Jollen的Android教學,#25:HelloAppWidgetProvider.java程式碼說明

转载自：http://blog.chinaunix.net/u/14644/showart_1998061.html

HelloAppWidgetProvider.java程式碼說明

圖1:HelloAppWidgetProvider的設計

圖1是目前我們的HelloAppWidget範例設計，說明如下：

onUpdate():收到ACTION_APPWIDGET_UPDATE廣撥時，框架會callback此method

onDelete():收到ACTION_APPWIDGET_DELETE廣撥時，框架會callback此method

AppWidgetManager:管理AppWidget的類別

先前，在AndroidManifest.xml裡我們讓HelloAppWidgetProider類別可以接收ACTION_APPWIDGET_UPDATE廣撥事件；ACTION_APPWIDGET_UPDATE是最主要的AppWidget事件，當AppWidgetProvider被要求為AppWidget提供”RemoteView”時，就會收到這個事件。

什麼是RemoteViews？

什麼是RemoteView呢？先看一下框架的設計，如圖2。

簡單來說，「RemoteViews」就是表示UI的類別。res/layout/main.xml描述了應用程式的UI，UI裡當然包含許多組件(Widget)，而在先前的教學裡講到了一個觀念「Android應用程式的UI就是一個Viewtree」，viewtree就是「ViewHierarchy」。

總結來說，RemotViews是一個用來表示ViewHierarchy的類別。透過RemoteViews可以找到UI裡的每一個組件。

圖2:RemoteView的設計（點擊看全圖）

程式說明:HelloAppWidgetProvider.java

onUpdate()的程式實作：

publicvoidonUpdate(Contextcontext,AppWidgetManagerappWidgetManager,int[]appWidgetIds){

finalintN=appWidgetIds.length;

for(inti=0;i<N;i++){

intappWidgetId=appWidgetIds[i];

updateAppWidget(context,appWidgetManager,appWidgetId);

}

}

說明如下：

1.onUpdate()負責更新「已經安裝」在桌面上的AppWidget內容，因此我們實作一個updateAppWidget()來進行真正更新的工作

2.onUpdate()的第二個參數為AppWidgetManager，這是一個「管理AppWidgetProvider」的類別，我們必須透過框架callback本方法時回傳給我們的AppWidgetProvider物件，來更新桌面上的AppWidget

3.onUpdate()的第三個參數appWidgetIds陣列，存放需要更新的AppWidgetID；框架會將需要更新的AppWidget之ID回傳給onUpdate()，程式必須負責「更新每一個需要更新的AppWidget。」

更新AppWidget的方式是透過AppWidgetManager來完成，程式實作：

staticvoidupdateAppWidget(Contextcontext,AppWidgetManagerappWidgetManager,intappWidgetId){

CharSequencetext;

text="www.jollen.org";

RemoteViewsviews=newRemoteViews(context.getPackageName(),R.layout.main);

views.setTextViewText(R.id.appwidget_text,text);

appWidgetManager.updateAppWidget(appWidgetId,views);

}

}

說明如下：

1.透過UIlayout取得自已的「ViewHierarchy」(UI)，以前面介紹的RemoteViews物件表示

2.如圖2，呼叫RemoteView的setTextViewText()方法，修改UI裡的「R.id.appwidget_text」組件，變更文字內容

3.呼叫AppWidgetProvider的updateAppWidget()方法，更新我們所指定的AppWidget，將其UI更新為RemoteView的UI

4.updateAppWidget()的第二個參數為RemoteView，即說明1.取得的UI，說明2.修改了此UI裡的”R.id.appwidget_text”組件，最後透過AppWidgetManager更新AppWidget的UI

--jollen