Android学习10-----Android组件通信 (8) 桌面显示组件：AppWidget
一、AppWidget
在使用Android手机时，用户经常会将一些常使用的软件拖放到桌面上以方便操作。这时就需要使用AppWidget组件，在android.appwidget包综合那个定义了5个核心的操作类。
No.
类名称
描述
1
AppWidgetProvider
定义了AppWidget的基本操作，需要通过子类进行设置
2
AppWidgetProviderInfo
AppWidget组件的元数据提供者，如组件的大小、更新时间等
3
AppWidgetHostView
创建AppWidget的View显示，此为真正的View，与之对应的还有RemoteView
4
AppWidgetHost
监听AppWidget的服务以及创建AppWidgetHostView
5
AppWidgetManager
用于更新相应的AppWidget
由于AppWidget要在桌面上显示界面，而这个界面又要通过AppWidgetManager程序进行控制，所以还需要使用一个android.widget.RemoveViews类，此类的主要功能是描述一个View的显示实体，RemoveViews会通过进程间通信机制传递个AppWidgetHost。
这里的RemoteViews只是把一个进程的控件嵌入到另外一个进程中显示的一个方法，所有的事件处理操作依然在原始进程中，而AppWidget需要依靠RemoveViews来完成显示内容的更新操作，RemoveViews常用方法有：
No.
方法
描述
1
Public RemoteViews(String packageName,intlayoutId)
创建新的RemoveViews组件，并指定所需要的布局管理器文件
2
Public void addView(int viewId,RemoteViewsnestedView)
为RemoveViews增加一个组件
3
Public void setXxx(int viewId,StringmethodName,Xxx value)
设置指定内容，如setBoolean()、setImageViewResource()、setTextViewText()等
4
Public void setOnClickPendingIntent(intviewId,PendingIntent pendingIntent)
设置单击事件触发之后要操作的PendingIntent对象
5
Public void setProgressBar(int viewId,intmax,int progress,Boolean indeterminate)
设置要操作的ProgressBar组件
除了RemoveViews类作为远程View之外，Activity程序中也提供了对应的AppWidgetProvider类用于与RemoveView组件的操作相对应，通过文档可以发现AppWidgetProvider是BroadcastReceiver的子类，所以在使用时需要在AndroidManifest.xml中配置receive节点，AppWidgetProvider类中也提供了像Activity类中的生命周期控制方法，其方法如下：
No.
方法
描述
1
Public void onDeleted(Contextcontext,int[] appWidget)
删除AppWidget时触发
2
Public void onDisabled(Context context)
当最后一个AppWidget删除时触发
3
Public void onEnabled(Context context)
当第一个AppWidget启动时触发
4
Public void onReceive(Contextcontext,Intent intent)
接受广播事件
5
Public void onUpdate(Context context,
AppWidgetManager appWidgetManger,
int[] appWidgetIds)
当指定的更新时间到达或者用户添加AppWidget时触发
注：
1、onUpdate方法决定了AppWidget组件的显示功能以及远程AppWidget的事件处理绑定，当组件更新时，需要使用AppWidgetManager类更新远程AppWidget组件（严格说是RemoveViews），而AppWidgetManager会广播Action名称是“android.appwidget.action.APPWIDGET_UPDATE”的Intent。
2、对于onDisabled和onEnabled方法，因为android中一个程序可以同时在桌面上设置多个显示的组件。
MyAppWidget.java
package com.iflytek.demo;import android.appwidget.AppWidgetManager;import android.appwidget.AppWidgetProvider;import android.content.Context;import android.content.Intent;public class MyAppWidget extends AppWidgetProvider {@Overridepublic void onDeleted(Context context, int[] appWidgetIds) {// 删除时触发System.out.println("*** MyAppWidget onDeleted");super.onDeleted(context, appWidgetIds);}@Overridepublic void onDisabled(Context context) {// 删除最后一个触发System.out.println("*** MyAppWidget onDisabled");super.onDisabled(context);}@Overridepublic void onEnabled(Context context) {// 启动第一个时触发System.out.println("*** MyAppWidget onEnabled");super.onEnabled(context);}@Overridepublic void onReceive(Context context, Intent intent) {// 处理广播System.out.println("*** MyAppWidget onReceive");super.onReceive(context, intent);}@Overridepublic void onUpdate(Context context, AppWidgetManager appWidgetManager,int[] appWidgetIds) {// 更新时触发System.out.println("*** MyAppWidget onUpdate");super.onUpdate(context, appWidgetManager, appWidgetIds);}} 上面只是对AppWidgetProvider中的几个与生命周期有关的方法进行覆写，但是如果想让一个AppWidget程序进行显示，还需要定义一个设置桌面显示的配置文件，该文件保存在res\xml文件夹中。
xdwang_appwidget.xml.xml
<?xml version="1.0" encoding="utf-8"?><appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"android:minHeight="80px"android:minWidth="300px"android:updatePeriodMillis="6000"android:initialLayout="@layout/xdwang_appwidget"></appwidget-provider>xdwang_appwidget.xml
<?xml version="1.0" encoding="utf-8"?><LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="fill_parent" android:layout_height="fill_parent" android:orientation="vertical" > <ImageView android:id="@+id/img" android:layout_width="fill_parent" android:layout_height="wrap_content" android:src="@drawable/ic_launcher" /> <Button android:id="@+id/but" android:layout_width="fill_parent" android:layout_height="wrap_content" android:layout_gravity="center_horizontal" android:text="王旭东" /></LinearLayout> AndroidManifest.xml
<receiver android:name=".MyAppWidget" > <!-- AppWidget更新时触发 --> <intent-filter > <action android:name="android.appwidget.action.APPWIDGET_UPDATE" /> </intent-filter> <!-- 定义AppWidget的元数据 ，android:name：AppWidget提供者，android:resource程序要使用的配置信息 --> <meta-data android:name="android.appwidget.provider" android:resource="@xml/xdwang_appwidget" /> </receiver>
二、使用AppWidget跳转到Activity进行操作
前面我们简单描述了AppWidget程序的配置，但是在实际情况下，很多时候需要单击桌面显示的AppWidget可以进入一个Activity程序进行更加复杂的操作处理。这里我们首先来看看AppWidgetManager提供的方法：
No.
方法
描述
1
Public void updateAppWidget(intappWidgetId,RemoveViews views)
更新指定的AppWidget组件
2
Public void updateAppWidget(ComponentNameprovider,
RemoveViews views)
更新指定的AppWidget组件
3
Public void updateAppWidget(int[]appWidgetIds,RemoveViews views)
更新指定的AppWidget组件
4
Public static AppWidgetManagergetInstance(Context context)
取得一个AppWidgetManager的实例
MyAppWidget.java
package com.iflytek.demo;import android.app.PendingIntent;import android.appwidget.AppWidgetManager;import android.appwidget.AppWidgetProvider;import android.content.Context;import android.content.Intent;import android.widget.RemoteViews;public class MyAppWidget extends AppWidgetProvider {@Overridepublic void onUpdate(Context context, AppWidgetManager appWidgetManager,int[] appWidgetIds) {// 更新时触发for (int x = 0; x < appWidgetIds.length; x++) {// 更新所有显示的AppWidgetIntent intent = new Intent(context, AppWidget02Activity.class);// 设置ActivityPendingIntent pendingIntent = PendingIntent.getActivity(context, 0,intent, PendingIntent.FLAG_UPDATE_CURRENT);// 设置准备执行的IntentRemoteViews remote = new RemoteViews(context.getPackageName(),R.layout.xdwang_appwidget);// 更新要操作的RemoveViewsremote.setOnClickPendingIntent(R.id.but, pendingIntent);appWidgetManager.updateAppWidget(appWidgetIds, remote);// 更新远程的视图}}}三、使用AppWidget进行广播
MyAppWidget.java
package com.iflytek.demo;import android.app.PendingIntent;import android.appwidget.AppWidgetManager;import android.appwidget.AppWidgetProvider;import android.content.ComponentName;import android.content.Context;import android.content.Intent;import android.widget.RemoteViews;public class MyAppWidget extends AppWidgetProvider {@Overridepublic void onReceive(Context context, Intent intent) {if ("com.iflytek.action.MYAPPWIDGET_UPDATE".equals(intent.getAction())) {// 判断是否是指定的ActionRemoteViews remote = new RemoteViews(context.getPackageName(),R.layout.xdwang_appwidget);// 定义RemoveViewsremote.setImageViewResource(R.id.img, R.drawable.ic_launcher);// 设置图片remote.setTextViewText(R.id.but, "王旭东改变");// 更新组件文字AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);// 取得AppWidgetManagerComponentName componentName = new ComponentName(context,MyAppWidget.class);// 定义使用的组件appWidgetManager.updateAppWidget(componentName, remote);// 更新组件} else {super.onReceive(context, intent); // 如果不写此代码，表示无法调用onUpdate()}}@Overridepublic void onUpdate(Context context, AppWidgetManager appWidgetManager,int[] appWidgetIds) {Intent intent = new Intent();// 设置操作要执行的Intentintent.setAction("com.iflytek.action.MYAPPWIDGET_UPDATE");PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0,intent, PendingIntent.FLAG_UPDATE_CURRENT);// 设置准备执行的IntentRemoteViews remote = new RemoteViews(context.getPackageName(),R.layout.xdwang_appwidget);// 定义要操作的RemoveViewsremote.setOnClickPendingIntent(R.id.but, pendingIntent);appWidgetManager.updateAppWidget(appWidgetIds, remote);// 更新远程视图}} AndroidManifest.xml
<receiver android:name=".MyAppWidget" > <intent-filter > <action android:name="android.appwidget.action.APPWIDGET_UPDATE" /> </intent-filter> <intent-filter > <action android:name="com.iflytek.action.MYAPPWIDGET_UPDATE" /> </intent-filter> <meta-data android:name="android.appwidget.provider" android:resource="@xml/xdwang_appwidget" /> </receiver>
页:
[1]