Android中的AppWidget(上)

转载时请注明出处和作者联系方式

文章出处：http://www.limodev.cn/blog

作者联系方式：李先静 <xianjimli at hotmail dot com>

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中的嵌入式窗口。

(待续)