最近项目需要做到桌面widget部件，之前也没做过，所以研究了下。
废话不多说，AppWidget桌面部件也可以说是应用的另外一种入口。能获取到应用的信息，以及可视化得展示应用的内容。
AppWidget可以被定时更新。与一般应用程序有所不同。一般应用虽也可以以图标的形式（快捷方式）放在桌面，但必须点击运行和查看；而AppWidget一般不须点击即直观呈现其主要内容。当然，AppWidget也可以被设置为点击打开其它屏幕或应用等.
用法：
AppWidget的布局是像普通布局一样，在layout目录中创建布局。然后需要在res目录下载新建xml目录，里面新建xml文件，来配置Widget，比如
“<appwidget-provider
xmlns:android="http://schemas.android.com/apk/res/android"
android:initialLayout="@layout/xxx"
android:minHeight="xxxx"
android:minResizeHeight="xxxx"
android:minResizeWidth="xxxx"
android:minWidth="xxxx"
android:configure="xxxx.xx.Config"
android:previewImage="@drawable/alc_widget_prev_weth_4x2"
android:resizeMode="horizontal|vertical"
android:updatePeriodMillis="30000"/>”
initalLayout是初始化加载widget的布局。minResizexx是widget能被调整的最小宽高度。 configure是如果需要在启动前先启动一个Activity进行设置，在这里给出Activity的完整类名。previewImage是在桌面菜单选择该部件时显示的默认图片，也即演示图片。resizeMode是调整size模式。updatePeriodMillis也是最重要的参数，即是组件更新的时间间隔。
然后也需要在清单文件中去配置接收者
“<receiver android:name="xxx.xx.xx.XXWidgetProvider">
<intent-filter>
<action android:name="android.appwidget.action.APPWIDGET_UPDATE"/>
<!-- 自定义action -->
<action android:name="xxxx.xxx"/>
</intent-filter>
<meta-data android:name="android.appwidget.provider"
android:resource="@xml/xxx"/>
<!-- android:resource="" 定义了Widget的信息使用xxxx.xml描述 -->
</receiver>"
其中meta配置的xml也就是上面的xml配置文件。
最后也就是要处理Widget相关事件的，需要创建类去继承AppWidgetProvider。实现onUpdate方法。方法的意思是。更新部件时调用，在第1次添加部件时也会调用
"@Override //更新部件时调用，在第1次添加部件时也会调用
public void onUpdate(Context context, AppWidgetManager appWidgetManager,
int[] appWidgetIds) {
super.onUpdate(context, appWidgetManager, appWidgetIds);
System.out.println("onUpdate widget：" + Arrays.toString(appWidgetIds));
/*
* 构造pendingIntent发广播，onReceive()根据收到的广播，更新
*/
Intent intent = new Intent(context, xxxReciver.class);
PendingIntent pendingIntent = PendingIntent.getService(context, 0, intent, 0);
RemoteViews rv = new RemoteViews(context.getPackageName(), R.layout.xxxx); 这里使用RemoteView去加载widget的布局。
rv.setOnClickPendingIntent(R.id.xxx, pendingIntent);
appWidgetManager.updateAppWidget(appWidgetIds, rv);
}
@Override //部件从host中删除
public void onDeleted(Context context, int[] appWidgetIds) {
super.onDeleted(context, appWidgetIds);
System.out.println("onDeleted widget");
}
@Override //第1次创建时调用，之后再创建不会调用
public void onEnabled(Context context) {
super.onEnabled(context);
System.out.println("onEnabled widget");
}
@Override //当最后一个部件实例 被删除时 调用 用于清除onEnabled执行的操作
public void onDisabled(Context context) {
super.onDisabled(context);
System.out.println("onDisabled widget");
}
@Override //
public void onReceive(Context context, Intent intent) {
super.onReceive(context, intent);
System.out.println("onReceive widget");
/*
* 接收 <action android:name="xxx.xx.xxx"/> 自定义的action
在其他组件或activity或service中发送这些广播
*/
if (intent.getAction().equals("com.test.action.start")) {
long time = intent.getLongExtra("time", 0);
updateWidget(context, time);
System.out.println("receive com.test.action.start");
}
}
private void updateWidget(Context context, long time) {
//RemoteViews处理异进程中的View
RemoteViews rv = new RemoteViews(context.getPackageName(), R.layout.xxx);
System.out.println("time=" + time);
rv.setTextViewText(R.id.xxx, "xxx"); //这里比较特殊，设置文本使用这个方法。
AppWidgetManager am = AppWidgetManager.getInstance(context);
int[] appWidgetIds = am.getAppWidgetIds(new ComponentName(context, xxx.class)); //xxx.class,表示本类的class文件。
am.updateAppWidget(appWidgetIds, rv);//更新 所有实例
}"
上面有说xml中有个配置configure，加上配置活动(configure=activity)也就是添加Widget时，会先打开一个Activity，进行配置操作。
"/*
* 配置部件
* 在onCreate中setContentView()函数前添加setResult(RESULT_CANCLE) ，这样如果在Activity初始化完成前按下了BACK按键，则Widget不会启动；
* 在setContentView()函数之后（不一定要在onCreate中，在Activity退出前即可），添加如下设置以指定需要启动的Widget
*/
public class AppWidgetConfigureActivity extends Activity implements OnClickListener {
Button config1, config2, config3;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
Intent intent = getIntent();
Bundle extras = intent.getExtras();
if (extras != null) {
int widgetid = extras.getInt(AppWidgetManager.EXTRA_APPWIDGET_ID, -1);//从intent中得出widgetid
//通知 appwdiget 的配置已取消
Intent reslut = new Intent();
reslut.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, widgetid);
setResult(RESULT_CANCELED, reslut);
System.out.println("result cancel");
}
setContentView(R.layout.switch_configure);
config1 = (Button) findViewById(R.id.btn_config1);
config2 = (Button) findViewById(R.id.btn_config2);
config3 = (Button) findViewById(R.id.btn_config3);
config1.setOnClickListener(this);
config2.setOnClickListener(this);
config3.setOnClickListener(this);
}
@Override
protected void onResume() {
super.onResume();
}
private void onCompletedConfigure() {
Intent intent = getIntent();
Bundle extras = intent.getExtras();
if (extras != null) {
int widgetid = extras.getInt(AppWidgetManager.EXTRA_APPWIDGET_ID, -1);//从intent中得出widgetid
//通知 appwdiget 的配置已完成
Intent reslut = new Intent();
reslut.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, widgetid);
setResult(RESULT_OK, reslut);
System.out.println("result ok");
finish();
System.out.println("finish ok");
}
}
@Override
public void onClick(View v) {
if (v == config1) {
//do config1
} else if (v == config2) {
//do config2
} else if (v == config3) {
//do config3
}
onCompletedConfigure();
}
}"
widget的基础实现也就是这样。具体的实现基本上是在appWidgetProvider的类中去完成。通过onRecive方法，接收到action去完成相应的方法。再更新RemoteViews的视图。
