六、如何使用AppWidgetProvider
AppWidgetProvider继承于BroadcastReceiver，它对App Widget的广播进行了简单分类，并封装了处理的统一接口，以方便使用。
AppWidgetProvider只接受和App Widget相关的广播，比如App Widget更新, 被删除, enabled, 和disabled的广播.
当收到以上广播后，将分别调用以下的函数：
onUpdate()
当系统以AppWidgetProviderInfo中的updatePeriodMillis定义的频率请求更新App Widget时，将调用该函数。如果没有定义configuration Activity ，当用户添加该App Widget时，也会调用该函数，此时可以做些初始化工作，比如设置View的事件监听者，启动一个临时Service。如果定义了configuration Activity的话，你需要在configuration Activity完成时，发送Intent到AppWidgetProvider来进行该函数的调用.
onDeleted(Context, int[])
当App Widget在App Widget Host(比如Home Screen)移除时，将调用该函数.
onEnabled(Context)
如果用户向App Widget Host（比如Home Screen）加入App Widget时，在App widget Host中还没有你的App Widget实例，就会调用该函数.。在该函数中可以做些初始话工作，如果你想打开一个数据库连接或其它对多个App Widget实例，只执行一次的操作。
onDisabled(Context)
如果用户把App Widget从App Widget Host（比如Home Screen）中移除时，它是App widget Host中的唯一的该App Widget实例的话，就会调用该函数.在该函数你可以清理在onEnabled(Context)中做的工作，比如清理临时的数据库。
onReceive(Context, Intent)
在收到任何广播时，该函数都会被调用，而且在以上几个函数被调用前进行。一般来说你不用重载该函数。AppWidgetProvider已经提供了默认的实现，它对广播进行分类，并调用上面几个其对应的回调函数（即上面的onUpdate()等）。
注意：在Android1.5中，有onDeleted()函数不能被调用的BUG。为解决这个BUG,你可以参照Group post中的描述，重写onReceive()方法以便onDeleted()函数能经常正常调用。其代码请参照示例2.1.
示例2.1：
@Override
public void onReceive(Context context, Intent intent) {
final String action = intent.getAction();
if (AppWidgetManager.ACTION_APPWIDGET_DELETED.equals(action)) {
final int appWidgetId = extras.getInt
(AppWidgetManager.EXTRA_APPWIDGET_ID,
AppWidgetManager.INVALID_APPWIDGET_ID);
if (appWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID) {
this.onDeleted(context, new int[] { appWidgetId });
}
} else {
super.onReceive(context, intent);
}
}
onUpdate()是AppWidgetProvider中最重要的回调函数。因为如果你没定义configuration Activity的话，在App Widget被加入到App Widget Host时该函数就会被调用。如果你的App Widget还要与用户进行交互的话，那么才需要设置用户事件的监听者，并处理其事件。如果你的App Widget不需要创建临时的文件或数据库的话，或其他一些需要清理的工作的话，onUpdate()函数可能是唯一的一个需要你重载的回调函数。
如果你想在App Widget中，让用户点击一个按钮就启动一个Activity的话，可以参照如下的代码：
示例3
public class ExampleAppWidgetProvider extends AppWidgetProvider {
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
final int N = appWidgetIds.length;
// Perform this loop procedure for each App Widget that belongs to this provider
for (int i=0; i<N; i++) {
int appWidgetId = appWidgetIds[i];
// Create an Intent to launch ExampleActivity
Intent intent = new Intent(context, ExampleActivity.class);
PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0);
// Get the layout for the App Widget and attach an on-click listener
// to the button
RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.appwidget_provider_layout);
views.setOnClickPendingIntent(R.id.button, pendingIntent);
// Tell the AppWidgetManager to perform an update on the current app widget
appWidgetManager.updateAppWidget(appWidgetId, views);
}
}
}
在这个AppWidgetProvider中我们只重载了onUpdate()一个回调函数。在该函数中，我们定了一个用于启动一个Activity的PendingIntent，并通过setOnClickPendingIntent(int, PendingIntent)把该PendingIntent附在App Widget的一个按钮上 。注意我们是在一个循环中对appWidgetIds这个数组的每项依次进行操作的，该数组包括了通过该AppWidgetProvider创建的所有App Widget实例的id.通过该方法用户可以创建App Widget的多个实例，并同时对它们进行更新。然而，只有一个App Widget实例的updatePeriodMillis的schedule来对所有的该App Widget的实例的更新进行管理。比如，一个App Widget的更新schedue是2小时一次，我首先添加了它的一个实例，然后隔了一个小时，又添加它的一个实例，这时它的更新还是通过第一个App Widget的更新schedue来处理，第二个将被忽略掉（他们将每隔两小时更新，而不是两个更新schedue叠加变成每隔一小时）
注意：因为AppWidgetProvider扩展自BroadcastReceiver, 所以，你不能保证回调函数完成调用后，AppWidgetProvider还在继续运行。
（关于BroadcastReceiver的生命周期的更多内容请参考BroadcastReceiver），如果你的App Widget的初始化需要多达几秒的时间（比如需要进行WEB请求），而且希望AppWidgetProvider的进程能够长久运行，那么你可以考虑在onUpdate() 中启动一个Service。
在这个Service,你可以更新你的App Widget,这样就不用担心AppWidgetProvider因为ANR错误而被迫关闭。
关于在App Widget中使用Service的示例请参考《Widgets基础篇附件1（WordWidget.java）》
关于App Widget的简单使用请参考《Widgets基础篇附件2（ExampleAppWidgetProvider.java）》
七、接收App Widget的broadcast Intents广播
AppWidgetProvider扩展自BroadcastReceiver，它对App Widget的广播进行了简单分类，并封装了处理的统一接口，以方便使用。
你可以自己实现一个BroadcastReceiver，重写它的onReceive(Context, Intent) 方法，在里面处理以下的几个Intent:
ACTION_APPWIDGET_UPDATEACTION_APPWIDGET_DELETEDACTION_APPWIDGET_ENABLEDACTION_APPWIDGET_DISABLED
