WidgetKit 单次创建 Timeline 条目是否存在数量限制？

基础限制说明 #

苹果官方没有公开给出单次提交 Timeline 条目的硬数量上限，但实际运行中存在基于设备性能、条目内存占用的隐含约束：

• 单次提交100条 Timeline 条目完全可以正常通过系统校验，不会被直接拦截，这个量级属于官方允许的合理范围。
• 实际可提交的最大条目数和单条条目占用的内存强相关：如果你的条目仅存储时间戳、文本类轻量数据，单次提交200~300条也不会触发异常；如果单条条目携带大尺寸图片、大量序列化数据，就算仅提交几十条也可能因为内存超限被系统丢弃。

多条目对更新速度的影响 #

提前提交大量未来 Timeline 条目，不会降低用户修改内容时的更新速度：
当你调用 WidgetCenter.shared.reloadAllTimelines() 或者 reloadTimelines(ofKind:) 方法触发更新时，系统会直接清除所有未执行的旧 Timeline 条目，直接加载你新提交的条目，旧的未使用条目不会参与新更新的计算流程，不存在额外开销。

实践优化建议 #

• 日程类 widget 建议单次提交的条目控制在100_{200条以内，优先覆盖未来1}2周的高频展示时段即可，更久的内容可以等 Timeline 运行到最后一个条目触发系统回调时再补充提交，既可以保证 widget 离线时也能长时间正常展示，也不会无意义占用设备后台内存。
• 不建议为了覆盖几个月后的内容一次性提交上千条条目，就算系统能够正常接收，也属于不必要的资源浪费，不符合系统优化规范。
• 用户修改日程内容时，直接触发对应 widget 的 Timeline 刷新即可，不需要额外处理旧的待执行条目，系统会自动完成清理。

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