android开发之App widget

放在桌面上的控件叫做——App widget，例如可以在桌面上添加按钮、图片等等控件，例如桌面播放器的控制面板

AppWidgetProviderInfo对象，它为App Widget提供元数据，包括布局、更新频率等等数据，这个对象不是由我们自己生成的，而是由android自己定义配置完成，这个对象被定义在XML文件中

1、定义AppWidgetProviderInfo对象，在res/xml文件夹当中定义一个名为widget_config.xml文件

<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider
xmlns:android="http://schemas.android.com/apk/res/android"
android:minWidth="300dp"
android:minHeight="72dp"
android:updatePeriodMillis="0"
android:initialLayout="@layout/widget_ui"
>
</appwidget-provider>

备注：建立的文件夹名一定是xml，因为只有这样才能被R识别

2、AppWidgetProvider定义了App Widget的基本生命周期

public class MyWidgetProvider extends AppWidgetProvider {
public static int Tag;
public int max;
public int current;

@Override
public void onEnabled(Context context) {
super.onEnabled(context);
System.out.println("第一次被创建时调用这个方法");
}

@Override
public void onDisabled(Context context) {
System.out.println("当最后一个App Widget被删除时调用该方法");
}

@Override
public void onReceive(Context context, Intent intent) {
//调用父类的onReceive方法不能少，否则就无法监听到onUpdate事件了
super.onReceive(context, intent);
System.out.println("接收广播事件");
}

@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager,
int[] appWidgetIds) {
System.out.println("在到达指定的更新时间之后或者当用户向桌面添加App Widget时调用这个方法");
for(int i = 0; i < appWidgetIds.length; i++){
Intent intent = new Intent(context, HB.class);
PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0);
//R.layout.widget_ui指的是显示在桌面上的控件布局
RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.widget_ui);
//R.id.widgetButton指的是为桌面控件按钮绑定事件
remoteViews.setOnClickPendingIntent(R.id.widgetButton, pendingIntent);
//updateAppWidget方法更新remoteViews
appWidgetManager.updateAppWidget(appWidgetIds[i], remoteViews);
}
}
}

@Override
public void onDeleted(Context context, int[] appWidgetIds){
System.out.println("App Widget被删除时调用这个方法");
}
}

3、添加一个布局文件res/layout/widget_ui.xml（在桌面上显示的内容）

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="wrap_content"
android:layout_height="wrap_content">
<Button
android:id="@+id/widget_BT_Up"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_weight="1"
android:text="Value++"/>
<Button android:id="@+id/widget_BT_Down"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Value--"
android:layout_weight="1"/>
</LinearLayout>

4、在AndroidManifest.xml文件中添加reseiver标签

android:resource="@xml/widget_config" 指明显示widget_config.xml是appwidget的属性初始化设置
android:name="android.appwidget.action.APPWIDGET_UPDATE" 是android系统提供判定是appwidget的处理方式
android:name=".MyWidgetProvider" 表示处理的类，即继承了AppWidgetProvider类的类

<receiver android:name=".MyWidgetProvider" android:label="myWIdget" android:icon="@drawable/icon">
<intent-filter>
<action android:name="android.appwidget.action.APPWIDGET_UPDATE"/>
</intent-filter>
<meta-data android:name="android.appwidget.provider" android:resource="@xml/widget_config"/>
</receiver>

备注：App Widget和我们应用程序运行在不同的进程中(App Widget当中的View运行在Home Screen进程中)，因此要用到RemoteViews和PendingIntent这两个类来操控桌面的控件

如果你的onDelete、onUpdate等事件没有触发，那么一个重要的原因是，你override了onReceive事件，但是又没有调用super.onReceive（），所以导致这之后的事件都不会触发，AppWidgetProvider的事件处理机制是，onRecieve首先触发，然后由onReceive去触发后续事件。