随着 iOS 系统的不断演进，Widget（小组件）已经成为提升用户体验的重要组成部分。从 iOS 14 开始，Apple 引入了全新的 WidgetKit 框架，允许开发者使用 SwiftUI 创建高度可定制、灵活展示的 Widget，并可添加到主屏幕、锁屏界面甚至待机模式中。
本篇博客将从基础概念出发，带你了解 iOS Widget 的作用、类型、开发架构以及常见误区，为后续深入开发打下坚实基础。
Widget 是什么？
Widget 是 App 的一个延伸部分，运行在系统容器中的 UI 视图，用于在不打开主应用的前提下向用户展示关键信息。它强调 轻量、及时、可定制、非交互式 的特性。
它的主要特点包括：
- 基于 SwiftUI 构建（不支持 UIKit）
- 定期刷新数据，不支持实时长连接
- 用户可添加多个尺寸、多个实例（如显示不同城市天气）
- 与主 App 分离运行，仅在系统容器中展示
WidgetKit 简介
Apple 提供了一个专门用于创建 Widget 的框架：WidgetKit 。WidgetKit 提供了以下能力：
- 定义数据源（Timeline）
- 配置 Widget 展示内容
- 与 Intent 配合实现动态参数配置
- 通过 SwiftUI 构建视图结构
WidgetKit 的基础结构如下：
swift
struct MyWidget: Widget {
var body: some WidgetConfiguration {
StaticConfiguration(kind: "MyWidget", provider: MyProvider()) { entry in
MyWidgetView(entry: entry)
}
.supportedFamilies([.systemSmall, .systemMedium, .systemLarge])
.configurationDisplayName("我的组件")
.description("显示一些有用的信息")
}
}你需要实现：
- 一个
TimelineProvider来提供数据快照 - 一个
Entry表示时间点的数据 - 一个
View构建视图 - 一个 Widget 注册点
Widget 能做什么？
| 能力 | 描述 |
|---|---|
| 展示信息 | 展示天气、待办、日历、股票、计步等轻量信息 |
| 支持多尺寸 | 用户可选小中大尺寸，StandBy Widget 等 |
| 点击跳转 | 使用 .widgetURL() 支持跳转回主 App 或 Deep Link |
| 用户配置 | 支持通过 Intent 配置不同内容，如显示不同城市或分类 |
| 定期刷新 | 可以设定刷新频率（最小15分钟），或由 App 主动请求刷新 |
Widget 做不了什么？
开发 Widget 时要注意其 运行环境是受限的沙盒容器，存在不少限制：
- ❌ 不能执行网络请求（需在主 App 中处理）
- ❌ 不支持交互控件（如 Button、TextField）
- ❌ 无法响应手势（不能滑动或拖动）
- ❌ 无法长时间运行后台任务
- ❌ 不适合展示大量动态数据或长文本
Widget 展示位置有哪些？
iOS 系统支持在多个位置展示 Widget，按系统版本差异分为：
- 主屏幕（Home Screen）：iOS 14 起支持添加小组件到主屏幕
- 锁屏（Lock Screen Widgets）：iOS 16 起支持
- 待机模式（StandBy Widgets）：iOS 17 起支持横屏待机展示
- 控制中心（Control Widgets) ：iOS 18 起支持的控制展示 ✅
开发 Widget 需要准备什么？
开发 Widget 的前提：
- 使用 Xcode 12+（推荐最新）
- 开启 Widget Extension，与主 App 同属一个 App Group（用于共享数据）
- 项目需支持 iOS 14+，推荐 iOS 16 或 17 起步
- 熟悉 SwiftUI 开发语法与架构
常见误区
-
Widget 是实时的？
- ❌ 并非实时更新，只能定期刷新或 App 主动触发。
-
我能在 Widget 内请求 API？
- ❌ 不行，Widget 运行时无法发起网络请求，必须预加载数据。
-
我能放按钮/滚动视图吗？
- ❌ Widget 是非交互视图，无法接受用户输入或操作。
总结
Widget 是 iOS 提供给开发者向用户持续展示关键信息的高效方式，它强调轻量级、非交互、适配性强的视图呈现。尽管受限较多，但若能合理运用 App Group、SwiftUI 和 Timeline 机制，依旧可以实现极具吸引力和实用性的功能。
最后，希望能够帮助到有需要的朋友，如果觉得有帮助，还望点个赞，添加个关注，笔者也会不断地努力，写出更多更好用的文章。