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);