最近在弄安卓小部件（Widget）的时候，碰到个关于更新频率的事儿，就是那个叫 updatePeriodMillis 的玩意儿。今天就跟大家唠唠我当时是怎么折腾它的。
刚开始的设置
一开始嘛刚学着做小部件，就想着让它能自动更新内容，比如显示个时间或者天气啥的。查下资料，发现在定义小部件信息的那个XML文件（就是 `AppWidgetProviderInfo` 那个）里面，有个属性叫 updatePeriodMillis。看名字大概就知道，这是设置自动更新间隔时间的，单位是毫秒。
当时觉得挺简单，想着比如我做一个简单的时钟小部件，或者一个显示待办事项的，那就设置个大概的时间呗。比如一个小时更新一次？那就设置成 `3600000` (1小时 60分钟 60秒 1000毫秒)。或者半小时 `1800000`。反正就随便填个觉得差不多的值，心想这样系统就会到时间自动帮我调用 `onUpdate` 方法，省事儿！
用着用着发现问题
但是，用着用着就发现不对劲。有几种情况让我挺头疼：
- 更新不及时： 比如我做的是个待办事项列表小部件。我在主应用里刚添加一个紧急任务，我希望小部件上立马就能看到。但如果我设置的是半小时或者一小时更新一次，那我就得等好久才能看到变化，这体验也太差。
- 没必要的更新： 还有的时候，比如做个显示名言警句的小部件，可能一天换一句就行。那我设置个比较短的时间，比如半小时，那一天得更新多少次？大部分时候内容都没变，纯粹是浪费手机电量，后台也可能在做无用功。
- 固定时间的限制： 这个固定间隔时间有时候很死板。有些情况我可能希望它在特定事件发生时立刻更新，而不是傻等那个固定时间点。
我就琢磨，难道就不能更灵活点吗？我就试着把 updatePeriodMillis 的值改来改去，改短怕耗电，改长又不及时。感觉怎么调都不完美。
找到新路子：设成0
后来实在没办法，又去翻些资料，跟同行请教一下。才搞明白，这个 updatePeriodMillis 可以设置成 0！
对，你没看错，就是数字零。设置成 0 是什么意思？它的意思就是告诉系统：“你别管我这个小部件的自动更新，我自己来搞定！” 也就是说，系统不会再根据这个时间间隔来自动调用 `onUpdate` 。
这一下就打开新世界的大门！
自己动手，按需更新
把 updatePeriodMillis 设置成 0 之后，小部件就不会傻乎乎地按固定时间更新。那啥时候更新？这下就完全由我自己控制。
我是这么干的：
- 需要立即更新的时候： 比如我那个待办事项小部件，当我在主应用里添加、删除或者修改任务时，就在完成这些操作的代码后面，直接手动触发一次小部件更新。用 `AppWidgetManager` 获取到小部件的ID，然后调用 `updateAppWidget` 之类的方法，让它立刻刷新。
- 需要定时更新，但更灵活： 如果确实还需要定时更新，但又不想受 `updatePeriodMillis` 的限制（比如它的最短时间限制，或者就是想更精确控制），我可能会用 `AlarmManager` 或者 `WorkManager` 来安排一个定时任务。比如设置一个每天凌晨更新一次名言警句的任务。这样比用 `updatePeriodMillis` 灵活多，而且能配合系统的省电策略。
- 结合其他事件更新： 比如网络状态变化，或者收到推送通知，这些时候可能也需要更新小部件内容，都可以在相应的事件处理逻辑里加上手动更新小部件的代码。
这样一搞，我的小部件就变得非常“听话”。需要它立刻更新，它就立刻动起来；不需要更新的时候，它就安安静静地待着，不给手机添堵。既保证信息的实时性，又避免不必要的电量消耗。
总结一下
这回实践让我明白，那个 updatePeriodMillis 属性虽然看起来简单，直接设置一个时间就行，但并不适用于所有场景。特别是当你对小部件的更新时机有比较精细的要求时，直接把它设置成 0，然后自己接管更新逻辑，反而是一种更灵活、更高效的办法。这算是我在捣鼓小部件过程中的一点小小心得，希望能帮到同样遇到困惑的朋友。
