Android Launcher开发(二)AppWidget(桌面小部件)解析
先简单说说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);
}
<?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);