Widget: что это, виджеты на iOS WidgetKit и Android

Что такое Widget

Widget — это компактный элемент пользовательского интерфейса, размещаемый на домашнем экране мобильного устройства для отображения актуальной информации из приложения. В отличие от полноценного приложения, виджет не требует запуска — пользователь видит данные сразу после разблокировки экрана. Концепция пришла из десктопных ОС (macOS Dashboard, Windows Sidebar), а в мобильной среде Android ввёл поддержку виджетов с первого релиза (Android 1.5 Cupcake, 2009), тогда как Apple добавила их только в iOS 14.

Техническая реализация различается на платформах. Виджет iOS — отдельный target в Xcode, компилируемый как Widget Extension, работающий в собственном процессе. Виджет Android — BroadcastReceiver, расширяющий AppWidgetProvider, рендерящий макет через RemoteViews. Обе платформы накладывают строгие ограничения на производительность и память: система может удалить виджет при превышении лимитов. iOS ограничивает виджет 30–50 МБ и временем формирования timeline до 10 секунд. Android — интервал обновления не чаще 30 минут через updatePeriodMillis и принудительное завершение при зависании onUpdate.

Smart Stack на iOS и стопки на Android позволяют пользователю группировать несколько виджетов в один слот на home screen. Устройство автоматически переключает отображаемый виджет в зависимости от времени суток, местоположения или активности пользователя. Например, утром показывается календарь, днём — погода, вечером — заметки. Для разработчика это означает, что виджет должен корректно работать в составе стопки и не полагаться на постоянное отображение.

iOS WidgetKit: SwiftUI и TimelineProvider

WidgetKit — фреймворк Apple для создания виджетов на iOS 14+, iPadOS 14+ и macOS 11+. Виджеты пишутся на Swift с использованием SwiftUI и механизма TimelineProvider для обновления контента. Архитектура WidgetKit включает три компонента: TimelineProvider — источник данных, формирующий временную шкалу с записями; Widget Entry View — SwiftUI View, отображающая содержимое на основе записи; Widget Configuration — описание типа, размеров и семейств виджета.

WidgetKit сам управляет обновлением — разработчик не может принудительно обновить виджет чаще, чем позволяет система. Apple использует бюджет обновлений, распределяемый между всеми виджетами на устройстве. Минимальный интервал — 15–30 минут. Для критичных данных (например, статус доставки) используется push-to-refresh — отправка push-уведомления с релевантной датой в будущем, после которого WidgetKit запрашивает новый timeline. Начиная с iOS 17 виджеты поддерживают интерактивность через App Intents — пользователь может нажимать кнопки внутри виджета без открытия приложения.

Android AppWidgetProvider: RemoteViews

AppWidgetProvider — базовый класс для создания виджетов на Android, входящий в состав Android SDK с API level 3. Виджет Android — это BroadcastReceiver, получающий события обновления, включения и отключения от системы. В отличие от iOS, где виджет рисуется SwiftUI на собственном движке, Android использует RemoteViews — ограниченный набор компонентов View, рендерящихся в процессе системы (launcher). Нельзя использовать кастомные View, сложные анимации или UI-библиотеки.

Схема работы Android-виджета включает четыре этапа. Конфигурация — при добавлении виджета на экран система может запустить Activity конфигурации, где пользователь выбирает настройки. Обновление — система вызывает onUpdate() через заданный интервал (минимум 30 минут) или по сигналу из приложения через WorkManager. Рендеринг — провайдер создаёт RemoteViews с актуальными данными и передаёт их через AppWidgetManager. Обработка нажатий — виджет поддерживает PendingIntent для кнопок: при клике открывается Activity или выполняется действие. Начиная с Android 12 виджеты получили поддержку закруглённых углов, адаптивных цветов Material You и динамического изменения размера.

Создание виджета на iOS с WidgetKit

Создадим виджет погоды на Swift с использованием WidgetKit и SwiftUI. Проект должен содержать Widget Extension target, добавляемый в Xcode через File → New → Target → Widget Extension.

import WidgetKit
import SwiftUI

// 1. Модель данных для виджета
struct WeatherEntry: TimelineEntry {
    let date: Date
    let temperature: Int
    let condition: String
}

// 2. TimelineProvider — поставщик данных
struct Provider: TimelineProvider {
    func placeholder(in context: Context) -> WeatherEntry {
        WeatherEntry(date: Date(), temperature: 22, condition: "Солнечно")
    }

    func getSnapshot(in context: Context, completion: @escaping (WeatherEntry) -> Void) {
        let entry = WeatherEntry(date: Date(), temperature: 22, condition: "Солнечно")
        completion(entry)
    }

    func getTimeline(in context: Context, completion: @escaping (Timeline<WeatherEntry>) -> Void) {
        let now = Date()
        let entry = WeatherEntry(date: now, temperature: 20, condition: "Облачно")
        let nextUpdate = Calendar.current.date(byAdding: .hour, value: 3, to: now)!
        let timeline = Timeline(entries: [entry], policy: .after(nextUpdate))
        completion(timeline)
    }
}

// 3. SwiftUI View для отображения
struct WeatherWidgetEntryView: View {
    var entry: WeatherEntry

    var body: some View {
        VStack(alignment: .leading) {
            Text("Погода").font(.caption).foregroundColor(.secondary)
            HStack {
                Text("\(entry.temperature)°").font(.largeTitle).fontWeight(.bold)
                Spacer()
                Text(entry.condition).font(.body)
            }
        }.padding()
    }
}

// 4. Конфигурация виджета
@main
struct WeatherWidget: Widget {
    var body: some WidgetConfiguration {
        StaticConfiguration(kind: "WeatherWidget", provider: Provider()) { entry in
            WeatherWidgetEntryView(entry: entry)
        }
        .configurationDisplayName("Погода")
        .description("Показывает текущую температуру")
        .supportedFamilies([.systemSmall, .systemMedium])
    }
}

Ключевые моменты: TimelineProvider определяет, когда и какие данные показывать; getTimeline создаёт временную шкалу с политикой обновления .after(nextUpdate); StaticConfiguration связывает провайдера с View. Для динамических данных используется IntentConfiguration с пользовательскими параметрами.

Создание виджета на Android с AppWidgetProvider

Реализуем аналогичный виджет погоды на Kotlin с AppWidgetProvider и RemoteViews.

// WeatherWidgetProvider.kt
class WeatherWidgetProvider : AppWidgetProvider() {

    override fun onUpdate(
        context: Context,
        appWidgetManager: AppWidgetManager,
        appWidgetIds: IntArray
    ) {
        for (appWidgetId in appWidgetIds) {
            updateAppWidget(context, appWidgetManager, appWidgetId)
        }
    }

    override fun onAppWidgetOptionsChanged(
        context: Context,
        appWidgetManager: AppWidgetManager,
        appWidgetId: Int,
        newOptions: Bundle
    ) {
        updateAppWidget(context, appWidgetManager, appWidgetId)
    }

    companion object {
        fun updateAppWidget(
            context: Context,
            appWidgetManager: AppWidgetManager,
            appWidgetId: Int
        ) {
            val temperature = 20
            val condition = "Облачно"
            val views = RemoteViews(
                context.packageName, R.layout.widget_weather
            ).apply {
                setTextViewText(R.id.tv_temperature, "$temperature°")
                setTextViewText(R.id.tv_condition, condition)
                setOnClickPendingIntent(
                    R.id.widget_root, PendingIntent.getActivity(
                        context, 0,
                        Intent(context, MainActivity::class.java),
                        PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE
                    )
                )
            }
            appWidgetManager.updateAppWidget(appWidgetId, views)
        }
    }
}

// AndroidManifest — регистрация провайдера
<receiver android:name=".WeatherWidgetProvider" android:exported="true">
    <intent-filter>
        <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
    </intent-filter>
    <meta-data
        android:name="android.appwidget.provider"
        android:resource="@xml/widget_weather_info" />
</receiver>

Файл widget_weather_info.xml задаёт минимальные размеры, интервал и layout: minWidth 160dp, minHeight 80dp, updatePeriodMillis 3600000 (1 час). RemoteViews использует только поддерживаемые компоненты: LinearLayout, TextView, ImageView. Кастомные View и ConstraintLayout доступны с Android 5.0. GlanceLayout — экспериментальный Compose-подход для RemoteViews — появился в Android 15.