Android Launcher开发之AppWidget(桌面小部件)全面解析

导读：先简单说说Widget的原理。Widget是在桌面上的一块显示信息的东西，也通过单击Widget跳转到一个程序里面。而系统自带的程序，典型的Widget是music，这个Android内置的音乐播放小程序。先简单说说Widget的原理。Widget是在桌面上的一块显示信息的东西，也通过单击Widget跳转到一个程序里面。而系统自带的程序，典型的Widget是music，这个Android内置的音乐播放小程序。这个是典型的Widget+app应用。就是一个程序既可以通过Widget启动，也可以通过App启动。Widget就是一个AppWidgetProvider+一个UI界面显示（预先绑定了好多Intent），界面上的信息可以通过程序控制而改变，单击Widget，上的控件只能激发发送一个Intent，或发出一个Service的启动通知。而AppWidgetProvider可以拦截这个Intent，而进行相应的处理（比如显示新的信息）。Android开发里要大量的通过手动的方式配置好多xml文件。这对于.net开发来说不得不说是个梦靥呀。这也许也是一般的java程序员比.net程序的工资高的一个原因吧。毕竟做Java开发，特别是Android开发，确实很累。你可以看下源码对照着源码进行讲解。我们先开发一个比较简单的Widget应用，实现的主要功能是可以通过的不断变化，而不断的显示当前时间。首先，要自己手动建一个名为xml的文件夹。建一个xml文件，加入如下代码：

 <appwidget-providerxmlns:android="http://schemas.android.com/apk/res/android"

         android:minHeight="72px"

         android:minWidth="72px"  

       android:updatePeriodMillis="3800000"android:initialLayout="@layout/main">

  </appwidget-provider>

这个是Widget的显示设置，是对Widget属性的一个配置文件这个android:minHeight是Widget的高，这个android:minWidth 是Widget的宽。这个android:updatePeriodMillis属性是设置Widget页面的 更新页面的时间的频率。而这个android:initialLayout属性是表示的是初始化页面的布局，Android里画UI的地方都是通过xml文件，也可以通过代码程序来画，不过这样画的太麻烦了。 看下以下的文件系统，res文件夹是系统存放资源文件的目录。以drawable开头的文件夹是存放图片资源的文件夹。而后面的hdpi和ldpi等，都是平常在不同的状态如（横屏与竖屏时）系统调用不同的图片资源。Layout就是存放的一般都是xml，UI设计就是在这个layout文件夹里。Value里放的strings.xml就是从程序里分离的字符串，在实现国际化的时候可能会用到。 看看layout里的main.xml ,只有一个空间就是TextView，这个是用来显示时间用的。 建一个类TestAppWidget继承于AppWidgetProvider，而AppWidgetProvider继承与android.content.BroadcastReceiver，所以TestAppWidget就是一个拦截处理Intent的BroadcastReceiver，这些Intent只能在Androidmainfest里设置来拦截处理。

public class TestAppWidget extends AppWidgetProvider {
  private static final String TAG="TestAppWidget";
  private static final String FRESH="com.sinxiao.app.fresh";
   private Context mContext ;
   private boolean run = true ;
   BroadcastReceiver mBroadcast =newBroadcastReceiver() {    

   

      public void onReceive(Contextcontext, Intent intent) {   
       String action =intent.getAction();
    
       if(action.equals(Intent.ACTION_TIME_TICK)) {
   
       mContext.sendBroadcast(newIntent(FRESH));
   
    }
   
   }
    
  };
    
   /**
    
   * 通知Widget每个1秒刷新一次
    */
  Thread myThread = new
    Thread(){
    
    public void run() {
   
    while (run) {
    
    try {
   
    Thread.sleep(1000);
     } catch (InterruptedException e) {
    e.printStackTrace();
    }
    mContext.sendBroadcast(newIntent(FRESH));//通知刷新Widget的Intent
    }
   };
    };
   
    @Override 
    public void onUpdate(Contextcontext, AppWidgetManager appWidgetManager,
    
   int[] appWidgetIds) {
       //  用来给Widget刷新界面显示
    Log.d(TAG,"onUpdate");
   super.onUpdate(context,appWidgetManager, appWidgetIds);
    mContext = context;
    RemoteViews views = newRemoteViews(context.getPackageName(),R.layout.main);
    Calendar
    cal=Calendar.getInstance();
    System.out.println(cal.getTime().toLocaleString());
    views.setTextViewText(R.id.txttim,cal.getTime().toLocaleString());
    appWidgetManager.updateAppWidget(appWidgetIds,views);
   myThread.start();
    /**
   * 本类作为一个bracastReveiver能自己再，注册个监听器
   （可以取消注释，看报什么错误）
  */
    //
   context.registerReceiver(mBroadcast,new IntentFilter(Intent.ACTION_TIME_TICK));
    }
    @Override
   public void onReceive(Contextcontext, Intent intent) {
    Log.d(tag,"onReceive");
    String action =intent.getAction();
    Log.d(tag, "theaction is "+action);
    if (FRESH.equals(action)){
    showTime(context);
    }elseif(Intent.ACTION_TIME_TICK.equals(action)){
    showTime(context);
  }
   super.onReceive(context,intent);
    }
    private void showTime(Contextcontext) {
    RemoteViews views = newRemoteViews(context.getPackageName(),R.layout.main);
    Calendar
    cal=Calendar.getInstance();
   views.setTextViewText(R.id.txttim,cal.getTime().toLocaleString());
    ComponentName thisWidget =new ComponentName(context,TestAppWidget.class);
    AppWidgetManager.getInstance(context).updateAppWidget(thisWidget,views);
    }
    public void onDisabled(Contextcontext) {
    Log.d(tag,"onDisabled");
    super.onDisabled(context);
    run = false ;
    }
    }

以上代码就是用来改变显示时间和处理刷新FRESHIntent的主程序。 看AndroidMainifest里是如何将FRESH Intent绑定到这个TestAppWidget的，看TestAppWidget这个reciever 里有个 <action android:name="com.sinxiao.app.fresh" /> 这就是要拦截的Intent的一个标示。主程序里的重写了父类里的OnReceive（）方法在。

        private static final StringFRESH="com.sinxiao.app.fresh";
	public void onReceive(Contextcontext, Intent intent) {
	String action=intent.getAction();
	Log.d(tag, "theaction is "+action);
	if (FRESH.equals(action)){
	showTime(context);
	}elseif(Inent.ACTION_TIME_TICK.equals(action)){
	showTime(context);
	}
	super.onReceive(context,intent);
	}

这个FRESH就显示的就是处理我们，刚才下面绑定的这个FRESH Intent。

  <?xml version="1.0"encoding="utf-8"?>
    <manifestxmlns:android="http://schemas.android.com/apk/res/android"
    package="com.sinxiao.widgetapp"
    android:versionCode="1"android:versionName="1.0.0">
   <applicationandroid:icon="@drawable/icon"android:label="@string/app_name">
    <receiver android:name=".setting.TestAppWidget">
   <intent-filter>
   <actionandroid:name="android.appwidget.action.APPWIDGET_UPDATE"/>
    <!-- 这个Intent不支持在配置文件里的注册 所以这个是没用的 -->
   <!-- <actionandroid:name ="android.intent.action.TIME_TICK"/> -->
    </intent-filter>
    <intent-filter>
   <!-- 将IntentAction 手动配置在 mainset文件上 -->
    <action android:name="com.sinxiao.app.fresh"/>
    </intent-filter>
    <meta-data android:name="android.appwidget.provider"
  android:resource="@xml/testwidget_setting" />
    </receiver>
    </application>
   </manifest>

这样就是Widget的简单的实现思路。需要特别说明的是Android 的Widget里有好多潜规则呀。一不小心，就可能中招。这就说明了实践是检验真理的唯一标准呀。 关于对Widget上控件如何赋值？如下所示：

 RemoteViews views = newRemoteViews(context.getPackageName(),R.layout.main);
   Calendar
    cal=Calendar.getInstance();
    System.out.println(cal.getTime().toLocaleString());
    views.setTextViewText(R.id.txttim,cal.getTime().toLocaleString());
    
    appWidgetManager.updateAppWidget(appWidgetIds,views);

为什么要通过RemoteViews来向Widget设置界面呢？我也不知道，那位高人可以告诉我呢？这就是潜规则呀。在一般app应用里，直接用 setContentView(R.layout.main); 来实现。这个RemoteViews更特殊，设置Text时，必须通过 views.setTextViewText(R.id.txttim,cal.getTime().toLocaleString()); 这种变态的方式才可以赋值，实在令人琢磨不透呀。 通过appWidgetManager来，更新了页面，也就刷新了Widget界面。在获得ACTION 为 com.sinxiao.app.fresh的Intent时，也是这样更新页面。在showTime（）；的方法里，

    ComponentName thisWidget = new ComponentName(context,TestAppWidget.class);
    AppWidgetManager.getInstance(context).updateAppWidget(thisWidget,views);