Android中选取并绑定AppWidget
2012-08-18
Android添加一个窗口小部件的过程，实际是AppWidgetPickActivity为AppWidgetHost选取AppWidgetProvider并与之绑定的过程。一般地，Launcher扮演AppWidgetHost角色，AppWidgetProvider可以从系统中所有已安装的AppWidgetProvider列表中选取。本文描述AppWidgetPickActivity选取并绑定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实现了DialogInterface.OnClickListener和DialogInterface.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] （可以到《Android中AppWidget的分析与应用：AppWidgetProvider》中section#3，看AppWidgetProvider如何被系统识别）
- 创建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。
可进一步参考文章
AppWidget系统框架。
本文。
Android中AppWidget的分析与应用：AppWidgetProvider
可以看AppWidgetManager/AppWidgetService收集AppWidgetProvider的哪些信息，放在所以已安装AppWidgetProvider列表里的。并可以学习AppWidgetProvider如何创建和设置RemoteViews。
Android中AppWidget的分析与应用：AppWidgetHost
可以看选取并绑定AppWidgetProvider之后，Launcher作为AppWidgetHost如何创建显示RemoteViews里AppWidgetProvider所提供的图形元素。
Android中RemoteViews的内部具体实现。