Виджеты на iPhone: создание и настройка¶
Виджет на iPhone — это компактный элемент интерфейса iOS, отображающий обновляемую информацию прямо на экране «Домой» или в центре уведомлений. Виджеты создаются с использованием фреймворка WidgetKit (SwiftUI), доступного с iOS 14, и представляют собой целевые представления (views), которые система размещает на сетке экрана «Домой».
¶Платформа и инструменты
Для разработки виджетов используется Xcode — интегрированная среда разработки Apple, работающая только на macOS. Язык программирования — Swift, интерфейсы описываются декларативно на SwiftUI. Основные компоненты проекта:
- Widget Extension — отдельная цель приложения, содержащая код виджета.
- TimelineProvider — протокол, предоставляющий системе наборы данных (timeline entries) для отображения в разные моменты времени.
- Container App — основное приложение, которое пользователь устанавливает из App Store; виджет без него не публикуется.
¶Структура проекта
В Xcode создание виджета начинается с добавления цели Widget Extension через меню File → New → Target → Widget Extension. При этом автоматически генерируются файлы:
*Widget.swift— точка входа с макросом@mainи структурой, соответствующей протоколуWidgetBundleилиWidget.*Provider.swift— реализацияTimelineProviderс методамиgetSnapshotиgetTimeline.*EntryView.swift— SwiftUI-представление, отображающее данные конкретного момента времени.
¶Устройство виджета
¶TimelineProvider
Система запрашивает у провайдера набор записей (TimelineEntry), каждая из которых содержит дату и данные для отображения. Провайдер определяет, когда обновлять данные — например, раз в час или по событию. Минимальная реализация:
``swift struct Provider: TimelineProvider { func placeholder(in context: Context) -> SimpleEntry { SimpleEntry(date: Date(), text: "Загрузка") } func getSnapshot(in context: Context, completion: @escaping (SimpleEntry) -> Void) { completion(SimpleEntry(date: Date(), text: "Превью")) } func getTimeline(in context: Context, completion: @escaping (Timeline<SimpleEntry>) -> Void) { let entry = SimpleEntry(date: Date(), text: "Привет") let timeline = Timeline(entries: [entry], policy: .atEnd) completion(timeline) } } ``
¶Конфигурация
Виджет описывается структурой, реализующей протокол Widget. Параметр kind — уникальный идентификатор, supportedFamilies — поддерживаемые размеры (.systemSmall, .systemMedium, .systemLarge, .systemExtraLarge для iPad). Внутри используется StaticConfiguration или AppIntentConfiguration (для виджетов с интерактивными элементами, доступными с iOS 17).
¶Размеры и семейства
| Семейство | Ориентировочные размеры | Типичное содержимое |
|---|---|---|
| systemSmall | 2×2 клетки | Иконка, одно значение, короткий статус |
| systemMedium | 4×2 клетки | Список из 2–3 пунктов, график |
| systemLarge | 4×4 клетки | Полный список, расширенная информация |
¶Данные и обновления
WidgetKit не позволяет виджету работать в фоне постоянно. Обновления происходят по расписанию, которое система определяет на основе истории использования. Разработчик может инициировать обновление через WidgetCenter.shared.reloadTimelines(ofKind:). Доступ к данным ограничен: прямое обращение к сети из виджета не рекомендуется, обычно данные кэшируются в App Group-контейнере общем для приложения и расширения.
¶Интерактивные виджеты
С iOS 17 появилась возможность добавлять в виджеты кнопки, переключатели и поля ввода, работающие через AppIntent. Это позволяет, например, отмечать задачу выполненной прямо с экрана «Домой» без открытия приложения.
¶Публикация
Виджет публикуется вместе с основным приложением в App Store. Отдельной загрузки из магазина виджеты не имеют: пользователь добавляет их на экран «Домой» долгим нажатием → кнопка «+» → выбор приложения. Ограничения Apple включают обязательное наличие основного приложения, запрет на монетизацию виджета отдельно и требования к обновлению данных не чаще, чем позволяет энергопотребление устройства.
¶История
Виджеты появились в iOS 14 (2020) как ответ на долгожданную функцию, реализованную ранее на Android. В iOS 15 добавлена поддержка Live Activities и обновлённые семейства размеров, в iOS 16 — персонализация экрана блокировки с виджетами, в iOS 17 — интерактивные элементы и виджет StandBy для зарядных станций.
