Widget就是平時所說的桌面小部件紧卒,可以很方便的在桌面上進(jìn)行操作,但是本質(zhì)上它是一個廣播接收器势篡。直接看代碼传睹。
public class TestWidget extends AppWidgetProvider{
public static final String WIDGET_BUTTON = "widget_button";
@Override
//接收廣播
public void onReceive(Context context, Intent intent) {
super.onReceive(context, intent);
}
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
super.onUpdate(context, appWidgetManager, appWidgetIds);
}
點(diǎn)進(jìn)AppWidgetProvider耳幢,可以看到它是繼承BroadcastReceiver的。onUpdate()在用戶把小部件拖到桌面欧啤,創(chuàng)建Widget實(shí)例時會調(diào)用睛藻。onReceive()在接收廣播的時候會被調(diào)用。所以在使用Widget的時候應(yīng)該在AndroidManifest中注冊.邢隧。且由于當(dāng)程序開始的時候就監(jiān)聽店印,所以采用靜態(tài)注冊。
<receiver android:name=".TestWidget">
<!--將該BroadcastReceiver當(dāng)成桌面控件-->
<intent-filter>
<action android:name="android.appwidget.action.APPWIDGET_UPDATE"/>
</intent-filter>
<!--指定桌面控件的meta-data-->
<meta-data android:name="android.appwidget.provider"
android:resource="@layout/widget_setting"/>
</receiver>
- action里面表示接收系統(tǒng)發(fā)來的有關(guān)這個app的所有widget的消息倒慧。
- meta-data 指定了對應(yīng)的資源文件按摘。name 是指定metadata名包券,
resource是指定對應(yīng)的資源路徑。那我們就把指定的資源文件貼出來炫贤。
<appwidget-provider
xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:initialLayout="@layout/layout_widget"
android:minHeight="140dp"
android:minWidth="140dp"
android:previewImage="@drawable/smile"
android:updatePeriodMillis="2000"
android:widgetCategory="home_screen"
>
</appwidget-provider>
簡單解釋一下:
- initialLayout : 加載到桌面時對應(yīng)的布局文件
- minWidth : 最小寬度
- minHeight : 最小高度
- previewImage : 預(yù)覽圖片
- updatePeriodMillis : 更新widget的時間間隔(ms)
- widgetCategory : widget可以被顯示的位置溅固。home_screen表示可以將widget添加到桌面,keyguard表示widget可以被添加到鎖屏界面兰珍。
加載在桌面的布局文件如下:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical"
android:layout_width="match_parent"
android:layout_height="match_parent">
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:textAppearance="?android:attr/textAppearanceLarge"
android:text="Large Text"
android:id="@+id/widget_text_View"
android:layout_gravity="center_horizontal"/>
<Button
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="New Button"
android:id="@+id/wighet_button"
android:layout_gravity="center_horizontal"/>
</LinearLayout>
第一個注意的地方侍郭,widget支持的控件有限,基本上包括以下幾種:AnalogClock掠河、Button亮元、Chronometer、ImageButton口柳、ImageView、ProgressBar有滑、TextView跃闹、ViewFlipper、ListView毛好、GridView望艺、StackView、AdapterView肌访、Flipper找默。其他就顯示不出來
前面準(zhǔn)備工作做的差不多了,現(xiàn)在就是加載布局文件了吼驶。利用RemoteViews可以直接加載整個布局文件惩激。在onUpdate()中的代碼如下
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
super.onUpdate(context, appWidgetManager, appWidgetIds);
Log.i(TAG, "onUpdate");
//指定加載的頁面布局文件
RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.layout_widget);
Intent intent = new Intent();
intent.setClass(context, TestWidget.class);
intent.setAction(WIDGET_BUTTON);
PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intent, 0); remoteViews.setOnClickPendingIntent(R.id.wighet_button, pendingIntent);
//
appWidgetManager.updateAppWidget(appWidgetIds, remoteViews);
}
為Button設(shè)置點(diǎn)擊事件是remoteViews.setOnClickPendingIntent(R.id.wighet_button, pendingIntent);
傳入的第一參數(shù)是Button的id,第二個是PendingIntent,蟹演,我的理解是不立即執(zhí)行的意圖》缱辏現(xiàn)在是想點(diǎn)擊了Button然后發(fā)送廣播,在onReceive()中更新TextView的內(nèi)容酒请。
@Override
//接收廣播
public void onReceive(Context context, Intent intent) {
super.onReceive(context, intent);
Log.i(TAG, "onReceive");
if (intent != null && TextUtils.equals(intent.getAction(), WIDGET_BUTTON)){
Log.i(WIDGET_BUTTON, "I am clicked");
RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.layout_widget);
//設(shè)置文字的內(nèi)容
remoteViews.setTextViewText(R.id.widget_text_View, "be clicked");
AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
//將AppWidgetProvider的子類實(shí)例包裝成ComponentName
ComponentName componentName = new ComponentName(context, TestWidget.class);
appWidgetManager.updateAppWidget(componentName, remoteViews);
}
}
第二個注意的地方骡技,RemoteViews 絕對不能復(fù)用,據(jù)說Binder data size limit is 512k羞反,由于傳輸?shù)絘ppWidget進(jìn)程中的Binder最大數(shù)據(jù)量是512K布朦,并且RemoteView也不會每次清理, 所以如果每次都使用同一個RemoteView進(jìn)行傳輸會因?yàn)橐绯龆鴪箦e昼窗。所以必須每次重新建一個RemoteView來傳輸是趴。
這樣一來一去,基本上就實(shí)現(xiàn)了一個可以操作的widget澄惊。如果想接收其他地方發(fā)的廣播右遭,需要在AndroidManifest中注冊做盅,然后在onReceive()中進(jìn)行相關(guān)操作。
此時應(yīng)該有圖窘哈,但是圖不見了吹榴,自行腦補(bǔ)一個TextView下有個Button。
當(dāng)綁定多個Button或者view設(shè)置點(diǎn)擊事件的時候滚婉,如果只是設(shè)置Intent的Action不同图筹,好像不能分辨,就是所有的按鈕都是一個功能让腹,我的做法是將PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intent, 0);
的第二個參數(shù)設(shè)置的不同远剩,這樣就可以分辨。