android widget

一、主要框架

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

  二、开发步骤

  1.在res\xml中建立widget内容提供者文件，取名为widget_provider.xml

  <?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>
  

  android:initialLayout="@layout/main" 此句为指定桌面组件的布局文件。

  android:updatePeriodMillis="86400000"指定刷新时间间隔（单位：ms），每隔android:updatePeriodMillis就调用onUpdate方法。另，如果android:updatePeriodMillis为0，则表示不刷新。

  android:minWidth最小宽度
  android:minHeight最小高度

  可以根据所占单元格数计算android:minWidth和android:minHeight。

  计算公式（宽高皆适用）：（单元个数*74）-2。由于像素计算会造成一定的偏差，所以最后值减2。另，屏幕最大单元格数位4*4。

  2.写一个类继承自AppWidgetProvider

  public class widgetProvider extends AppWidgetProvider

  
  并重写两个方法

  @Override
      public void onUpdate(Context context, AppWidgetManager appWidgetManager,
              int[] appWidgetIds) {}
  
  @Override
      public void onReceive(Context context, Intent intent) {}

  onUpdate 为组件在桌面上生成时调用，并更新组件UI，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>
  
  

  上面代码中比较重要的是这一句 <meta-data android:name="android.appwidget.provider"  android:resource="@xml/appwidget_provider"></meta-data>  大意为指定桌面应用程序的AppWidgetProvderInfo  文件，使其可作其管理文件。
  

  4.使app widget组件支持点击事件

  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 为其设置广播。接着在onReceiver 中通过判断传进来的广播来触发动作。

  @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 (uitil.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(uitil.isChange),
                      Toast.LENGTH_LONG).show();
              uitil.isChange = !uitil.isChange;
  
          }
          AppWidgetManager appWidgetManger = AppWidgetManager
                  .getInstance(context);
          int[] appIds = appWidgetManger.getAppWidgetIds(new ComponentName(
                  context, widgetProvider.class));
          appWidgetManger.updateAppWidget(appIds, rv);
      }