Android中选取并绑定AppWidget

来源:互联网 发布:淘宝网童装女童秋装 编辑:程序博客网 时间:2024/04/27 23:37

田海立@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,等待选取的结果。

Launcher Pick AppWidget ClassHierarchy

图一、LauncherPick AppWidget类图

 

Launcher是一个Activity,具有Activity的启动另外的Activity并等待结果的能力和相应的方法。Launcher中还定义了AppWIdgetHost的子类LauncherAppWidgetHost。

 

Launcher发起PickAppWIdget的时序如下图:

Launcher Pick AppWidget Sequence Diagram

图二、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类图如下:

 Settings AppWidgetPickActivity class Diagram

图三、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的过程。

Settings AppWidgetPickActivity getInstalledProviders Sequence Diagram

图四、获取所有已安装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与其绑定的过程。

 Settings AppWidgetPickActivity Pick and bindAppWidget Sequence Diagram

图五、选取并绑定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的内部具体实现。

 

原创粉丝点击