Android---App Widget(三)

使用AppWidgetProvider类

AppWidgetProvider类继承BroadcastReceiver类，它能够方便的处理AppWidget广播。AppWidgetProvider只接收与App Widget相关的的事件广播，如App Widget被更新、被删除、被启用、以及被禁用。当这些广播事件发生时，AppWidgetProvider会接收以下方法的调用：

onUpdate()

在指定的时间间隔内调用这个方法来更新App Widget，这个时间间隔通过AppWidgetProviderInfo中的updatePeriodMillis属性来定义。当用户添加App Widget时这个方法也会被调用，因此它应该执行基本的安装，如给View定义事件处理器，以及如果需要，启动临时的Service。但是如果你声明了用于配置的Activity，那么当用户添加App Widget时，这个方法就不会被调用，但随后的更新会被调用。当配置完成后，配置Activity会负责执行第一次更新。

onAppWidgetOptionsChanged()

在第一次放置Widget时，以及在调整Widget尺寸的时候，这个方法就会被调用。你可以使用这个回调方法，基于Widget的尺寸来显示和隐藏内容。通过调用getAppWidgetOptionss()方法来获取Widget的尺寸范围，它会返回一个包含以下信息的Bundle对象：

1.OPTION_APPWIDGET_MIN_WIDTH---以dp为Widget距离单位，控制当前宽度的下限。

2.OPTION_APPWIDGET_MIN_HEIGHT---以dp为Widget距离单位，控制当前高度的下限。

3.OPTION_APPWIDGET_MAX_WIDTH---以dp为Widget距离单位，控制当前宽度的上限。

4.OPTION_APPWIDGET_MAX_HEIGHT---以dp为Widget距离单位，控制当前高度的上限。

这个回调方法在API Level 16（Android4.1）中被引入。如果你实现了这个回调方法，就要确保你的app不会对它形成依赖，因为在较早版本上这个方法不会被调用。

onDeleted(Context,int[])

每次从App Widget的持有者中删除该App Widget时，都会调用这个方法。

onEnabled(Context)

当第一次创建App Widget实例时，这个方法会被调用。例如，如果用户添加了两个相同的App Widget实例，那么这个方法只会在第一次创建App Widget实例时才会被调用。如果你需要打开一个新的数据库，或者那些只要执行一次的操作，那么使用这个回调方法时一个比较好的地方。

onDisabled(Context)

当从App Widget持有者中删除最后一个你的App Widget时，这个方法会被调用，在这个方法中，应该执行一些清理工作，如删除临时的数据库等。

onReceive(Context,Intent)

每个广播在上述的回调方法之前会调用这个方法，通常你不需要实现这个方法，因为默认的AppWidgetProvider实现了对所有的App Widget广播的过滤，并且会在适当的时候调用上述的回调方法。

最重要的AppWidgetProvider回调方法时onUpdate()，因为在把App Widget添加到持有者中时（除非你使用了一个配置Activity），都会调用这个方法。如果你的App Widget接收一些用户交互事件，那么你需要用这个回调方法来注册事件处理器。如果你的App Widget不创建临时文件或数据库、或其他的必要的清理工作，那么你可以只定义onUpdate()方法。例如，如果你想要点击App Widget中的一个按钮来启动一个Activity，你可以使用下面的AppWidgetProvider实现：

publicclassExampleAppWidgetProviderextendsAppWidgetProvider{

    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
        final int N = appWidgetIds.length;

        // Performthis 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 appwidget
            appWidgetManager.updateAppWidget(appWidgetId, views);
        }
    }
}

这个AppWidget只定义了onUpdate()方法，启动定义了一个用于启动Activity的PendingIntent对象，并且用setOnClickPendingIntent(int, PendingIntent)方法把它绑定到App Widget的按钮上。注意，onUpdate()方法中使用了一个循环来遍历appWidgetIds中的每个实体，appWidgetIds中包含了由提供器创建的每个App Widget实例的标识ID。用这种方法，如果用户创建了多个App Widget实例，那么所有实例的更新都是同时执行的。但是，只有一个updatePeriodMillis计划表来管理所有的App Widget实例。例如，如果更新计划被定义成每两小时一次，并且第二App Widget实例是在第一个之后一小时添加的，那么这两个实例都会使用第一个实例所定义的更新周期，而第二实例所定义的更新周期将会被忽略。

注意：因为AppWidgetProvider类继承BroadcastReceiver类，所以在回调方法返回之后，你的处理并不保证会保持运行的状态（有关广播生命周期的信息请看BroadcastReceiver类）。如果安装你的App Widget进程需要花费几秒钟的时间（可能是因为要执行一个Web请求），并且你要求你的处理要保持连续性，那么就要考虑在onUpdate()方法中启动一个Service。在这个Service中，你可以执行对App Widget的更新，而不用担心因应用无响应（ANR）的错误而关闭AppWidgetProvider。App Widget运行Service例子请看AppWidgetProvider示例。