Создание виджета для Android на Kotlin
Виджет для Android позволяет вынести полезную информацию прямо на главный экран, не запуская приложение. Пользователь получает доступ к показателям, прогнозу, состоянию задач или быстрому управлению функциями из привычной среды лаунчера. Такой подход сокращает число переходов между приложениями и повышает частоту использования продукта.
В работе над мобильными проектами я рассматриваю виджет как небольшое независимое приложение с собственным интерфейсом, жизненным циклом и источником данных. Ниже описан путь от выбора технологии до публикации: подготовка проекта, XML-разметка, обновление содержимого, обработка действий, тестирование на разных устройствах.
Выбор технологии
Существует два основных подхода к реализации. Классический вариант основан на RemoteViews и XML-разметке, а современный использует библиотеку Glance, предоставляющую декларативный интерфейс на Kotlin. Выбор зависит от требуемой совместимости, сложности интерфейса и планируемой команды разработки.
| Критерий | XML и RemoteViews | Glance App Widgets |
|---|---|---|
| Описание интерфейса | XML-файлы и стандартные компоненты Android | Kotlin-модели и компонуемый интерфейс |
| Поддержка состояния | Управляется вручную | Более удобное управление состоянием |
| Сложность освоения | Знакомая модель Android | Требуется изучение Glance |
| Гибкость оформления | Ограничена поддерживаемыми компонентами | Выше для типовых интерфейсов |
| Обновление данных | Через AppWidgetManager |
Через Glance и менеджер виджетов |
Классический путь подходит для проектов, где важна широкая совместимость и предсказуемое поведение на устройствах разных производителей. Разметка остаётся привычной для Android-разработчика, а обновление содержимого выполняется через системный AppWidgetManager.
Glance уменьшает объём шаблонного кода и позволяет описывать содержимое средствами Kotlin. Его удобно применять для новых приложений с простым интерфейсом, регулярно меняющимися данными и актуальной целевой версией Android. При этом Glance также использует системную инфраструктуру доставки виджетов.
Подготовка проекта
Сначала создаётся обычный Android-модуль с поддержкой AppCompat и ViewBinding либо DataBinding. Для загрузки данных в фоне подключается WorkManager, а ресурсы виджета размещаются в отдельном пакете res/xml. Минимальная версия SDK выбирается с учётом аудитории приложения и используемых библиотек.
В AndroidManifest.xml добавляется receiver, зарегистрированный на действие android.appwidget.action.APPWIDGET_UPDATE. Через метаданные указывается XML-файл с параметрами виджета. Название класса дополняется полным пакетом, если он находится не в корне модуля.
Файл weather_widget_info.xml задаёт начальную разметку, минимальные размеры, категорию размещения, допустимые направления изменения ширины и период системного обновления. Значение updatePeriodMillis не гарантирует точного запуска: система ограничивает частоту, а производитель устройства может изменять расписание.
Разметка и ресурсы
Интерфейс RemoteViews поддерживает ограниченный набор компонентов. Для большинства виджетов достаточно LinearLayout, FrameLayout, TextView, ImageView и Button. Корневой элемент получает идентификатор, необходимый для обработки нажатия, а текстовым полям назначаются отдельные идентификаторы для обновления содержимого.
Размеры задаются в dp, а размер текста — в sp, чтобы он масштабировался вместе с системными настройками. Фон оформляется drawable-ресурсом с округлёнными углами, а цвета выносятся в палитру. Для тёмной темы подготавливается отдельный набор ресурсов или используются тематические атрибуты.
Каждому информационному элементу добавляется содержательное описание для служб доступности. Изображения должны иметь подходящие размеры и альтернативный текст. Preview-иллюстрация помогает пользователю выбрать виджет при добавлении, а на современных версиях Android для этого можно использовать отдельную preview-разметку.
Логика обновления данных
Основная точка входа наследуется от AppWidgetProvider. Метод onUpdate получает список установленных экземпляров, после чего для каждого создаётся объект RemoteViews и вызывается updateAppWidget. Тяжёлые операции выполнять внутри этого метода не следует.
class WeatherWidgetProvider : AppWidgetProvider() {
override fun onUpdate(
context: Context,
manager: AppWidgetManager,
widgetIds: IntArray
) {
widgetIds.forEach { widgetId ->
val views = RemoteViews(context.packageName, R.layout.widget_weather)
views.setTextViewText(R.id.widget_value, "23°C")
val pendingIntent = PendingIntent.getActivity(
context,
widgetId,
Intent(context, MainActivity::class.java),
PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE
)
views.setOnClickPendingIntent(R.id.widget_root, pendingIntent)
manager.updateAppWidget(widgetId, views)
}
}
}
Для регулярного получения сведений используется PeriodicWorkRequest. Worker загружает данные из сети, локальной базы или кэша, сохраняет результат и обновляет все доступные экземпляры виджета. Их идентификаторы можно получить через getAppWidgetIds для компонента WeatherWidgetProvider.
Обновления лучше разделять на независимые части: загрузку, сохранение и отрисовку. При временном отсутствии сети показывается последнее сохранённое значение, а при ошибке — короткое уведомление. Объект RemoteViews должен оставаться компактным, поскольку каждый вызов менеджера связан с межпроцессным взаимодействием Android.
Взаимодействие с пользователем
Нажатие на виджет запускает нужный экран приложения через PendingIntent. В примере код запроса совпадает с идентификатором экземпляра, что позволяет системе различать разные виджеты. Флаг FLAG_IMMUTABLE защищает намерение от внешнего изменения, а FLAG_UPDATE_CURRENT обновляет его компонент.
Если требуются отдельные действия, каждому элементу назначается собственная интерактивная область. Например, основная область открывает подробности, а небольшая кнопка запускает обновление данных. Переходы реализуются через deep link, чтобы пользователь сразу попадал на требуемый раздел.
Для настраиваемых виджетов в XML добавляется класс activity конфигурации. Система передаёт ему идентификатор созданного экземпляра, а после сохранения параметров activity возвращает этот идентификатор через результат. Такой сценарий подходит для выбора города, аккаунта, списка отслеживаемых показателей или частоты обновления.
Тестирование и публикация
Проверка начинается с добавления виджета через настройки лаунчера. Необходимо протестировать изменение размера, разные плотности экрана, ориентацию, тёмную тему, увеличенный шрифт и локализацию. Особое внимание уделяется поведению на Pixel, Samsung и других устройствах, поскольку лаунчеры используют собственные правила размещения.
Отдельно проверяется отсутствие экземпляров, повторное добавление, удаление и обновление после перезапуска устройства. Полезно изучить сценарии с недоступной сетью, пустым ответом сервера и устаревшей локальной копией. Эти состояния должны быть понятны пользователю и не приводить к пустому или сломанному интерфейсу.
Перед публикацией выполняется сборка релизного варианта и проверка правил Google Play. Если виджет получает персональные данные или обращается к внешнему сервису, описание политики конфиденциальности и запрашиваемых разрешений дополняется соответствующими сведениями. Токены доступа и другие чувствительные значения нельзя выводить непосредственно на главный экран.
Опыт и архитектурный подход
В проектах на Delphi, FireMonkey, Kotlin и Swift я придерживаюсь разделения источника данных, бизнес-логики и представления. Для Android-виджета этот принцип особенно полезен: получение информации остаётся в worker, обработка данных — в общем доменном слое, а экран отвечает только за отображение и пользовательские действия.
Такой подход позволяет использовать одну модель данных в мобильном приложении, виджете и сопутствующих сервисах. Он упрощает тестирование, сокращает дублирование кода и делает обновление независимым от конкретного лаунчера. Опыт кроссплатформенной разработки помогает выбирать устойчивые архитектурные границы вместо привязки всей логики к Android-компонентам.