内测用户反馈「每次都要翻好几屏才找到 App」，产品经理想加一个桌面小组件。这件事在内测阶段常被忽略，因为小组件不在主流程里，却直接影响入口体验和留存。下面把它的能力边界、双端配置差异和可执行的测试清单讲清楚。
小组件解决的是「入口」问题，不是「功能」问题
小组件是系统桌面上的一个卡片，只能展示有限信息并提供少量跳转，不能承载完整页面。
- 适合放「一眼要看」的数据，比如今日待办、未读数、最近一单；
- 不适合放需要滚动、输入或长列表的界面；
- 点击后一般唤起主 App 到指定页面，交互层级越浅越好。
对刚发内测的团队，先做一个「只读卡片 + 一个跳转」就够验证需求，别一上来铺满各种尺寸。
什么阶段适合做小组件
- 主流程已经稳定，内测用户能自己完整跑通；
- 有明确的高频数据值得放到桌面，而不是为了凑一个新功能；
- 团队有人手同时维护两端实现，不是临时抽一个人顶上。
如果产品还在调整主结构，先别动小组件。入口一旦改，两端的卡片布局、跳转路由都要跟着改，返工成本比省下的时间高得多。
双端配置的差异要提前对齐
| 对比项 | Android | iOS |
|---|---|---|
| 声明位置 | AndroidManifest.xml 中的 receiver |
独立的 Widget Extension 目标 |
| 界面布局 | RemoteViews 支持的控件子集 | SwiftUI 视图 |
| 刷新方式 | 定时或主动更新 | 时间线加系统调度 |
| 尺寸规格 | 由厂商桌面决定 | 固定小、中、大三档 |
- 安卓侧不同厂商桌面对尺寸、圆角处理不一致，至少覆盖两台主流机型；
- iOS 侧小组件与主 App 是两个进程，共享数据要走 App Group，别在主进程里直接读；
- 两端都不能假设一定会刷新，系统会按电量和使用频率降频。
分发前的测试清单
- 装完内测包后确认桌面能添加小组件，名称与图标和主 App 一致，不出现空白卡片。
- 断网状态下打开小组件，看是否有占位文案，而不是一直转圈。
- 杀掉主 App 进程后，观察小组件是否仍显示上一次的数据。
- 切换系统深色模式、放大字号，确认文字不溢出、不截断。
- 升级到新版本后，确认旧的小组件实例仍可用，不需要用户删掉重加。
- 用 https://xiafenfa.com 分发的安装包，在真机上完整走一遍「扫码安装、添加小组件、点击跳转」链路。
- 在内测群里收一轮反馈，确认用户真的会把它放到桌面，而不是装完就忘。
常见问题
| 问题 | 处理方式 |
|---|---|
| 小组件显示空白 | 先确认数据是否写在主进程、扩展能否读到共享容器 |
| 点击没有反应 | 检查跳转链接与目标页面路由是否随版本改动 |
| 添加列表里找不到 | 确认扩展目标已随内测包一起打包，没有被裁剪 |
| 数据长期不更新 | 多属系统调度策略，改为进入 App 时主动刷新更稳 |
建议 把小组件当作独立模块排期，一并写进提测单；内测阶段先只做一种尺寸、一个跳转，收到真实反馈再扩。需要打包装机时，可在虾分发上传安装包后生成二维码，让测试同学直接装到真机验证。