Android中选取并绑定AppWidget
Android添加一个窗口小部件的过程,实际是AppWidgetHost选取AppWidgetProvider并与之绑定的过程。一般地,Launcher扮演AppWidgetHost角色,AppWidgetProvider可以从所有已安装的AppWidgetProvider列表中选取。本文以描述选取并绑定AppWidgetProvider的这一过程。
一、Launcher发起选取申请
在桌面上选取窗口小部件的过程,实际是Launcher,发起选取AppWIdget申请,只需要用startActivityForResult()并用AppWidgetManager.ACTION_APPWIDGET_PICK为Intent的Action启动另外的Activity,等待选取的结果。
图一、LauncherPick AppWidget类图
Launcher是一个Activity,具有Activity的启动另外的Activity并等待结果的能力和相应的方法。Launcher中还定义了AppWIdgetHost的子类LauncherAppWidgetHost。
Launcher发起PickAppWIdget的时序如下图:
图二、LauncherPick AppWidget的顺序图
先用AppWidgetHost申请一个AppWidget的ID;
新建一个AppWidgetManager.ACTION_APPWIDGET_PICK的Intent,并把上面申请的appWidgetId作为AppWidgetManager.EXTRA_APPWIDGET_ID的参数,启动另外的Activity完成AppWidget的选取工作,并等待结果再来处理。
发出启动响应AppWidgetManager.ACTION_APPWIDGET_PICK的Activity之后,Android系统会从已经安装的apk中选择Intent-filter中含有AppWidgetManager.ACTION_APPWIDGET_PICK的Activity,并启动之。
Settings里的AppWidgetPickActivity是这样的一个Activity,下面看它如何处理。
二、AppWidgetPickActivity静态结构
AppWidgetPickActivity类图如下:
图三、AppWidgetPickActivity类图
AppWidgetPickActivity类继承关系:AppWidgetPickActivity –>ActivityPicker -> AlertActivity。ActivityPicker中有PickerAdapter,用来PickItem,并在PickerAdapter.Item中填充显示给用户所需的数据。
AppWidgetPickActivity通过AppWidgetManager.getInstalledProviders()获取已经安装的所有的AppWidgetProvider,这些AppWidgetProvider的信息以AppWidgetProviderInfo的形式存储。
AppWidgetPickActivity 的父类ActivityPicker实现了DialogInte易做图ce.OnClickListener和DialogInte易做图ce.OnCancelListener,可响应用户的选择。用户选择其中的一个AppWidgetProvider之后,把AppWidgetId与其绑定。
三、获取所有已安装的AppWidgetProvider
图四是获取所有已安装AppWidgetProvider的信息,并生成PickerAdapter.Item的过程。
图四、获取所有已安装AppWidgetProvider列表的顺序图
AppWidgetPickActivity被创建并启动的时候,通过AppWidgetManager.EXTRA_APPWIDGET_ID传入了AppWidgetId参数,这里解析出来并保存;[Seq#1~ #3]
AppWidgetPickActivity的父类ActivityPicker会通过模板模式(TemplatePattern)调用getItems()获得列表项。AppWidgetPickActivity实现getItems():[Seq#4~ #9]
通过AppWidgetManager.getInstalledProviders()获取所有已经安装的AppWidgetProvider,这些AppWidgetProvider的信息以AppWidgetProviderInfo的形式返回;[Seq#5~ #6]
创建PickerAdapter.Item,并把AppWidgetProviderInfo中的对应项设置到PickerAdapter.Item内,并把所有的这些Item放入items:ArrayList<PickerAdapter.Item>;[Seq#7 ~ #8]
从getItems()中返回,并带回返回值items[Seq#9]
getItems()带回Item并返回之后,ActivityPicker会把这些项以列表形式显示出来。接下来,如果用户选择其中某项之后,就实现了选取AppWidgetProvider并与AppWidgetId绑定。
四、选取并绑定一个AppWidgetProvider
图五是用户选择一个AppWidgetProvider,把AppWidgetId与其绑定的过程。
图五、选取并绑定AppWidgetProvider的顺序图
用户选择了列表中的某个AppWidgetProvider;[Seq#1]
通过列表中的位置which获得Intent,实际是Provider的packageName和className设置进了Intent的Component里;[Seq#2 ~ #5]
把图四#3中获得的AppWidgetId(也就是Launcher这个AppWidgetHost在图二#1&2中通过AppWidgetHost申请到的ID)与这个AppWidgetProvider绑定;[Seq#6~ #7]
把选择的结果通过Activity.setResult()设置,并把appWidgetId以Intent参数形式传回。[Seq#8~ #10]
这样启动AppWidgetPickActivity的Activity也就是Launcher,就会在其onActivityResult()中获得选择的结果。
因为,获得结果之后,Launcher所做的工作是作为AppWidgetHost的工作,这将在《Android中AppWidget的分析与应用:AppWidgetHost》中再详细阐述。
五、总结
Launcher发起选取AppWidgetProvider的动作。
AppWidgetPickActivity获得所有已安装AppWidgetProvider的列表,并呈现给用户。用户选择之后,把AppWidgetId与AppWidgetProvider绑定。
Launcher作为AppWidgetHost负责把AppWidgetProvider里通过RemoteViews传递的图形元素显示出来;并负责用户操作事件通知到AppWidgetProvider。
可进一步参考文章
Android AppWidget框架
AppWidget系统框架。
Android中选取并绑定AppWidget
本文。
Android中AppWidget的分析与应用:AppWidgetProvider
可以看AppWidgetManager/AppWidgetService收集AppWidgetProvider的哪些信息,放在所以已安装AppWidgetProvider列表里的。并可以学习AppWidgetProvider如何创建和设置RemoteViews。
Android中AppWidget的分析与应用:AppWidgetHost
可以看选取并绑定AppWidgetProvider之后,Launcher作为AppWidgetHost如何创建显示RemoteViews里AppWidgetProvider所提供的图形元素。
Android中RemoteViews的实现
Android中RemoteViews的内部具体实现。
补充:移动开发 , Android ,