当前位置:操作系统 > 安卓/Android >>

Android中选取并绑定AppWidget

Android添加一个窗口小部件的过程,实际是AppWidgetHost选取AppWidgetProvider并与之绑定的过程。一般地,Launcher扮演AppWidgetHost角色,AppWidgetProvider可以从所有已安装的AppWidgetProvider列表中选取。本文以描述选取并绑定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的顺序图

 


先用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类图如下:

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

 


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与其绑定的过程。

 Settings AppWidgetPickActivity Pick and bindAppWidget Sequence Diagram

图五、选取并绑定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 ,
CopyRight © 2012 站长网 编程知识问答 www.zzzyk.com All Rights Reserved
部份技术文章来自网络,