Android中选取并绑定AppWidget

田海立@CSDN

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的顺序图

 

1. 先用AppWidgetHost申请一个AppWidget的ID；
2. 新建一个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列表的顺序图

 

1. AppWidgetPickActivity被创建并启动的时候，通过AppWidgetManager.EXTRA_APPWIDGET_ID传入了AppWidgetId参数，这里解析出来并保存；[Seq#1~ #3]
2. 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的顺序图

 

1. 用户选择了列表中的某个AppWidgetProvider；[Seq#1]
2. 通过列表中的位置which获得Intent，实际是Provider的packageName和className设置进了Intent的Component里；[Seq#2 ~ #5]
3. 把图四#3中获得的AppWidgetId（也就是Launcher这个AppWidgetHost在图二#1&2中通过AppWidgetHost申请到的ID）与这个AppWidgetProvider绑定；[Seq#6~ #7]
4. 把选择的结果通过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的内部具体实现。