[size=large][color=green]應(yīng)用程序窗口小部件App Widgets
應(yīng)用程序窗口小部件（Widget）是微小的應(yīng)用程序視圖，可以被嵌入到其它應(yīng)用程序中（比如桌面）并接收周期性的更新。你可以通過一個(gè)App Widget provider來發(fā)布一個(gè)Widget。可以容納其它App Widget的應(yīng)用程序組件被稱為App Widget宿主。下面的截屏顯示了一個(gè)音樂App Widget。

這篇文章描述了如何使用App Widget Provider發(fā)布一個(gè)App Widget。
編輯本段 回目錄基礎(chǔ)知識(shí)The Basics
為了創(chuàng)建一個(gè)App Widget，你需要下面這些：
AppWidgetProviderInfo 對(duì)象
描述一個(gè)App Widget元數(shù)據(jù)，比如App Widget的布局，更新頻率，以及AppWidgetProvider 類。這應(yīng)該在XML里定義。
AppWidgetProvider 類的實(shí)現(xiàn)
定義基本方法以允許你編程來和App Widget連接，這基于廣播事件。通過它，當(dāng)這個(gè)App Widget被更新，啟用，禁用和刪除的時(shí)候，你都將接收到廣播通知。
視圖布局
為這個(gè)App Widget定義初始布局，在XML中。
另外，你可以實(shí)現(xiàn)一個(gè)App Widget配置活動(dòng)。這是一個(gè)可選的活動(dòng)Activity，當(dāng)用戶添加App Widget時(shí)加載并允許他在創(chuàng)建時(shí)來修改App Widget的設(shè)置。
下面的章節(jié)描述了如何建立這些組件：
編輯本段 回目錄在清單中聲明一個(gè)應(yīng)用小部件

首先，在應(yīng)用程序AndroidManifest.xml文件中聲明AppWidgetProvider 類，比如：
復(fù)制到剪貼板 XML/HTML代碼
1. <receiver android:name="ExampleAppWidgetProvider" >
2.
3. <intent-filter>
4.
5. <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
6.
7. </intent-filter>
8.
9. <meta-data android:name="android.appwidget.provider"
10.
11. android:resource="@xml/example_appwidget_info < src="http://hi.images.csdn.net/js/blog/tiny_mce/themes/advanced/langs/zh.js" type="text/javascript"> < srcsrc="http://hi.images.csdn.net/js/blog/tiny_mce/plugins/syntaxhl/langs/zh.js" type="text/javascript"> " />
12.
13. </receiver>
<receiver>元素需要Android:name屬性，它指定了App Widget使用的AppWidgetProvider 。
<intent-filter> 元素必須包括一個(gè)含有android:name屬性的<action>元素。該元素指定AppWidgetProvider接受ACTION_APPWIDGET_UPDATE 廣播。這是唯一你必須顯式聲明的廣播。當(dāng)需要的時(shí)候，AppWidgetManager 會(huì)自動(dòng)發(fā)送所有其他App Widget廣播給AppWidgetProvider。
<meta-data> 元素指定了AppWidgetProviderInfo 資源并需要以下屬性：
?android:name – 指定元數(shù)據(jù)名稱。
?android:resource – 指定AppWidgetProviderInfo 資源路徑。
編輯本段 回目錄增加AppWidgetProviderInfo元數(shù)據(jù)
AppWidgetProviderInfo定義一個(gè)App Widget的基本特性，比如最小布局尺寸，初始布局資源，刷新頻率，以及（可選的）創(chuàng)建時(shí)加載的一個(gè)配置活動(dòng)。使用單獨(dú)的一個(gè)<appwidget-provider>元素在XML資源里定義AppWidgetProviderInfo 對(duì)象并保存到項(xiàng)目的res/xml/目錄下。
比如：
復(fù)制到剪貼板 XML/HTML代碼
1. <appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
2.
3. android:minWidth="294dp" <!-- density-independent pixels -->
4.
5. android:minHeight="72dp"
6.
7. android:updatePeriodMillis="86400000" <!-- once per day -->
8.
9. android:initialLayout="@layout/example_appwidget"
10.
11. android:configure="com.example.android.ExampleAppWidgetConfigure" >
12.
13. </appwidget-provider>
下面是<appwidget-provider>屬性的總結(jié)：
?minWidth 和minHeight 屬性的值指定了這個(gè)App Widget布局需要的最小區(qū)域。
缺省的App Widgets所在窗口的桌面位置基于有確切高度和寬度的單元網(wǎng)格。如果App Widget的最小長寬和這些網(wǎng)格單元的尺寸不匹配，那么這個(gè)App Widget將收縮到最接近的單元尺寸。（參見App Widget Design Guidelines 以獲取更多關(guān)于桌面單元尺寸的信息）
因?yàn)樽烂娌季址较?#xff08;由此，單元的尺寸）可以變化，按照拇指規(guī)則，你應(yīng)該假設(shè)最壞情況單元尺寸是74像素高和寬。不過，你必須從最后的尺寸中減去2以把像素計(jì)算過程中產(chǎn)生的任何的整數(shù)舍入誤差考慮在內(nèi)。要找到像素密度無關(guān)的最小寬度和高度，使用這個(gè)公式：
(number of cells * 74) - 2
遵循這個(gè)公式，你應(yīng)該使用72dp為每一個(gè)單元高度，294dp為四個(gè)單元寬度。
?updatePerdiodMillis 屬性定義了App Widget框架調(diào)用onUpdate()方法來從AppWidgetProvider請(qǐng)求一次更新的頻度。實(shí)際更新時(shí)間并不那么精確，而且我們建議更新頻率越低越好-也許每小時(shí)不超過一次以節(jié)省電源。你也許還會(huì)允許用戶在配置中調(diào)整這個(gè)頻率-一些人可能想每15分鐘一次股票報(bào)價(jià)，或者一天只要四次。
?initialLayout屬性指向定義App Widget布局的資源。
?configure屬性定義了Activity ，當(dāng)用戶添加App Widget時(shí)啟動(dòng)，以為他或她配置App Widget特性。這是可選的（閱讀下面的Creating an App Widget Configuration Activity）。
參見AppWidgetProviderInfo 類以獲取更多可以被<appwidget-provider>元素接受的屬性信息。
編輯本段 回目錄創(chuàng)建App Widget布局
你必須在XML中為你的App Widget定義一個(gè)初始布局并保存到項(xiàng)目的res/layout/ 目錄下。你可以使用如下所列的視圖對(duì)象來設(shè)計(jì)你的App Widget，但是在此之前，請(qǐng)先閱讀并理解App Widget Design Guidelines.
如果你熟悉在XML中聲明布局，那么創(chuàng)建這個(gè)App Widget布局是很簡單的。但是，你必須意識(shí)到那個(gè)App Widget布局是基于RemoteViews, 這并不支持所有類型的布局或視圖小部件。
一個(gè)RemoteViews對(duì)象（以及，相應(yīng)的，一個(gè)App Widget）可以支持下面這個(gè)布局類：
以及下面的小部件類：
?FrameLayout
?LinearLayout
?RelativeLayout
?AnalogClock
?Button
?Chronometer
?ImageButton
?ImageView
?ProgressBar
?TextView
不支持這些類的派生。
編輯本段 回目錄使用AppWidgetProvider類
你必須通過在清單文件中使用<receiver>元素來聲明你的AppWidgetProvider 類實(shí)現(xiàn)為一個(gè)廣播接收器（參見上面的Declaring an App Widget in the Manifest）。
AppWidgetProvider 類擴(kuò)展BroadcastReceiver 為一個(gè)簡便類來處理App Widget廣播。AppWidgetProvider只接收和這個(gè)App Widget相關(guān)的事件廣播，比如這個(gè)App Widget被更新，刪除，啟用，以及禁用。當(dāng)這些廣播事件發(fā)生時(shí)，AppWidgetProvider 將接收到下面的方法調(diào)用：
onUpdate(Context, AppWidgetManager, int[])
這個(gè)方法調(diào)用來間隔性的更新App Widget，間隔時(shí)間用AppWidgetProviderInfo 里的updatePeriodMillis屬性定義（參見添加AppWidgetProviderInfo元數(shù)據(jù)）。這個(gè)方法也會(huì)在用戶添加App Widget時(shí)被調(diào)用，因此它應(yīng)該執(zhí)行基礎(chǔ)的設(shè)置，比如為視圖定義事件處理器并啟動(dòng)一個(gè)臨時(shí)的服務(wù)Service，如果需要的話。但是，如果你已經(jīng)聲明了一個(gè)配置活動(dòng)，這個(gè)方法在用戶添加App Widget時(shí)將不會(huì)被調(diào)用，而只在后續(xù)更新時(shí)被調(diào)用。配置活動(dòng)應(yīng)該在配置完成時(shí)負(fù)責(zé)執(zhí)行第一次更新。（參見下面的創(chuàng)建一個(gè)App Widget配置活動(dòng)Creating an App Widget Configuration Activity。）
onDeleted(Context, int[])
當(dāng)App Widget從宿主中刪除時(shí)被調(diào)用。
onEnabled(Context)
當(dāng)一個(gè)App Widget實(shí)例第一次創(chuàng)建時(shí)被調(diào)用。比如，如果用戶添加兩個(gè)你的App Widget實(shí)例，只在第一次被調(diào)用。如果你需要打開一個(gè)新的數(shù)據(jù)庫或者執(zhí)行其他對(duì)于所有的App Widget實(shí)例只需要發(fā)生一次的設(shè)置，那么這里是完成這個(gè)工作的好地方。
onDisabled(Context)
當(dāng)你的App Widget的最后一個(gè)實(shí)例被從宿主中刪除時(shí)被調(diào)用。你應(yīng)該在onEnabled(Context)中做一些清理工作，比如刪除一個(gè)臨時(shí)的數(shù)據(jù)庫。
onReceive(Context, Intent)
這個(gè)接收到每個(gè)廣播時(shí)都會(huì)被調(diào)用，而且在上面的回調(diào)函數(shù)之前。你通常不需要實(shí)現(xiàn)這個(gè)方法，因?yàn)槿笔〉腁ppWidgetProvider 實(shí)現(xiàn)過濾所有App Widget 廣播并恰當(dāng)?shù)恼{(diào)用上述方法。
注意: 在Android 1.5中， 有一個(gè)已知問題，onDeleted()方法在該調(diào)用時(shí)不被調(diào)用。為了規(guī)避這個(gè)問題，你可以像Group post中描述的那樣實(shí)現(xiàn)onReceive() 來接收這個(gè)onDeleted()回調(diào)。
最重要的AppWidgetProvider 回調(diào)函數(shù)是onUpdated()， 因?yàn)樗窃诿總€(gè)App Widget添加進(jìn)宿主時(shí)被調(diào)用的（除非你使用一個(gè)配置活動(dòng)）。如果你的App Widget 要接受任何用戶交互事件，那么你需要在這個(gè)回調(diào)函數(shù)中注冊(cè)事件處理器。如果你的App Widget不創(chuàng)建臨時(shí)文件或數(shù)據(jù)庫，或者執(zhí)行其它需要清理的工作，那么onUpdated() 可能是你需要定義的唯一的回調(diào)函數(shù)。比如，如果你想要一個(gè)帶一個(gè)按鈕的App Widget，當(dāng)點(diǎn)擊時(shí)啟動(dòng)一個(gè)活動(dòng)，你可以使用下面的AppWidgetProvider實(shí)現(xiàn)：
1. public class ExampleAppWidgetProvider extends AppWidgetProvider {
2.
3.
4.
5. public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
6.
7. final int N = appWidgetIds.length;
8.
9.
10.
11. // Perform this loop procedure for each App Widget that belongs to this provider
12.
13. for (int i=0; i<N; i++) {
14.
15. int appWidgetId = appWidgetIds[i];
16.
17.
18.
19. // Create an Intent to launch ExampleActivity
20.
21. Intent intent = new Intent(context, ExampleActivity.class);
22.
23. PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0);
24.
25.
26.
27. // Get the layout for the App Widget and attach an on-click listener to the button
28.
29. RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.appwidget_provider_layout);
30.
31. views.setOnClickPendingIntent(R.id.button, pendingIntent);
32.
33.
34.
35. // Tell the AppWidgetManager to perform an update on the current App Widget
36.
37. appWidgetManager.updateAppWidget(appWidgetId, views);
38.
39. }
40.
41. }
42.
43. }
這個(gè)AppWidgetProvider 僅定義了onUpdated() 方法，為了定義一個(gè)PendingIntent，來啟動(dòng)一個(gè)活動(dòng)并使用setOnClickPendingIntent(int, PendingIntent)方法把它附著到這個(gè)App Widget的按鈕上。注意它包含了一個(gè)遍歷appWidgetIds中所有項(xiàng)的循環(huán)，這是一個(gè)IDs數(shù)組，每個(gè)ID用來標(biāo)識(shí)由這個(gè)Provider創(chuàng)建的一個(gè)App Widget。這樣，如果用戶創(chuàng)建多于一個(gè)這個(gè)App Widget的實(shí)例，那么它們將被同步更新。不過，對(duì)于所有的App Widget實(shí)例，只有一個(gè)updatePeriodMillis 時(shí)間表被管理。比如，如果這個(gè)更新時(shí)間表被定義為每隔兩個(gè)小時(shí)，而且App Widget的第二個(gè)實(shí)例是在第一個(gè)后面一小時(shí)添加的，那么它們將按照第一個(gè)所定義的周期來更新而第二個(gè)被忽略（它們將都是每2個(gè)小時(shí)進(jìn)行更新，而不是每小時(shí)）。
注意: 因?yàn)檫@個(gè)AppWidgetProvider 是一個(gè)廣播接收器BroadcastReceiver，不能保證你的進(jìn)程在回調(diào)函數(shù)返回后仍然繼續(xù)運(yùn)行（參見應(yīng)用程序基礎(chǔ)>廣播接收器的生命周期Application Fundamentals > Broadcast Receiver Lifecycle以獲取更多信息）。如果你的App Widget設(shè)置過程能持續(xù)幾秒鐘（也許當(dāng)執(zhí)行網(wǎng)頁請(qǐng)求時(shí)）而且你要求你的進(jìn)程繼續(xù)，考慮在onUpdated()方法里啟動(dòng)一個(gè)服務(wù)Service 。從這個(gè)服務(wù)里，你可以執(zhí)行自己的App Widget更新，而不必?fù)?dān)心AppWidgetProvider 由于一個(gè)應(yīng)用程序無響應(yīng)錯(cuò)誤Application Not Responding (ANR)而關(guān)閉。參見Wiktionary sample's AppWidgetProvider，這是個(gè)App Widget運(yùn)行一個(gè)Service的例子。
同樣參見ExampleAppWidgetProvider.Java 例子類。
編輯本段 回目錄接收App Widget廣播意圖
AppWidgetProvider 只是一個(gè)簡便類。如果你想直接接收App Widget 廣播，你可以實(shí)現(xiàn)自己的BroadcastReceiver 或者重寫 onReceive(Context, Intent) 回調(diào)函數(shù)。你需要注意的4個(gè)意圖如下：
?ACTION_APPWIDGET_UPDATE
?ACTION_APPWIDGET_DELETED
?ACTION_APPWIDGET_ENABLED
?ACTION_APPWIDGET_DISABLED
編輯本段 回目錄創(chuàng)建一個(gè)App Widget 配置活動(dòng)
如果你想讓用戶在添加一個(gè)新的App Widget時(shí)調(diào)整設(shè)置，你可以創(chuàng)建一個(gè)App Widget配置活動(dòng)。這個(gè)活動(dòng)將被App Widget宿主自動(dòng)啟動(dòng)并允許用戶在創(chuàng)建時(shí)配置可用的設(shè)置，比如App Widget顏色，尺寸，更新周期或者其它功能設(shè)置。
這個(gè)配置活動(dòng)應(yīng)該在Android清單文件中聲明為一個(gè)通用活動(dòng)。不過，它將被通過ACTION_APPWIDGET_CONFIGURE活動(dòng)而被App Widget宿主啟動(dòng)，因此這個(gè)活動(dòng)需要接受這個(gè)意圖。比如：
1. <activity android:name=".ExampleAppWidgetConfigure">
2.
3. <intent-filter>
4.
5. <action android:name="android.appwidget.action.APPWIDGET_CONFIGURE" />
6.
7. </intent-filter>
8.
9. </activity>
同樣的，活動(dòng)必須在AppWidgetProviderInfo XML 文件中聲明，通過android:configure屬性（參見上面的添加AppWidgetProviderInfo元數(shù)據(jù)Adding the AppWidgetProviderInfo Metadata）。比如，配置活動(dòng)可以聲明如下：
1. <appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
2.
3. ...
4.
5. android:configure="com.example.android.ExampleAppWidgetConfigure"
6.
7. ... >
8.
9. </appwidget-provider>
10.
注意這個(gè)活動(dòng)是用全名聲明的，因?yàn)樗鼘哪愕某绦虬獗灰谩?
這就是所有關(guān)于配置活動(dòng)你一開始需要了解的。現(xiàn)在你需要一個(gè)真實(shí)的活動(dòng)。這兒就有，不過，當(dāng)你實(shí)現(xiàn)這個(gè)活動(dòng)時(shí)記住兩件重要的事情：

? App Widget 宿主調(diào)用配置活動(dòng)而且配置活動(dòng)應(yīng)該總是返回一個(gè)結(jié)果.這個(gè)結(jié)果應(yīng)該包含這個(gè)通過啟動(dòng)該活動(dòng)的意圖傳遞的App Widget ID(以EXTRA_APPWIDGET_ID保存在意圖的附加段Intent extras中)
? 當(dāng)這個(gè) App Widget 被創(chuàng)建時(shí)將不會(huì)調(diào)用onUpdate() 方法(當(dāng)一個(gè)配置活動(dòng)啟動(dòng)時(shí),系統(tǒng)將不會(huì)發(fā)送ACTION_APPWIDGET_UPDATE廣播).配置活動(dòng)應(yīng)該在 App Widget 第一次被創(chuàng)建時(shí)負(fù)責(zé)從AppWidgetManager請(qǐng)求一個(gè)更新.不過, onUpdate() 將在后續(xù)更新中被調(diào)用-只忽略第一次.
參見下面章節(jié)的代碼片斷,該示例說明了如何從配置中返回一個(gè)結(jié)果并更新這個(gè)App Widget.
編輯本段 回目錄從配置活動(dòng)中更新一個(gè)App Widget

當(dāng)一個(gè)App Widget使用一個(gè)配置活動(dòng),那么當(dāng)配置結(jié)束時(shí),就應(yīng)該由這個(gè)活動(dòng)來更新這個(gè)App Widget.你可以直接AppWidgetManager里請(qǐng)求一個(gè)更新來這么做.
下面是恰當(dāng)?shù)母翧pp Widget 以及關(guān)閉配置活動(dòng)這個(gè)過程的一個(gè)概要描述:
1，
首先，從啟動(dòng)這個(gè)活動(dòng)的意圖中獲取App Widget ID：
Intent intent = getIntent();
Bundle extras = intent.getExtras();
if (extras != null) {
mAppWidgetId = extras.getInt(
AppWidgetManager.EXTRA_APPWIDGET_ID,
AppWidgetManager.INVALID_APPWIDGET_ID);
}
2，
實(shí)施你的App Widget 配置。
3，
當(dāng)配置完成后，通過調(diào)用getInstance(Context)獲取一個(gè)AppWidgetManager實(shí)例:
AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
4，
以一個(gè)RemoteViews布局調(diào)用updateAppWidget(int, RemoteViews)更新App Widget:
RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.example_appwidget);
appWidgetManager.updateAppWidget(mAppWidgetId, views);
5，
最后，創(chuàng)建返回意圖，設(shè)置活動(dòng)結(jié)果，并結(jié)束這個(gè)活動(dòng):
Intent resultValue = new Intent();
resultValue.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, mAppWidgetId);
setResult(RESULT_OK, resultValue);
finish();
提示: 當(dāng)你的配置活動(dòng)第一次打開時(shí)，設(shè)置活動(dòng)結(jié)果為RESULT_CANCELED。這樣，如果用戶在結(jié)束之前從活動(dòng)外返回，這個(gè)App Widget 宿主會(huì)接收到配置取消通知而不會(huì)添加這個(gè)App Widget。
參見ApiDemos里面的ExampleAppWidgetConfigure.java 例子。[/color][/size]

總結(jié)

以上是生活随笔為你收集整理的应用程序窗口小部件App Widgets的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。