android之Widget开发详解实例二

下面是本篇的大纲：

• 1、AppWidget 框架类
• 2、AppWidget 框架的主要类介绍
• 3、DEMO 讲解

1、AppWidget 框架类

• 1、AppWidgetProvider ：继承自 BroadcastRecevier ， 在AppWidget 应用 update、enable、disable 和 delete 时接收通知。其中，onUpdate、onReceive 是最常用到的方法，它们接收更新通知。
• 2、 AppWidgetProvderInfo：描述 AppWidget 的大小、更新频率和初始界面等信息，以XML 文件形式存在于应用的 res/xml/目录下。
• 3、AppWidgetManger ：负责管理 AppWidget ，向 AppwidgetProvider 发送通知。
• 4、RemoteViews ：一个可以在其他应用进程中运行的类，向 AppWidgetProvider 发送通知。

2、AppWidget 框架的主要类介绍

 1) AppWidgetManger 类

• bindAppWidgetId(int appWidgetId, ComponentName provider)
  通过给定的ComponentName 绑定appWidgetId
• getAppWidgetIds(ComponentName provider)
  通过给定的ComponentName 获取AppWidgetId
• getAppWidgetInfo(int appWidgetId)
  通过AppWidgetId 获取 AppWidget 信息
• getInstalledProviders()
  返回一个List<AppWidgetProviderInfo>的信息
• getInstance(Context context)
  获取 AppWidgetManger 实例使用的上下文对象
• updateAppWidget(int[] appWidgetIds, RemoteViews views)
  通过appWidgetId 对传进来的 RemoteView 进行修改，并重新刷新AppWidget 组件
• updateAppWidget(ComponentName provider, RemoteViews views)
  通过 ComponentName 对传进来的 RemoeteView 进行修改，并重新刷新AppWidget 组件
• updateAppWidget(int appWidgetId, RemoteViews views)
  通过appWidgetId 对传进来的 RemoteView 进行修改，并重新刷新AppWidget 组件

2) 继承自 AppWidgetProvider 可实现的方法为如下：

• 1、onDeleted(Context context, int[] appWidgetIds)
• 2、onDisabled(Context context)
• 3、onEnabled(Context context)
• 4、onReceive(Context context, Intent intent)
  Tip:因为 AppWidgetProvider 是继承自BroadcastReceiver  所以可以重写onRecevie 方法，当然必须在后台注册Receiver
• 5、onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds)
• 一般来说都是重写onUpdate就够了

• 3、Demo讲解

  下面是我今天做的一个实例，提供给大家练习时做参考，效果如下：在布局中放一个 TextView 做桌面组件，然后设置TextView 的 Clickable="true" 使其有点击的功能，然后我们点击它时改变它的字体，再点击时变回来，详细操作如下流程：

  • 1、新建AppWidgetProvderInfo
  • 2、写一个类继承自AppWidgetProvider
  • 3、后台注册Receiver
  • 4、使 AppWidget 组件支持点击事件
  • 5、如何使TextView 在两种文本间来回跳转

  问题抛出来了，那么一起解决它吧。

  1、新建AppWidgetProvderInfo

  代码如下：

  <?xml version="1.0" encoding="UTF-8"?>
  <appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
      android:minWidth="60dp"
      android:minHeight="30dp"
      android:updatePeriodMillis="86400000"
      android:initialLayout="@layout/main">
  </appwidget-provider>

  Tip:上文说过AppWidgetProvderInfo 是在res/xml 的文件形式存在的，看参数不难理解，就是定义widget的大小和更新频率等信息,比较重要的是这里android:initialLayout="@layout/main" 此句为指定桌面组件的布局文件,即规划widget里面有哪些组件,如何排列等。

• 2、写一个类继承自AppWidgetProvider

  代码如下：

  package com.terry;
  public class widgetProvider extends AppWidgetProvider {
  	private static final String CLICK_NAME_ACTION = "com.terry.action.widget.click";
  	public static boolean isChange=true;
  	private static RemoteViews rv;
  
  	@Override
  	public void onUpdate(Context context, AppWidgetManager appWidgetManager,
  			int[] appWidgetIds) {
  		// TODO Auto-generated method stub
  		final int N = appWidgetIds.length;
  		for (int i = 0; i < N; i++) {
  			int appWidgetId = appWidgetIds[i];
  			updateAppWidget(context, appWidgetManager, appWidgetId);
  		}
  	}
  
  	@Override
  	public void onReceive(Context context, Intent intent) {
  		// TODO Auto-generated method stub
  		super.onReceive(context, intent);
  
  		if (rv == null) {
  			rv = new RemoteViews(context.getPackageName(), R.layout.main);
  		}
  		if (intent.getAction().equals(CLICK_NAME_ACTION)) {
  			if (isChange) {
  				rv.setTextViewText(R.id.TextView01, context.getResources()
  						.getString(R.string.load));
  
  			} else {
  				rv.setTextViewText(R.id.TextView01, context.getResources()
  						.getString(R.string.change));
  
  			}
  			Toast.makeText(context, Boolean.toString(isChange),
  					Toast.LENGTH_LONG).show();
  			isChange = !isChange;
  
  		}
  		AppWidgetManager appWidgetManger = AppWidgetManager
  				.getInstance(context);
  		int[] appIds = appWidgetManger.getAppWidgetIds(new ComponentName(
  				context, widgetProvider.class));
  		appWidgetManger.updateAppWidget(appIds, rv);
  	}
  
  	public static void updateAppWidget(Context context,
  			AppWidgetManager appWidgeManger, int appWidgetId) {
  		rv = new RemoteViews(context.getPackageName(), R.layout.main);
  		Intent intentClick = new Intent(CLICK_NAME_ACTION);
  		PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0,
  				intentClick, 0);
  		rv.setOnClickPendingIntent(R.id.TextView01, pendingIntent);
  		appWidgeManger.updateAppWidget(appWidgetId, rv);
  	}
  }

  重写两个方法:1.onUpdate 为组件在桌面上生成时调用，并更新组件UI，

•                        2.onReceiver 为接收广播时调用更新UI，一般这两个方法是比较常用的。

• 3、后台注册Receiver

  后台配置文件代码如下：

  <receiver android:name=".widgetProvider">
  			<meta-data android:name="android.appwidget.provider"
  				android:resource="@xml/appwidget_provider"></meta-data>
  			<intent-filter>
  				<action android:name="com.terry.action.widget.click"></action>
  				<action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
  				 
  			</intent-filter>
  </receiver>

  Tip:因为是桌面组件，所以暂时不考虑使用Activity 界面，当然你在实现做项目时可能会需要点击时跳转到Activity 应用程序上做操作，典型的案例为Android  提供的音乐播放器。

• 上面代码中比较重要的是这一句 <meta-data android:name="android.appwidget.provider"  android:resource="@xml/appwidget_provider"></meta-data>

• 大意为指定桌面应用程序的AppWidgetProvderInfo 文件，使其可作其管理文件,管理widget的大小更新时间等信息.
  

  4、使 AppWidget 组件支持点击事件

  先看代码：

  public static void updateAppWidget(Context context,
  			AppWidgetManager appWidgeManger, int appWidgetId) {
  		rv = new RemoteViews(context.getPackageName(), R.layout.main);
  		Intent intentClick = new Intent(CLICK_NAME_ACTION);
  		PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0,
  				intentClick, 0);
  		rv.setOnClickPendingIntent(R.id.TextView01, pendingIntent);
  		appWidgeManger.updateAppWidget(appWidgetId, rv);
  	}

  此方法为创建组件时 onUpdate 调用的更新UI的方法，代码中使用RemoteView 找到组件的布局文件，同时为其设置广播接收器CLICK_NAME_ACTION并且通过RemoteView 的setOnClickPendingIntent 方法找到我想触发事件的TextView 为其设置广播。接着
  

  @Override
  	public void onReceive(Context context, Intent intent) {
  		// TODO Auto-generated method stub
  		super.onReceive(context, intent);
  
  		if (rv == null) {
  			rv = new RemoteViews(context.getPackageName(), R.layout.main);
  		}
  		if (intent.getAction().equals(CLICK_NAME_ACTION)) {
  			if (isChange) {
  				rv.setTextViewText(R.id.TextView01, context.getResources()
  						.getString(R.string.load));
  
  			} else {
  				rv.setTextViewText(R.id.TextView01, context.getResources()
  						.getString(R.string.change));
  
  			}
  			Toast.makeText(context, Boolean.toString(isChange),
  					Toast.LENGTH_LONG).show();
  			isChange = !isChange;
  
  		}
  		AppWidgetManager appWidgetManger = AppWidgetManager
  				.getInstance(context);
  		int[] appIds = appWidgetManger.getAppWidgetIds(new ComponentName(
  				context, widgetProvider.class));
  		appWidgetManger.updateAppWidget(appIds, rv);
  	}

  在onReceiver 中通过判断识别传进来的广播来触发动作。
  5、如何使TextView 在两种文本间来回跳转

• 如果你发现无法实现文本的跳转变化,尝试把public static boolean isChange=true;这个boolean放在新建一个类里面试试看.

• 还有main.xml的代码如下:

• <?xml version="1.0" encoding="utf-8"?>
  <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  	android:orientation="vertical" 
  	android:layout_width="fill_parent"
  	android:id="@+id/layout" 
  	android:layout_height="fill_parent">
  
  	<TextView android:text="@string/load" 
  	          android:id="@+id/TextView01"
  		      android:clickable="true"
  		      android:layout_width="wrap_content" 
  		      android:layout_height="wrap_content"></TextView>
  </LinearLayout>