Обзор виджетов приложения

Виджеты — важная составляющая персонализации главного экрана. Их можно рассматривать как краткий обзор наиболее важных данных и функций приложения, доступный прямо на главном экране пользователя. Пользователи могут перемещать виджеты по панелям главного экрана и, если это поддерживается, изменять их размер, чтобы настроить объем информации в виджете в соответствии со своими предпочтениями.

В этой документации описаны различные типы виджетов, которые можно создавать, и принципы проектирования, которым следует следовать. Чтобы создать виджет приложения с использованием API удаленного просмотра и XML-макетов, см. раздел «Создание базового виджета» . Чтобы создать виджет с использованием API в стиле Kotlin и Compose, см. раздел «Jetpack Glance» .

Типы виджетов

При планировании виджета подумайте, какой именно виджет вы хотите создать. Виджеты обычно делятся на следующие категории:

Информационные виджеты

Информационные виджеты обычно отображают важные информационные элементы и отслеживают, как эта информация изменяется с течением времени. Примерами информационных виджетов являются виджеты погоды, виджеты часов или виджеты отслеживания спортивных результатов. Нажатие на информационный виджет обычно запускает соответствующее приложение и открывает подробное представление информации, содержащейся в виджете.

Виджеты коллекций

Виджеты-коллекции специализируются на отображении нескольких элементов одного типа, например, коллекции изображений из приложения-галереи, коллекции статей из новостного приложения или коллекции электронных писем или сообщений из приложения для общения. Виджеты-коллекции могут прокручиваться вертикально.

Виджеты для создания коллекций обычно ориентированы на следующие сценарии использования:

• Просматриваем коллекцию.
• Открытие элемента коллекции в режиме подробного просмотра в соответствующем приложении.
• Взаимодействие с элементами, например, пометка их как выполненных, с поддержкой составных кнопок в Android 12 (уровень API 31).

Управляйте виджетами

Основная цель виджета управления — отображение часто используемых функций, чтобы пользователь мог активировать их с главного экрана, не открывая приложение. Можно рассматривать их как пульты дистанционного управления для приложения. Примером виджета управления может служить виджет управления домом, позволяющий пользователям включать и выключать свет в доме.

Взаимодействие с виджетом управления может открыть связанное с ним подробное представление в приложении. Это зависит от того, выводит ли функция виджета управления какие-либо данные, например, в случае виджета поиска.

Гибридные виджеты

Хотя некоторые виджеты относятся к одному из типов, описанных в предыдущих разделах — информационные, коллекционные или управляющие — многие виджеты являются гибридными, сочетающими в себе элементы разных типов. Например, виджет музыкального проигрывателя в первую очередь является управляющим виджетом, но он также показывает пользователю, какой трек воспроизводится в данный момент, подобно информационному виджету.

При планировании виджета, отталкивайтесь от одного из базовых типов и добавляйте элементы других типов по мере необходимости.

Интегрируйте виджеты с Google Ассистентом.

Google Ассистент может отображать любые виджеты в ответ на голосовые команды пользователя. Вы можете настроить свои виджеты для выполнения действий приложения , что позволит пользователям получать быстрые ответы и интерактивные возможности приложения на платформах Ассистента, таких как Android и Android Auto . Более подробную информацию о выполнении действий приложения для Ассистента см. в разделе «Интеграция действий приложения с виджетами Android» .

Ограничения виджетов

Хотя виджеты можно рассматривать как «мини-приложения», перед их разработкой важно понимать определенные ограничения.

Жесты

Поскольку виджеты размещаются на главном экране, они должны сосуществовать с навигацией, которая там установлена. Это ограничивает поддержку жестов в виджетах по сравнению с полноэкранными приложениями. Хотя приложения могут позволять пользователям перемещаться между экранами по горизонтали, этот жест уже выполняется на главном экране для навигации между ними.

Для виджетов доступны только жесты касания и вертикального свайпа .

Элементы

В связи с ограничениями на доступные для виджетов жесты, некоторые элементы пользовательского интерфейса, использующие ограниченные жесты, недоступны для виджетов. Полный список поддерживаемых элементов и дополнительную информацию об ограничениях компоновки см. в разделах «Создание компоновки виджета» и «Предоставление гибких компоновок виджетов» .

Рекомендации по проектированию

Следуйте этим рекомендациям по дизайну, чтобы создать привлекательный, гибкий и единообразный виджет на главном экране.

Содержимое виджета

Виджеты — отличный способ привлечь пользователя в ваше приложение, «рекламируя» новый и интересный контент, доступный в вашем приложении.

Подобно рекламным заметкам на первой полосе газеты, виджеты объединяют и концентрируют информацию приложения, обеспечивая связь с более подробной информацией внутри приложения. Можно сказать, что виджет — это информационный «перекус», а приложение — это «основное блюдо». Убедитесь, что ваше приложение отображает больше подробностей об информационном элементе, чем то, что показывает виджет.

Навигация по виджетам

Помимо чисто информационного контента, рассмотрите возможность добавления в виджет навигационных ссылок на часто используемые разделы вашего приложения. Это позволит пользователям быстрее выполнять задачи и расширит функциональные возможности приложения до главного экрана.

В качестве навигационных ссылок в виджетах хорошо подойдут следующие кандидаты:

• Генеративные функции: это функции, которые позволяют пользователю создавать новый контент для приложения, например, создавать новый документ или новое сообщение.

• Откройте приложение на верхнем уровне: нажатие на информационный элемент обычно переводит пользователя на более низкий уровень подробной информации. Предоставление доступа к верхнему уровню вашего приложения обеспечивает большую гибкость навигации и может заменить специальный ярлык приложения, который пользователи обычно используют для перехода к приложению с главного экрана. Использование значка вашего приложения для этой функции также может обеспечить вашему виджету понятную идентификацию, если отображаемые данные неоднозначны.

Изменение размера виджета

При касании и удержании виджета с изменяемым размером, а затем отпускании, виджет переходит в режим изменения размера. Пользователи могут использовать маркеры перетаскивания или углы виджета для установки желаемого размера.

Изменение размера позволяет пользователям регулировать высоту и ширину виджета в пределах сетки размещения на главном экране. Вы можете решить, будет ли ваш виджет свободно изменяться в размерах или его размер будет ограничен только горизонтальным или вертикальным изменением. Поддержка изменения размера не обязательна, если ваш виджет по своей природе имеет фиксированный размер.

Предоставление пользователям возможности изменять размер виджетов имеет важные преимущества:

• Они могут точно настроить объем информации, отображаемой на каждом виджете.
• Они могут более эффективно влиять на расположение виджетов и ярлыков на главном экране.

Разработайте стратегию изменения размера виджета в зависимости от его типа. Виджеты, представляющие собой списки или сетки, обычно просты в использовании, поскольку изменение размера виджета расширяет или сужает область вертикальной прокрутки. Независимо от размера виджета, пользователь по-прежнему сможет прокрутить все информационные элементы, чтобы они отобразились.

Для информационных виджетов требуется более тщательное планирование, поскольку они не прокручиваются, и весь контент должен помещаться в заданный размер. Необходимо динамически подстраивать содержимое и макет виджета под размер, заданный пользователем при изменении размера.

В приведенном ниже примере пользователь может изменять размер виджета погоды в три этапа, отображая более подробную информацию о погоде в текущем местоположении по мере увеличения размера виджета.

Для каждого размера виджета определите, какой объем информации вашего приложения отображается. Для меньших размеров сосредоточьтесь на основной информации, а затем добавляйте контекстную информацию по мере роста виджета по горизонтали и вертикали.

Вопросы компоновки

Заманчиво располагать виджеты в соответствии с размерами сетки размещения устройства, на котором вы разрабатываете. Это может быть полезным первоначальным приближением, но помните о следующих моментах:

• Планирование стратегии изменения размера виджетов по "диапазонам размеров", а не по переменным размерам сетки, обеспечивает наиболее надежные результаты.
• Количество, размер и расстояние между ячейками могут сильно различаться от устройства к устройству. Поэтому очень важно, чтобы ваш виджет был гибким и мог занимать больше или меньше места, чем предполагалось.
• Когда пользователь изменяет размер виджета, система выдает диапазон размеров в dp, в пределах которого виджет может перерисоваться.
• Начиная с Android 12, вы можете задавать более точные атрибуты размера и более гибкие макеты. Это включает в себя:
  • Указание ограничений на размер виджета . Например, вы можете указать целевой размер для вашего виджета — в ячейках сетки — а также максимально возможный размер.
  • Предоставление адаптивных макетов , которые изменяются в зависимости от размера виджета.
  • Предоставляются макеты точных размеров , позволяющие лаунчеру адаптироваться к портретному и альбомному режимам для телефонов, а также предлагать четыре размера для складных устройств.
  • Используйте обновленные рекомендации и новые API для определения правильных размеров вашего виджета.

Настройка виджета пользователями

Иногда пользователю необходимо настроить виджет, прежде чем он станет полезным. Например, виджет электронной почты, где пользователю нужно выбрать папку для писем, прежде чем отобразится папка «Входящие», или статический виджет фотографий, где пользователю нужно выбрать изображение из галереи для отображения. Виджеты Android отображают параметры конфигурации сразу после того, как пользователь перетаскивает виджет на главный экран.

Контрольный список для разработки виджетов

• Сосредоточьтесь на небольших фрагментах быстрой информации в вашем виджете. Расширьте информацию в вашем приложении.
• Выберите подходящий тип виджета для ваших целей.
• Продумайте, как содержимое вашего виджета будет адаптироваться к разным размерам.
• Сделайте расположение виджетов независимым от ориентации экрана и устройства, обеспечив возможность растягивания и сжатия макета.
• Подумайте, не требуется ли вашему виджету дополнительная настройка.

,

Виджеты — важная составляющая персонализации главного экрана. Их можно рассматривать как краткий обзор наиболее важных данных и функций приложения, доступный прямо на главном экране пользователя. Пользователи могут перемещать виджеты по панелям главного экрана и, если это поддерживается, изменять их размер, чтобы настроить объем информации в виджете в соответствии со своими предпочтениями.

В этой документации описаны различные типы виджетов, которые можно создавать, и принципы проектирования, которым следует следовать. Чтобы создать виджет приложения с использованием API удаленного просмотра и XML-макетов, см. раздел «Создание базового виджета» . Чтобы создать виджет с использованием API в стиле Kotlin и Compose, см. раздел «Jetpack Glance» .

Типы виджетов

При планировании виджета подумайте, какой именно виджет вы хотите создать. Виджеты обычно делятся на следующие категории:

Информационные виджеты

Информационные виджеты обычно отображают важные информационные элементы и отслеживают, как эта информация изменяется с течением времени. Примерами информационных виджетов являются виджеты погоды, виджеты часов или виджеты отслеживания спортивных результатов. Нажатие на информационный виджет обычно запускает соответствующее приложение и открывает подробное представление информации, содержащейся в виджете.

Виджеты коллекций

Виджеты-коллекции специализируются на отображении нескольких элементов одного типа, например, коллекции изображений из приложения-галереи, коллекции статей из новостного приложения или коллекции электронных писем или сообщений из приложения для общения. Виджеты-коллекции могут прокручиваться вертикально.

Виджеты для создания коллекций обычно ориентированы на следующие сценарии использования:

• Просматриваем коллекцию.
• Открытие элемента коллекции в режиме подробного просмотра в соответствующем приложении.
• Взаимодействие с элементами, например, пометка их как выполненных, с поддержкой составных кнопок в Android 12 (уровень API 31).

Управляйте виджетами

Основная цель виджета управления — отображение часто используемых функций, чтобы пользователь мог активировать их с главного экрана, не открывая приложение. Можно рассматривать их как пульты дистанционного управления для приложения. Примером виджета управления может служить виджет управления домом, позволяющий пользователям включать и выключать свет в доме.

Взаимодействие с виджетом управления может открыть связанное с ним подробное представление в приложении. Это зависит от того, выводит ли функция виджета управления какие-либо данные, например, в случае виджета поиска.

Гибридные виджеты

Хотя некоторые виджеты относятся к одному из типов, описанных в предыдущих разделах — информационные, коллекционные или управляющие — многие виджеты являются гибридными, сочетающими в себе элементы разных типов. Например, виджет музыкального проигрывателя в первую очередь является управляющим виджетом, но он также показывает пользователю, какой трек воспроизводится в данный момент, подобно информационному виджету.

При планировании виджета, отталкивайтесь от одного из базовых типов и добавляйте элементы других типов по мере необходимости.

Интегрируйте виджеты с Google Ассистентом.

Google Ассистент может отображать любые виджеты в ответ на голосовые команды пользователя. Вы можете настроить свои виджеты для выполнения действий приложения , что позволит пользователям получать быстрые ответы и интерактивные возможности приложения на платформах Ассистента, таких как Android и Android Auto . Более подробную информацию о выполнении действий приложения для Ассистента см. в разделе «Интеграция действий приложения с виджетами Android» .

Ограничения виджетов

Хотя виджеты можно рассматривать как «мини-приложения», перед их разработкой важно понимать определенные ограничения.

Жесты

Поскольку виджеты размещаются на главном экране, они должны сосуществовать с навигацией, которая там установлена. Это ограничивает поддержку жестов в виджетах по сравнению с полноэкранными приложениями. Хотя приложения могут позволять пользователям перемещаться между экранами по горизонтали, этот жест уже выполняется на главном экране для навигации между ними.

Для виджетов доступны только жесты касания и вертикального свайпа .

Элементы

В связи с ограничениями на доступные для виджетов жесты, некоторые элементы пользовательского интерфейса, использующие ограниченные жесты, недоступны для виджетов. Полный список поддерживаемых элементов и дополнительную информацию об ограничениях компоновки см. в разделах «Создание компоновки виджета» и «Предоставление гибких компоновок виджетов» .

Рекомендации по проектированию

Следуйте этим рекомендациям по дизайну, чтобы создать привлекательный, гибкий и единообразный виджет на главном экране.

Содержимое виджета

Виджеты — отличный способ привлечь пользователя в ваше приложение, «рекламируя» новый и интересный контент, доступный в вашем приложении.

Подобно рекламным заметкам на первой полосе газеты, виджеты объединяют и концентрируют информацию приложения, обеспечивая связь с более подробной информацией внутри приложения. Можно сказать, что виджет — это информационный «перекус», а приложение — это «основное блюдо». Убедитесь, что ваше приложение отображает больше подробностей об информационном элементе, чем то, что показывает виджет.

Навигация по виджетам

Помимо чисто информационного контента, рассмотрите возможность добавления в виджет навигационных ссылок на часто используемые разделы вашего приложения. Это позволит пользователям быстрее выполнять задачи и расширит функциональные возможности приложения до главного экрана.

В качестве навигационных ссылок в виджетах хорошо подойдут следующие кандидаты:

• Генеративные функции: это функции, которые позволяют пользователю создавать новый контент для приложения, например, создавать новый документ или новое сообщение.

• Откройте приложение на верхнем уровне: нажатие на информационный элемент обычно переводит пользователя на более низкий уровень подробной информации. Предоставление доступа к верхнему уровню вашего приложения обеспечивает большую гибкость навигации и может заменить специальный ярлык приложения, который пользователи обычно используют для перехода к приложению с главного экрана. Использование значка вашего приложения для этой функции также может обеспечить вашему виджету понятную идентификацию, если отображаемые данные неоднозначны.

Изменение размера виджета

При касании и удержании виджета с изменяемым размером, а затем отпускании, виджет переходит в режим изменения размера. Пользователи могут использовать маркеры перетаскивания или углы виджета для установки желаемого размера.

Изменение размера позволяет пользователям регулировать высоту и ширину виджета в пределах сетки размещения на главном экране. Вы можете решить, будет ли ваш виджет свободно изменяться в размерах или его размер будет ограничен только горизонтальным или вертикальным изменением. Поддержка изменения размера не обязательна, если ваш виджет по своей природе имеет фиксированный размер.

Предоставление пользователям возможности изменять размер виджетов имеет важные преимущества:

• Они могут точно настроить объем информации, отображаемой на каждом виджете.
• Они могут более эффективно влиять на расположение виджетов и ярлыков на главном экране.

Разработайте стратегию изменения размера виджета в зависимости от его типа. Виджеты, представляющие собой списки или сетки, обычно просты в использовании, поскольку изменение размера виджета расширяет или сужает область вертикальной прокрутки. Независимо от размера виджета, пользователь по-прежнему сможет прокрутить все информационные элементы, чтобы они отобразились.

Для информационных виджетов требуется более тщательное планирование, поскольку они не прокручиваются, и весь контент должен помещаться в заданный размер. Необходимо динамически подстраивать содержимое и макет виджета под размер, заданный пользователем при изменении размера.

В приведенном ниже примере пользователь может изменять размер виджета погоды в три этапа, отображая более подробную информацию о погоде в текущем местоположении по мере увеличения размера виджета.

Для каждого размера виджета определите, какой объем информации вашего приложения отображается. Для меньших размеров сосредоточьтесь на основной информации, а затем добавляйте контекстную информацию по мере роста виджета по горизонтали и вертикали.

Вопросы компоновки

Заманчиво располагать виджеты в соответствии с размерами сетки размещения устройства, на котором вы разрабатываете. Это может быть полезным первоначальным приближением, но помните о следующих моментах:

• Планирование стратегии изменения размера виджетов по "диапазонам размеров", а не по переменным размерам сетки, обеспечивает наиболее надежные результаты.
• Количество, размер и расстояние между ячейками могут сильно различаться от устройства к устройству. Поэтому очень важно, чтобы ваш виджет был гибким и мог занимать больше или меньше места, чем предполагалось.
• Когда пользователь изменяет размер виджета, система выдает диапазон размеров в dp, в пределах которого виджет может перерисоваться.
• Начиная с Android 12, вы можете задавать более точные атрибуты размера и более гибкие макеты. Это включает в себя:
  • Указание ограничений на размер виджета . Например, вы можете указать целевой размер для вашего виджета — в ячейках сетки — а также максимально возможный размер.
  • Предоставление адаптивных макетов , которые изменяются в зависимости от размера виджета.
  • Предоставляются макеты точных размеров , позволяющие лаунчеру адаптироваться к портретному и альбомному режимам для телефонов, а также предлагать четыре размера для складных устройств.
  • Используйте обновленные рекомендации и новые API для определения правильных размеров вашего виджета.

Настройка виджета пользователями

Иногда пользователю необходимо настроить виджет, прежде чем он станет полезным. Например, виджет электронной почты, где пользователю нужно выбрать папку для писем, прежде чем отобразится папка «Входящие», или статический виджет фотографий, где пользователю нужно выбрать изображение из галереи для отображения. Виджеты Android отображают параметры конфигурации сразу после того, как пользователь перетаскивает виджет на главный экран.

Контрольный список для разработки виджетов

• Сосредоточьтесь на небольших фрагментах быстрой информации в вашем виджете. Расширьте информацию в вашем приложении.
• Выберите подходящий тип виджета для ваших целей.
• Продумайте, как содержимое вашего виджета будет адаптироваться к разным размерам.
• Сделайте расположение виджетов независимым от ориентации экрана и устройства, обеспечив возможность растягивания и сжатия макета.
• Подумайте, не требуется ли вашему виджету дополнительная настройка.

,

Виджеты — важная составляющая персонализации главного экрана. Их можно рассматривать как краткий обзор наиболее важных данных и функций приложения, доступный прямо на главном экране пользователя. Пользователи могут перемещать виджеты по панелям главного экрана и, если это поддерживается, изменять их размер, чтобы настроить объем информации в виджете в соответствии со своими предпочтениями.

В этой документации описаны различные типы виджетов, которые можно создавать, и принципы проектирования, которым следует следовать. Чтобы создать виджет приложения с использованием API удаленного просмотра и XML-макетов, см. раздел «Создание базового виджета» . Чтобы создать виджет с использованием API в стиле Kotlin и Compose, см. раздел «Jetpack Glance» .

Типы виджетов

При планировании виджета подумайте, какой именно виджет вы хотите создать. Виджеты обычно делятся на следующие категории:

Информационные виджеты

Информационные виджеты обычно отображают важные информационные элементы и отслеживают, как эта информация изменяется с течением времени. Примерами информационных виджетов являются виджеты погоды, виджеты часов или виджеты отслеживания спортивных результатов. Нажатие на информационный виджет обычно запускает соответствующее приложение и открывает подробное представление информации, содержащейся в виджете.

Виджеты коллекций

Виджеты-коллекции специализируются на отображении нескольких элементов одного типа, например, коллекции изображений из приложения-галереи, коллекции статей из новостного приложения или коллекции электронных писем или сообщений из приложения для общения. Виджеты-коллекции могут прокручиваться вертикально.

Виджеты для создания коллекций обычно ориентированы на следующие сценарии использования:

• Просматриваем коллекцию.
• Открытие элемента коллекции в режиме подробного просмотра в соответствующем приложении.
• Взаимодействие с элементами, например, пометка их как выполненных, с поддержкой составных кнопок в Android 12 (уровень API 31).

Управляйте виджетами

Основная цель виджета управления — отображение часто используемых функций, чтобы пользователь мог активировать их с главного экрана, не открывая приложение. Можно рассматривать их как пульты дистанционного управления для приложения. Примером виджета управления может служить виджет управления домом, позволяющий пользователям включать и выключать свет в доме.

Взаимодействие с виджетом управления может открыть связанное с ним подробное представление в приложении. Это зависит от того, выводит ли функция виджета управления какие-либо данные, например, в случае виджета поиска.

Гибридные виджеты

Хотя некоторые виджеты относятся к одному из типов, описанных в предыдущих разделах — информационные, коллекционные или управляющие — многие виджеты являются гибридными, сочетающими в себе элементы разных типов. Например, виджет музыкального проигрывателя в первую очередь является управляющим виджетом, но он также показывает пользователю, какой трек воспроизводится в данный момент, подобно информационному виджету.

При планировании виджета, отталкивайтесь от одного из базовых типов и добавляйте элементы других типов по мере необходимости.

Интегрируйте виджеты с Google Ассистентом.

Google Ассистент может отображать любые виджеты в ответ на голосовые команды пользователя. Вы можете настроить свои виджеты для выполнения действий приложения , что позволит пользователям получать быстрые ответы и интерактивные возможности приложения на платформах Ассистента, таких как Android и Android Auto . Более подробную информацию о выполнении действий приложения для Ассистента см. в разделе «Интеграция действий приложения с виджетами Android» .

Ограничения виджетов

Хотя виджеты можно рассматривать как «мини-приложения», перед их разработкой важно понимать определенные ограничения.

Жесты

Поскольку виджеты размещаются на главном экране, они должны сосуществовать с навигацией, которая там установлена. Это ограничивает поддержку жестов в виджетах по сравнению с полноэкранными приложениями. Хотя приложения могут позволять пользователям перемещаться между экранами по горизонтали, этот жест уже выполняется на главном экране для навигации между ними.

Для виджетов доступны только жесты касания и вертикального свайпа .

Элементы

В связи с ограничениями на доступные для виджетов жесты, некоторые элементы пользовательского интерфейса, использующие ограниченные жесты, недоступны для виджетов. Полный список поддерживаемых элементов и дополнительную информацию об ограничениях компоновки см. в разделах «Создание компоновки виджета» и «Предоставление гибких компоновок виджетов» .

Рекомендации по проектированию

Следуйте этим рекомендациям по дизайну, чтобы создать привлекательный, гибкий и единообразный виджет на главном экране.

Содержимое виджета

Виджеты — отличный способ привлечь пользователя в ваше приложение, «рекламируя» новый и интересный контент, доступный в вашем приложении.

Подобно рекламным заметкам на первой полосе газеты, виджеты объединяют и концентрируют информацию приложения, обеспечивая связь с более подробной информацией внутри приложения. Можно сказать, что виджет — это информационный «перекус», а приложение — это «основное блюдо». Убедитесь, что ваше приложение отображает больше подробностей об информационном элементе, чем то, что показывает виджет.

Навигация по виджетам

Помимо чисто информационного контента, рассмотрите возможность добавления в виджет навигационных ссылок на часто используемые разделы вашего приложения. Это позволит пользователям быстрее выполнять задачи и расширит функциональные возможности приложения до главного экрана.

В качестве навигационных ссылок в виджетах хорошо подойдут следующие кандидаты:

• Генеративные функции: это функции, которые позволяют пользователю создавать новый контент для приложения, например, создавать новый документ или новое сообщение.

• Откройте приложение на верхнем уровне: нажатие на информационный элемент обычно переводит пользователя на более низкий уровень подробной информации. Предоставление доступа к верхнему уровню вашего приложения обеспечивает большую гибкость навигации и может заменить специальный ярлык приложения, который пользователи обычно используют для перехода к приложению с главного экрана. Использование значка вашего приложения для этой функции также может обеспечить вашему виджету понятную идентификацию, если отображаемые данные неоднозначны.

Изменение размера виджета

При касании и удержании виджета с изменяемым размером, а затем отпускании, виджет переходит в режим изменения размера. Пользователи могут использовать маркеры перетаскивания или углы виджета для установки желаемого размера.

Изменение размера позволяет пользователям регулировать высоту и ширину виджета в пределах сетки размещения на главном экране. Вы можете решить, будет ли ваш виджет свободно изменяться в размерах или его размер будет ограничен только горизонтальным или вертикальным изменением. Поддержка изменения размера не обязательна, если ваш виджет по своей природе имеет фиксированный размер.

Предоставление пользователям возможности изменять размер виджетов имеет важные преимущества:

• Они могут точно настроить объем информации, отображаемой на каждом виджете.
• Они могут более эффективно влиять на расположение виджетов и ярлыков на главном экране.

Разработайте стратегию изменения размера виджета в зависимости от его типа. Виджеты, представляющие собой списки или сетки, обычно просты в использовании, поскольку изменение размера виджета расширяет или сужает область вертикальной прокрутки. Независимо от размера виджета, пользователь по-прежнему сможет прокрутить все информационные элементы, чтобы они отобразились.

Для информационных виджетов требуется более тщательное планирование, поскольку они не прокручиваются, и весь контент должен помещаться в заданный размер. Необходимо динамически подстраивать содержимое и макет виджета под размер, заданный пользователем при изменении размера.

В приведенном ниже примере пользователь может изменять размер виджета погоды в три этапа, отображая более подробную информацию о погоде в текущем местоположении по мере увеличения размера виджета.

For each widget size, determine how much of your app's information is displayed. For smaller sizes, concentrate on essential information, and then add contextual information as the widget grows horizontally and vertically.

Layout considerations

It's tempting to lay out your widgets according to the dimensions of the placement grid of a device that you develop with. This can be a useful initial approximation, but keep the following points in mind:

• Planning your widget resizing strategy across "size buckets" rather than variable grid dimensions gives you the most reliable results.
• The number, size, and spacing of cells can vary widely from device to device. Hence, it is very important that your widget is flexible and can accommodate more or less space than anticipated.
• As the user resizes a widget, the system responds with a dp size range in which your widget can redraw itself.
• Starting in Android 12, you can provide more refined size attributes and more flexible layouts. This includes:
  • Specifying widget size constraints . For example, you can specify the target size for your widget—in grid cells—as well as the maximum possible size.
  • Providing responsive layouts , which change depending on the size of the widget.
  • Providing exact-size layouts , which let the launcher respond with size options for portrait and landscape mode, for phones, or with four sizes for foldables.
  • Using updated guidance and new APIs to determine proper sizes for your widget.

Widget configuration by users

Sometimes, the user needs to set up the widget before it can become useful. Think of an email widget where the user needs to select the mail folder before the inbox can be displayed or a static photo widget where the user has to assign a picture from the gallery to be displayed. Android widgets display their configuration choices right after the user drops the widget onto a home screen.

Контрольный список для разработки виджетов

• Focus on small portions of glanceable information on your widget. Expand on the information in your app.
• Choose the right widget type for your purpose.
• Plan how the content for your widget adapts to different sizes.
• Make your widget layout independent of orientation and device by making sure the layout can stretch and contract.
• Consider whether your widget needs any additional configuration.