Android 12下通过Widget Host控制Widget圆角的实现方法及适用范围

具体实现方法 #

该功能是Android 12（API 31）新增的系统级Widget显示规范，核心依赖两个系统全局维度参数：system_app_widget_background_radius（Widget外层背景的圆角半径）、system_app_widget_inner_radius（Widget内部元素的推荐圆角半径，通常比外层半径小8dp，避免内容和外层圆角冲突出现切边异常）。

实现步骤如下：

• 首先在Widget Host侧读取系统圆角参数：调用context.resources.getDimensionPixelSize()方法，读取android.R.dimen.system_app_widget_background_radius和android.R.dimen.system_app_widget_inner_radius对应的数值即可。
• 对托管的Widget视图开启圆角裁剪：拿到AppWidgetHostView实例后，先调用setClipToOutline(true)开启轮廓裁剪，再调用setOutlineProvider()自定义裁剪规则为圆角矩形，圆角值直接使用读取到的system_app_widget_background_radius数值即可。
• 可选的精细适配：如果需要Widget内部元素同步适配圆角，可以在绑定Widget时将两个半径参数通过RemoteViews的额外Bundle传递给Widget提供方，让提供方调整内部卡片、按钮等元素的圆角值匹配system_app_widget_inner_radius，优化显示一致性。

支持范围说明 #

不是只有启动器才能实现该能力，任意符合规范的Widget Host都可以实现。该功能对应的API是系统开放接口，所有申请了BIND_APPWIDGET权限、可以正常托管Widget的应用，都可以调用上述方法实现Widget圆角控制。
启动器只是最常见的Widget Host场景，其他比如负一屏、锁屏应用、桌面组件工具类应用只要满足权限要求，都可以实现完全相同的圆角控制效果。

内容的提问来源于stack exchange，提问作者Fossor