AppWidget学习总结

    Android开发的应用除了程序应用，还有是Widget应用。好多人会开发程序应用而不会开发Widget应用。本帖子就是帮助大家学习如何开发Widget应用的。
   先简单说说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的文件夹。
[attach]91110[/attach]

建一个xml文件，放进去一下东西：
<appwidget-provider xmlns: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就是从程序里分离的字符串，在实现国际化的时候可能会用到。
[attach]91109[/attach]
看看layout里的main.xml ,只有一个空间就是TextView，这个是用来显示时间用的。

建一个类TestAppWidget继承于AppWidgetProvider，而AppWidgetProvider继承与android.content.BroadcastReceiver，所以TestAppWidget就是一个拦截处理Intent的BroadcastReceiver，这些Intent只能在Androidmainfest里设置来拦截处理。
package com.sinxiao.widgetapp.setting;
import java.util.Calendar;
import com.sinxiao.widgetapp.R;
import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.BroadcastReceiver;
import android.content.ComponentName;
import android.content.Context;
import android.content.Intent;
import android.util.Log;
import android.widget.RemoteViews;
public class TestAppWidget extends AppWidgetProvider {

private 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更新时调用的函数
用来给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();

System.out.println(cal.getTime().toLocaleString());

views.setTextViewText(R.id.txttim,cal.getTime().toLocaleString());

ComponentName thisWidget =new ComponentName(context,TestAppWidget.class);

AppWidgetManager.getInstance(context).updateAppWidget(thisWidget,views);

}

@Override

public void onEnabled(Contextcontext) {

Log.d(tag, "onEnabled");

super.onEnabled(context);

run = true ;

}

@Override

public void onDeleted(Contextcontext, int[] appWidgetIds) {

Log.d(tag,"onDeleted");

super.onDeleted(context,appWidgetIds);

}

@Override

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

}
这个FRESH就显示的就是处理我们，刚才下面绑定的这个FRESH Intent。
<?xml version="1.0"encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"

package="com.sinxiao.widgetapp"

android:versionCode="1"android:versionName="1.0.0">

<application android:icon="@drawable/icon"android:label="@string/app_name">

<receiver android:name=".setting.TestAppWidget">

<intent-filter>

<action android: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);
不过变成以上这种方式来更新了。这样的好处，是只要有个context 就可以实现了界面的刷新。
说的半天，你要是不会启动Widget就杯具了，因为这事你要骂我，我就餐具了。按menu键
，然后单击Add，出现以下页面，或者长按屏幕也可以出现。
，单击Widget就出现了我们的Widget小程序了。
，单击选择我们的程序就成功了。