Widgets基础篇（中）

文章参照自： http://developer.android.com/guide/topics/appwidgets/index.html

六、如何使用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_UPDATE
• ACTION_APPWIDGET_DELETED
• ACTION_APPWIDGET_ENABLED
• ACTION_APPWIDGET_DISABLED