kwgt 小组件不显示 桌面空白 Loading 或崩溃排查

分类排查

kwgt 小组件"不显示"通常分成三类：空白矩形、Loading 不止、直接消失。不同症状指向不同原因。

第一类：空白矩形

桌面有 kwgt 小组件的占位区域，但里面什么都没有：

1. 小组件尺寸被压太小 → 长按调整到合理大小（至少 2×2）
2. 函数表达式错误 → 编辑器打开预设，看元素的 Text / Paint 字段有没有红色报错
3. 元素 Opacity 被设成 0 → 检查 Root 和所有元素的 Opacity 值
4. 元素被隐藏 → Items 面板里看元素的眼睛图标是不是关闭了

第二类：Loading 不止

小组件区域显示 "Loading..." 很久（超过 1 分钟）：

1. 后台保活没搞好 → 参考 重启加载慢 的三层解法（Booster + 电池优化 + 自启动）
2. kwgt 后台服务被杀了 → 手动打开一次 kwgt 主应用，看小组件会不会立即恢复
3. 网络相关函数卡住 → 如果画布上有 $http()$ 或 Weather 函数，可能在等网络超时。暂时把这些元素 Opacity 设 0 看其他元素能不能正常显示
4. 函数里有死循环或超时 → 用 Konsole 看日志（见 Konsole 控制台）

第三类：直接消失

桌面上原来的 kwgt 小组件不见了 / 被 Launcher 自动移除了：

1. 更新 kwgt 版本 → 某些版本更新后小组件需要重新添加
2. Launcher 缓存问题 → 长按桌面空白 → 重新添加 kwgt 小组件
3. 安卓系统"恢复默认设置"清除了 → 重新添加
4. AOSP 版 vs Play 版冲突 → 不能同时装两个 kwgt 包名不同的版本

终极排查：新建空白预设

1. 新建一个完全空白的 kwgt 预设（只有 Root 层，加一个最简单的 Text 元素显示 "hello"）
2. 保存并应用到桌面
3. 如果这个最简单的预设也不显示 → 问题在 系统权限 / Launcher / App 安装本身
4. 如果这个能正常显示 → 问题出在你原来的预设里（某个元素 / 函数 / 图片资源有问题）

常见 Launcher 坑

• Nova Launcher → 基本没问题，社区推荐最多
• 微软 Launcher → 偶尔和小组件刷新有冲突
• 厂商自带 Launcher → 最容易出问题，换第三方 Launcher 试试