Launcher3 AppWidget挂件显示原理

原创

已于 2024-08-26 14:01:10 修改 · 611 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#android

于 2024-07-05 11:38:52 首次发布

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

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效果: