Android中的AppWidget(上)

本文转自： http://www.csfeixun.com/2009/html/483.htm

 

·   Android 中的AppWidget 与google widget 和中移动的widget 并不是一个概念，这里的AppWidget 只是把一个进程的控件嵌入到别外一个进程的窗口里的一种方法。View 在另 外一个进程里显示，但事件的处理方法还是在原来的进程里。这有点像 X Window 中的嵌入式窗口。
broncho-a1-widget

Android 中的AppWidget 包括以下几个部分：

AppWidgetProvider

AppWidgetProvider 是AppWidget 提供者需要实现的接口，它实际上是一个BroadcastReceiver 。只不过子类要实现的不再是onReceive ，而是转换成了几个新的函数：

public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds)
public void onDeleted(Context context, int[] appWidgetIds)
public void onEnabled(Context context)
public void onDisabled(Context context)

这几个函数用来响应AppWidgetService 发出的相应的广播消息。

AppWidgetProvider 的实现者

作为AppWidgetProvider 的实现者，一定要实现onUpdate 函数，因为这个函数决定widget 的显示方式，如果没有这个函数widget 根本没办法出现。

void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds)

onUpdate 的实现基本上遵循下面的流程：

o 创建RemoteViews
o 调用AppWidgetManager 的updateAppWidget 去更新widget.

现在我们看下Music 里的MediaAppWidgetProvider 实现：

    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
        defaultAppWidget(context, appWidgetIds);
 
        // Send broadcast intent to any running MediaPlaybackService so it can
        // wrap around with an immediate update.
        Intent updateIntent = new Intent(MediaPlaybackService.SERVICECMD);
        updateIntent.putExtra(MediaPlaybackService.CMDNAME,
                MediaAppWidgetProvider.CMDAPPWIDGETUPDATE);
        updateIntent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_IDS, appWidgetIds);
        updateIntent.addFlags(Intent.FLAG_RECEIVER_REGISTERED_ONLY);
        context.sendBroadcast(updateIntent);
    }

在defaultAppWidget 里面：
o 创建RemoteViews ，并设置相应的属性。

       final Resources res = context.getResources();
        final RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.album_appwidget);
 
        views.setViewVisibility(R.id.title, View.GONE);
        views.setTextViewText(R.id.artist, res.getText(R.string.emptyplaylist));

o 为View 上的控制设置事件处理方法。

        linkButtons(context, views, false /* not playing */);
 
       private void linkButtons(Context context, RemoteViews views, boolean playerActive) {
        // Connect up various buttons and touch events
        Intent intent;
        PendingIntent pendingIntent;
 
        final ComponentName serviceName = new ComponentName(context, MediaPlaybackService.class);
 
        if (playerActive) {
            intent = new Intent(context, MediaPlaybackActivity.class);
            pendingIntent = PendingIntent.getActivity(context,
                    0 /* no requestCode */, intent, 0 /* no flags */);
            views.setOnClickPendingIntent(R.id.album_appwidget, pendingIntent);
        } else {
            intent = new Intent(context, MusicBrowserActivity.class);
            pendingIntent = PendingIntent.getActivity(context,
                    0 /* no requestCode */, intent, 0 /* no flags */);
            views.setOnClickPendingIntent(R.id.album_appwidget, pendingIntent);
        }
 
        intent = new Intent(MediaPlaybackService.TOGGLEPAUSE_ACTION);
        intent.setComponent(serviceName);
        pendingIntent = PendingIntent.getService(context,
                0 /* no requestCode */, intent, 0 /* no flags */);
        views.setOnClickPendingIntent(R.id.control_play, pendingIntent);
 
        intent = new Intent(MediaPlaybackService.NEXT_ACTION);
        intent.setComponent(serviceName);
        pendingIntent = PendingIntent.getService(context,
                0 /* no requestCode */, intent, 0 /* no flags */);
        views.setOnClickPendingIntent(R.id.control_next, pendingIntent);
    }

o 更新widget

    pushUpdate(service, appWidgetIds, views);
    private void pushUpdate(Context context, int[] appWidgetIds, RemoteViews views) {
        // Update specific list of appWidgetIds if given, otherwise default to all
        final AppWidgetManager gm = AppWidgetManager.getInstance(context);
        if (appWidgetIds != null) {
            gm.updateAppWidget(appWidgetIds, views);
        } else {
            gm.updateAppWidget(THIS_APPWIDGET, views);
        }
    }

RemoteViews

RemoteViews 并不是一个真正的View ，它没有实现View 的接口，而只是一个用于描述View 的实体。比如：创建View 需要的资源ID 和各个控件的事件响应方法。RemoteViews 会通过进程间通信机制传递给AppWidgetHost 。

现在我们可以看出，Android 中的AppWidget 与google widget 和中移动的widget 并不是一个概念，这里的AppWidget 只是把一个进程的控件嵌入到别外一个进程的窗口里的一种方法。View 在另 外一个进程里显示，但事件的处理方法还是在原来的进程里。这有点像 X Window 中的嵌入式窗口。