Launcher3 AppWidget挂件显示原理

手机开机和重启过程中,有低概率机出现挂件不显示的情况,对整个显示流程和原理进行梳理.

1.AppWidget  介绍

应用程序窗口小部件App Widgets

应用程序窗口小部件（Widget）是微小的应用程序视图，叫 应用微件 或者 小组件/插件. 可以被嵌入到其它应用程序中（比如桌面）并接收周期性的更新。你可以通过一个App Widget provider来发布一个Widget。

可以容纳其它App Widget的应用程序组件被称为App Widget宿主。

特点是:

1). 是可以嵌入其他应用（如主屏幕）并 接收定期 更新的微型应用视图。

2). 这些视图称为界面中的微件. 

2.Launcher3是如何将AppWidget显示到桌面的? 

• 桌面布局配置
• 布局配置信息解析
• 构建AppWidgetHostView 和LauncherAppWidgetInfo
• 添加到桌面 Widget变化监听

   2.1桌面布局配置

        在桌面布局配置文件中配置桌面显示的Widget,如default_workspace_mini.xml, 告知launcher将要显示Widget的位置和widget组件的基本信息,如:

<appwidget

launcher:className="com.ape.factory.AppwidgetSnProvider"

launcher:packageName="com.ape.factory"

launcher:screen="0"

launcher:spanX="0"

launcher:spanY="0"

launcher:x="0"

launcher:y="0" />

2.2 布局配置信息解析

    Launcher.onCreate开始加载并解析桌面布局配置文件,解析完成后回调到Launcher中开机将Widget添加到桌面CellLayout.

    序列图如下所示:

    

  2.3 构建AppWidgetHostView 和LauncherAppWidgetInfo添加到桌面 

             模拟时钟的Widget, 添加到桌面. label 是模拟时钟的名称,  configure的配置界面,点击widget时会启动该界面.

               label:Analog    

          configure:ComponentInfo{com.google.android.deskclock/com.android.deskclock.AnalogAppWidgetConfigActivity} 

             通过adb命令查询可以得知, 此时模拟时钟在系统中的WidgetId 是19, 命令是 adb shell dumpsys appwidget |grep -E "Analog"

   

             已知WidgetId显示:          

                  AppWidgetHost.startListening 开始监听接收AppWidget的onAppWidgetChange          获取WidgetProviderInfo , 构建HostView 并添加到视图树中. 

mAppWidgetHost.startListening()

FrameLayout frameLayout = findViewById(R.id.fr_widget);

int appWidgetId = 19;      /// 已知widgetId

AppWidgetProviderInfo appWidget = manager.getAppWidgetInfo(appWidgetId);

AppWidgetHostView hostView = mAppWidgetHost.createView(this, appWidgetId, appWidget);

frameLayout.addView(hostView);

初次加载显示Widget,针对没有WidgetId的情况  :

    初次加载显示Widget , 或是通过AppWidgetManager. getLauncherAppWidgetInfo(item.appWidgetId)获取不到Widget信息  --AppWidgetProviderInfo.   则需要通过以下流程获取:

  (1). AppWidgetHost.allocateAppWidgetId 申请Id;  

  (2). AppWidgetManager.bindAppWidgetIdIfAllowed (currentAppWidgetId, cn), 通过Id和ComponentName信息, 向AppWidgetService发起服务端的绑定;    

  (3). AppWidgetManager.getLauncherAppWidgetInfo(item.appWidgetId)获取Widget的信息;   

  (4). 将新的Widget信息更新到Launcher 的DB中.

  (5). 构建HostView 并添加到视图树中.

  在Host app显示模拟时钟Widget的demo效果: