Android中的AppWidget
Android中的AppWidget与google widget和中移动的widget并不是一个概念,这里的AppWidget只是把一个进程的控件嵌入到别外一个进程的窗口里的一种方法。View在另 外一个进程里显示,但事件的处理方法还是在原来的进程里。这有点像 X Window中的嵌入式窗口。
Android中的AppWidget包括以下几个部分:
AppWidgetProvider
AppWidgetProvider是AppWidget提供者需要实现的接口,它实际上是一个BroadcastReceiver。只不过子类要实现的不再是onReceive,而是转换成了几个新的函数:
1 public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds)
2 public void onDeleted(Context context, int[] appWidgetIds)
3 public void onEnabled(Context context)
4 public void onDisabled(Context context)
这几个函数用来响应AppWidgetService发出的相应的广播消息。
AppWidgetProvider的实现者
作为AppWidgetProvider的实现者,一定要实现onUpdate函数,因为这个函数决定widget的显示方式,如果没有这个函数widget根本没办法出现。
1 void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds)
onUpdate的实现基本上遵循下面的流程:
o 创建RemoteViews
o 调用AppWidgetManager的updateAppWidget去更新widget.
现在我们看下Music里的MediaAppWidgetProvider实现:
1 public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
2 defaultAppWidget(context, appWidgetIds);
3
4 // Send broadcast intent to any running MediaPlaybackService so it can
5 // wrap around with an immediate update.
6 Intent updateIntent = new Intent(MediaPlaybackService.SERVICECMD);
7 updateIntent.putExtra(MediaPlaybackService.CMDNAME,
8 MediaAppWidgetProvider.CMDAPPWIDGETUPDATE);
9 updateIntent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_IDS, appWidgetIds);
10 updateIntent.addFlags(Intent.FLAG_RECEIVER_REGISTERED_ONLY);
11 context.sendBroadcast(updateIntent);
12 }
在defaultAppWidget里面:
o 创建RemoteViews,并设置相应的属性。
1 final Resources res = context.getResources();
2 final RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.album_appwidget);
3
4 views.setViewVisibility(R.id.title, View.GONE);
5 views.setTextViewText(R.id.artist, res.getText(R.string.emptyplaylist));
o 为View上的控制设置事件处理方法。
1 linkButtons(context, views, false /* not playing */);
2
3 private void linkButtons(Context context, RemoteViews views, boolean playerActive) {
4 // Connect up various buttons and touch events
5 Intent intent;
6 PendingIntent pendingIntent;
7
8 final ComponentName serviceName = new ComponentName(context, MediaPlaybackService.class);
9
10 if (playerActive) {
11 intent = new Intent(context, MediaPlaybackActivity.class);
12 pendingIntent = PendingIntent.getActivity(context,
13 0 /* no requestCode */, intent, 0 /* no flags */);
14 views.setOnClickPendingIntent(R.id.album_appwidget, pendingIntent);
15 } else {
16 intent = new Intent(context, MusicBrowserActivity.class);
17 pendingIntent = PendingIntent.getActivity(context,
18 0 /* no requestCode */, intent, 0 /* no flags */);
19 views.setOnClickPendingIntent(R.id.album_appwidget, pendingIntent);
20 }
21
22 intent = new Intent(MediaPlaybackService.TOGGLEPAUSE_ACTION);
23 intent.setComponent(serviceName);
24 pendingIntent = PendingIntent.getService(context,
25 0 /* no requestCode */, intent, 0 /* no flags */);
26 views.setOnClickPendingIntent(R.id.control_play, pendingIntent);
27
28 intent = new Intent(MediaPlaybackService.NEXT_ACTION);
29 intent.setComponent(serviceName);
30 pendingIntent = PendingIntent.getService(context,
31 0 /* no requestCode */, intent, 0 /* no flags */);
32 views.setOnClickPendingIntent(R.id.control_next, pendingIntent);
33 }
o 更新widget
1 pushUpdate(service, appWidgetIds, views);
2 private void pushUpdate(Context context, int[] appWidgetIds, RemoteViews views) {
3 // Update specific list of appWidgetIds if given, otherwise default to all
4 final AppWidgetManager gm = AppWidgetManager.getInstance(context);
5 if (appWidgetIds != null) {
6 gm.updateAppWidget(appWidgetIds, views);
7 } else {
8 gm.updateAppWidget(THIS_APPWIDGET, views);
9 }
10 }
RemoteViews
RemoteViews并不是一个真正的View,它没有实现View的接口,而只是一个用于描述View的实体。比如:创建View需要的资源ID和各个控件的事件响应方法。RemoteViews会通过进程间通信机制传递给AppWidgetHost。
现在我们可以看出,Android中的AppWidget与google widget和中移动的widget并不是一个概念,这里的AppWidget只是把一个进程的控件嵌入到别外一个进程的窗口里的一种方法。View在另 外一个进程里显示,但事件的处理方法还是在原来的进程里。这有点像 X Window中的嵌入式窗口。
AppWidgetHost
AppWidgetHost是真正容纳AppWidget的地方,它的主要功能有两个:
o 监听来自AppWidgetService的事件:
1 class Callbacks extends IAppWidgetHost.Stub {
2 public void updateAppWidget(int appWidgetId, RemoteViews views) {
3 Message msg = mHandler.obtainMessage(HANDLE_UPDATE);
4 msg.arg1 = appWidgetId;
5 msg.obj = views;
6 msg.sendToTarget();
7 }
8
9 public void providerChanged(int appWidgetId, AppWidgetProviderInfo info) {
10 Message msg = mHandler.obtainMessage(HANDLE_PROVIDER_CHANGED);
11 msg.arg1 = appWidgetId;
12 msg.obj = info;
13 msg.sendToTarget();
14 }
15 }
这是主要处理update和provider_changed两个事件,根据这两个事件更新widget。
1 class UpdateHandler extends Handler {
2 public UpdateHandler(Looper looper) {
3 super(looper);
4 }
5
6 public void handleMessage(Message msg) {
7 switch (msg.what) {
8 case HANDLE_UPDATE: {
9 updateAppWidgetView(msg.arg1, (RemoteViews)msg.obj);
10 break;
11 }
12 case HANDLE_PROVIDER_CHANGED: {
13 onProviderChanged(msg.arg1, (AppWidgetProviderInfo)msg.obj);
14 break;
15 }
16 }
17 }
18 }
o 另外一个功能就是创建AppWidgetHostView。前面我们说过RemoteViews不是真正的View,只是View的描述,而 AppWidgetHostView才是真正的View。这里先创建AppWidgetHostView,然后通过AppWidgetService查询 appWidgetId对应的RemoteViews,最后把RemoteViews传递给AppWidgetHostView去 updateAppWidget。
1 public final AppWidgetHostView createView(Context context, int appWidgetId,
2 AppWidgetProviderInfo appWidget) {
3 AppWidgetHostView view = onCreateView(context, appWidgetId, appWidget);
4 view.setAppWidget(appWidgetId, appWidget);
5 synchronized (mViews) {
6 mViews.put(appWidgetId, view);
7 }
8 RemoteViews views = null;
9 try {
10 views = sService.getAppWidgetViews(appWidgetId);
11 } catch (RemoteException e) {
12 throw new RuntimeException("system server dead?", e);
13 }
14 view.updateAppWidget(views);
15 return view;
16 }
AppWidgetHostView
AppWidgetHostView是真正的View,但它只是一个容器,用来容纳实际的AppWidget的View。这个AppWidget的View是根据RemoteViews的描述来创建。这是在updateAppWidget里做的:
1 public void updateAppWidget(RemoteViews remoteViews) {
2 ...
3 if (content == null && layoutId == mLayoutId) {
4 try {
5 remoteViews.reapply(mContext, mView);
6 content = mView;
7 recycled = true;
8 if (LOGD) Log.d(TAG, "was able to recycled existing layout");
9 } catch (RuntimeException e) {
10 exception = e;
11 }
12 }
13
14 // Try normal RemoteView inflation
15 if (content == null) {
16 try {
17 content = remoteViews.apply(mContext, this);
18 if (LOGD) Log.d(TAG, "had to inflate new layout");
19 } catch (RuntimeException e) {
20 exception = e;
21 }
22 }
23 ...
24 if (!recycled) {
25 prepareView(content);
26 addView(content);
27 }
28
29 if (mView != content) {
30 removeView(mView);
31 mView = content;
32 }
33 ...
34 }
remoteViews.apply创建了实际的View,下面代码可以看出:
1 public View apply(Context context, ViewGroup parent) {
2 View result = null;
3
4 Context c = prepareContext(context);
5
6 Resources r = c.getResources();
7 LayoutInflater inflater = (LayoutInflater) c
8 .getSystemService(Context.LAYOUT_INFLATER_SERVICE);
9
10 inflater = inflater.cloneInContext(c);
11 inflater.setFilter(this);
12
13 result = inflater.inflate(mLayoutId, parent, false);
14
15 performApply(result);
16
17 return result;
18 }
Host的实现者
AppWidgetHost和AppWidgetHostView是在框架中定义的两个基类。应用程序可以利用这两个类来实现自己的Host。Launcher是缺省的桌面,它是一个Host的实现者。
LauncherAppWidgetHostView扩展了AppWidgetHostView,实现了对长按事件的处理。
LauncherAppWidgetHost扩展了AppWidgetHost,这里只是重载了onCreateView,创建LauncherAppWidgetHostView的实例。
AppWidgetService
AppWidgetService存在的目的主要是解开AppWidgetProvider和AppWidgetHost之间的耦合。如果 AppWidgetProvider和AppWidgetHost的关系固定死了,AppWidget就无法在任意进程里显示了。而有了 AppWidgetService,AppWidgetProvider根本不需要知道自己的AppWidget在哪里显示了。