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

  代码如下：

  [html]  view plain  copy

   print ?

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

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

• 2、写一个类继承自AppWidgetProvider

  代码如下：

  [java]  view plain  copy

   print ?

  1. package com.terry;  
  2. public class widgetProvider extends AppWidgetProvider {  
  3.     private static final String CLICK_NAME_ACTION = "com.terry.action.widget.click";  
  4.     public static boolean isChange=true;  
  5.     private static RemoteViews rv;  
  6.   
  7.     @Override  
  8.     public void onUpdate(Context context, AppWidgetManager appWidgetManager,  
  9.             int[] appWidgetIds) {  
  10.         // TODO Auto-generated method stub  
  11.         final int N = appWidgetIds.length;  
  12.         for (int i = 0; i < N; i++) {  
  13.             int appWidgetId = appWidgetIds[i];  
  14.             updateAppWidget(context, appWidgetManager, appWidgetId);  
  15.         }  
  16.     }  
  17.   
  18.     @Override  
  19.     public void onReceive(Context context, Intent intent) {  
  20.         // TODO Auto-generated method stub  
  21.         super.onReceive(context, intent);  
  22.   
  23.         if (rv == null) {  
  24.             rv = new RemoteViews(context.getPackageName(), R.layout.main);  
  25.         }  
  26.         if (intent.getAction().equals(CLICK_NAME_ACTION)) {  
  27.             if (isChange) {  
  28.                 rv.setTextViewText(R.id.TextView01, context.getResources()  
  29.                         .getString(R.string.load));  
  30.   
  31.             } else {  
  32.                 rv.setTextViewText(R.id.TextView01, context.getResources()  
  33.                         .getString(R.string.change));  
  34.   
  35.             }  
  36.             Toast.makeText(context, Boolean.toString(isChange),  
  37.                     Toast.LENGTH_LONG).show();  
  38.             isChange = !isChange;  
  39.   
  40.         }  
  41.         AppWidgetManager appWidgetManger = AppWidgetManager  
  42.                 .getInstance(context);  
  43.         int[] appIds = appWidgetManger.getAppWidgetIds(new ComponentName(  
  44.                 context, widgetProvider.class));  
  45.         appWidgetManger.updateAppWidget(appIds, rv);  
  46.     }  
  47.   
  48.     public static void updateAppWidget(Context context,  
  49.             AppWidgetManager appWidgeManger, int appWidgetId) {  
  50.         rv = new RemoteViews(context.getPackageName(), R.layout.main);  
  51.         Intent intentClick = new Intent(CLICK_NAME_ACTION);  
  52.         PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0,  
  53.                 intentClick, 0);  
  54.         rv.setOnClickPendingIntent(R.id.TextView01, pendingIntent);  
  55.         appWidgeManger.updateAppWidget(appWidgetId, rv);  
  56.     }  
  57. }  

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

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

• 3、后台注册Receiver

  后台配置文件代码如下：

  [html]  view plain  copy

   print ?

  1. <receiver android:name=".widgetProvider">  
  2.             <meta-data android:name="android.appwidget.provider"  
  3.                 android:resource="@xml/appwidget_provider"></meta-data>  
  4.             <intent-filter>  
  5.                 <action android:name="com.terry.action.widget.click"></action>  
  6.                 <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />  
  7.                    
  8.             </intent-filter>  
  9. </receiver>  

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

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

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

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

  先看代码：

  [java]  view plain  copy

   print ?

  1. public static void updateAppWidget(Context context,  
  2.             AppWidgetManager appWidgeManger, int appWidgetId) {  
  3.         rv = new RemoteViews(context.getPackageName(), R.layout.main);  
  4.         Intent intentClick = new Intent(CLICK_NAME_ACTION);  
  5.         PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0,  
  6.                 intentClick, 0);  
  7.         rv.setOnClickPendingIntent(R.id.TextView01, pendingIntent);  
  8.         appWidgeManger.updateAppWidget(appWidgetId, rv);  
  9.     }  

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

  [java]  view plain  copy

   print ?

  1. @Override  
  2.     public void onReceive(Context context, Intent intent) {  
  3.         // TODO Auto-generated method stub  
  4.         super.onReceive(context, intent);  
  5.   
  6.         if (rv == null) {  
  7.             rv = new RemoteViews(context.getPackageName(), R.layout.main);  
  8.         }  
  9.         if (intent.getAction().equals(CLICK_NAME_ACTION)) {  
  10.             if (isChange) {  
  11.                 rv.setTextViewText(R.id.TextView01, context.getResources()  
  12.                         .getString(R.string.load));  
  13.   
  14.             } else {  
  15.                 rv.setTextViewText(R.id.TextView01, context.getResources()  
  16.                         .getString(R.string.change));  
  17.   
  18.             }  
  19.             Toast.makeText(context, Boolean.toString(isChange),  
  20.                     Toast.LENGTH_LONG).show();  
  21.             isChange = !isChange;  
  22.   
  23.         }  
  24.         AppWidgetManager appWidgetManger = AppWidgetManager  
  25.                 .getInstance(context);  
  26.         int[] appIds = appWidgetManger.getAppWidgetIds(new ComponentName(  
  27.                 context, widgetProvider.class));  
  28.         appWidgetManger.updateAppWidget(appIds, rv);  
  29.     }  

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

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

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

• [html]  view plain  copy

   print ?

  1. <?xml version="1.0" encoding="utf-8"?>  
  2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
  3.     android:orientation="vertical"   
  4.     android:layout_width="fill_parent"  
  5.     android:id="@+id/layout"   
  6.     android:layout_height="fill_parent">  
  7.   
  8.     <TextView android:text="@string/load"   
  9.               android:id="@+id/TextView01"  
  10.               android:clickable="true"  
  11.               android:layout_width="wrap_content"   
  12.               android:layout_height="wrap_content"></TextView>  
  13. </LinearLayout>