本文深入解析Android中的AppWidget机制，包括其组成部分如AppWidgetProvider、RemoteViews等，并探讨了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在哪里显示了。
扫一扫
606
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
