Открыть сервисСервис

Виджеты на 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).

Размеры и семейства

СемействоОриентировочные размерыТипичное содержимое
systemSmall2×2 клеткиИконка, одно значение, короткий статус
systemMedium4×2 клеткиСписок из 2–3 пунктов, график
systemLarge4×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 для зарядных станций.

Заметили ошибку или не согласны с информацией в статье? Напишите нам support@bfometr.ru