Android 11 App Widget不显示/为空问题排查与适配咨询

一、Widget宽高的合理设置规则 #

你遇到的宽高适配问题，本质是不同Android版本对Widget尺寸的网格限制差异：

• Android 12+采用灵活的DP网格系统，直接设置minWidth/minHeight即可适配
• Android 11及以下遵循传统网格计算逻辑：每个网格单元对应70dp（含launcher间距），最小尺寸公式为 (n * 70) - 30（n为占用的网格数）
• 原配置中400dp的高度超出了部分Android 11设备launcher支持的最大可显示高度，导致Widget无法被识别或加载失败；调整为300dp后符合多数设备的网格限制，因此恢复正常。

适配建议：

• 参照官方网格尺寸规范设置最小宽高，优先选择主流设备支持的尺寸（比如2x3网格对应宽110dp、高180dp）
• 避免设置过大的固定尺寸，尽量使用wrap_content或自适应布局（若业务允许）
• 测试覆盖不同屏幕尺寸和Android版本的设备，确保兼容性

二、主线程加载网络图片的问题解析与适配 #

问题根源 #

App Widget的RemoteViews运行在系统的AppWidgetService进程中，主线程不允许执行耗时操作：

• Android 12对主线程耗时限制有所放宽，但Android 11及以下会直接阻塞Widget初始化，导致内容为空
• 当URL为空时，无网络请求阻塞主线程，因此Widget能正常显示

适配要点 #

• 绝对禁止在RemoteViews更新逻辑中使用主线程做网络请求，必须将图片下载放到后台线程（如Coroutine、WorkManager）
• 图片下载完成后保存到应用内部存储（无需额外权限），再通过BitmapFactory.decodeFile()加载本地文件生成Bitmap，最后设置到RemoteViews
• 处理异常场景：添加图片加载失败的占位图，避免Widget因加载错误空白
• 优化体验：实现图片缓存逻辑，重复加载时直接读取本地文件，减少网络请求

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