第三章--与Widget的爱恨情仇
Widget就是平时所说的桌面小部件,可以很方便的在桌面上进行操作,但是本质上它是一个广播接收器。直接看代码。
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);
}
点进AppWidgetProvider,可以看到它是继承BroadcastReceiver的。onUpdate()在用户把小部件拖到桌面,创建Widget实例时会调用。onReceive()在接收广播的时候会被调用。所以在使用Widget的时候应该在AndroidManifest中注册.。且由于当程序开始的时候就监听,所以采用静态注册。
<receiver android:name=".TestWidget">
<!--将该BroadcastReceiver当成桌面控件-->
<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里面表示接收系统发来的有关这个app的所有widget的消息。
- meta-data 指定了对应的资源文件。name 是指定metadata名,
resource是指定对应的资源路径。那我们就把指定的资源文件贴出来。
<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 : 加载到桌面时对应的布局文件
- minWidth : 最小宽度
- minHeight : 最小高度
- previewImage : 预览图片
- 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。其他就显示不出来
前面准备工作做的差不多了,现在就是加载布局文件了。利用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设置点击事件是remoteViews.setOnClickPendingIntent(R.id.wighet_button, pendingIntent);
传入的第一参数是Button的id,第二个是PendingIntent,,我的理解是不立即执行的意图。现在是想点击了Button然后发送广播,在onReceive()中更新TextView的内容。
@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);
//设置文字的内容
remoteViews.setTextViewText(R.id.widget_text_View, "be clicked");
AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
//将AppWidgetProvider的子类实例包装成ComponentName
ComponentName componentName = new ComponentName(context, TestWidget.class);
appWidgetManager.updateAppWidget(componentName, remoteViews);
}
}
第二个注意的地方,RemoteViews 绝对不能复用,据说Binder data size limit is 512k,由于传输到appWidget进程中的Binder最大数据量是512K,并且RemoteView也不会每次清理, 所以如果每次都使用同一个RemoteView进行传输会因为溢出而报错。所以必须每次重新建一个RemoteView来传输。
这样一来一去,基本上就实现了一个可以操作的widget。如果想接收其他地方发的广播,需要在AndroidManifest中注册,然后在onReceive()中进行相关操作。
此时应该有图,但是图不见了,自行脑补一个TextView下有个Button。
当绑定多个Button或者view设置点击事件的时候,如果只是设置Intent的Action不同,好像不能分辨,就是所有的按钮都是一个功能,我的做法是将PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intent, 0);
的第二个参数设置的不同,这样就可以分辨。