rzaripov.kz

Создание виджета для 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-компонентам.