Descripción general de los widgets de apps

Los widgets son un aspecto esencial de la personalización de la pantalla principal. Son como vistas "resumidas" de los datos y las funciones más importantes de una app a los que se puede acceder directamente en la pantalla principal del usuario. Los usuarios pueden mover widgets en los paneles de la pantalla principal y, si la función es compatible, cambiarles el tamaño para adaptar la cantidad de información que se debe incluir en un widget según sus preferencias.

En esta documentación, se presentan los diferentes tipos de widgets que puedes crear y los principios de diseño que debes seguir. Para compilar un widget de app con las APIs de Remote View y los diseños XML, consulta Cómo crear un widget simple. Para compilar un widget con APIs de estilo Kotlin y Compose, consulta Jetpack Glance.

Tipos de widgets

Cuando planifiques tu widget, piensa en qué tipo de widget quieres compilar. Por lo general, los widgets pertenecen a una de las siguientes categorías:

Widgets informativos

Ejemplo de widget del clima que muestra que en Tokio está mayormente nublado, a 14 grados, y la temperatura proyectada desde las 4 p.m. hasta las 7 p.m.
Figura 1: Un widget de información de una app del clima.

Por lo general, los widgets de información muestran elementos de información cruciales y realizan un seguimiento de cómo esa información cambia con el tiempo. Algunos ejemplos de widgets de información son los widgets del clima, los widgets de reloj o los widgets de seguimiento de resultados deportivos. Por lo general, cuando se presiona un widget de información, se inicia la app asociada y se abre una vista detallada de la información del widget.

Widgets de colección

Los widgets de colección se especializan en mostrar varios elementos del mismo tipo, como una colección de imágenes de una app de galería, una colección de artículos de una app de noticias o una colección de correos electrónicos o mensajes de una app de comunicación. Los widgets de colección se pueden desplazar verticalmente.

Por lo general, los widgets de colecciones se enfocan en los siguientes casos de uso:

  • Explorando la colección.
  • Abrir un elemento de la colección en su vista de detalles en la app asociada
  • Interactuar con elementos, como marcarlos como completados, con compatibilidad con botones compuestos en Android 12 (nivel de API 31)

Widgets de control

Un widget de una app llamada “Lista de luces” que muestra interruptores de activación etiquetados como “Dormitorio”, “Cocina” y “Sala de estar”, con los dos primeros interruptores de activación apagados
Figura 4: Ejemplo de un widget de control.

El objetivo principal de un widget de control es mostrar las funciones de uso frecuente para que el usuario pueda activarlas desde la pantalla principal sin tener que abrir la app. Puedes pensar en ellos como controles remotos de una app. Un ejemplo de un widget de control es un widget de control de la casa que permite a los usuarios encender o apagar las luces de la casa.

La interacción con un widget de control puede abrir una vista de detalles asociada en la app. Esto depende de si la función del widget de control genera algún dato, como en el caso de un widget de búsqueda.

Widgets híbridos

Una app de música general que muestra botones para “me gusta”, atrás, reproducir/pausar, avanzar y “no me gusta”. El artista y la pista aparecen como "Artista" y "Música de ejemplo", respectivamente.
Figura 5: Ejemplo de un widget de app de música.

Si bien algunos widgets representan uno de los tipos de las secciones anteriores (información, colección o control), muchos son híbridos que combinan elementos de diferentes tipos. Por ejemplo, un widget de reproductor de música es, en esencia, un widget de control, pero también le muestra al usuario qué pista se está reproduciendo en el momento, como un widget de información.

Cuando planifiques tu widget, diseña en torno a uno de los tipos básicos y agrega elementos de otros tipos según sea necesario.

Integra widgets con Asistente de Google

Asistente de Google puede mostrar cualquier tipo de widget en respuesta a los comandos por voz del usuario. Puedes configurar tus widgets para entregar Acciones en apps, lo que les permite a los usuarios recibir respuestas rápidas y experiencias de app interactivas en plataformas de Asistente, como Android y Android Auto. Para obtener más detalles sobre la entrega de widgets para el Asistente, consulta Cómo integrar Acciones en apps con widgets de Android.

Limitaciones de los widgets

Si bien los widgets se pueden considerar "miniapps", existen ciertas limitaciones que es importante comprender antes de diseñarlos.

Gestos

Debido a que los widgets se ubican en la pantalla principal, tienen que coexistir con la navegación que se establece allí. Esto limita la compatibilidad con gestos que está disponible en un widget en comparación con una app de pantalla completa. Si bien las apps pueden permitir que los usuarios naveguen entre pantallas horizontalmente, ese gesto ya se realiza en la pantalla principal para navegar entre pantallas principales.

Los únicos gestos disponibles para widgets son tocar y deslizar verticalmente.

Elementos

Dadas las limitaciones de los gestos disponibles para los widgets, algunos componentes básicos de la IU que se basan en gestos restringidos no están disponibles para los widgets. Para obtener una lista completa de los bloques de compilación compatibles y más información sobre las restricciones de diseño, consulta Cómo crear el diseño del widget y Cómo proporcionar diseños de widgets flexibles.

Lineamientos de diseño

Contenido del widget

Los widgets son una excelente manera de atraer a un usuario a tu app, ya que "anuncian" contenido interesante y nuevo disponible en ella.

Al igual que los avances en la primera página de un periódico, los widgets consolidan y concentran la información de una app y proporcionan una conexión con más detalles dentro de la app. Podrías decir que el widget es el "bocadillo" de información, mientras que la app es la "comida". Asegúrate de que tu app muestre más detalles sobre un elemento de información que lo que muestra el widget.

Además del contenido puramente informativo, considera que tu widget proporcione vínculos de navegación a las áreas de uso frecuente de tu app. Esto permite a los usuarios completar tareas más rápido y extiende el alcance funcional de la app a la pantalla principal.

Estos son algunos buenos candidatos para crear vínculos de navegación en widgets:

  • Funciones generativas: Son las funciones que permiten al usuario crear contenido nuevo para una app, como crear un documento o mensaje nuevo.

  • Abre la app en el nivel superior: cuando el usuario presiona un elemento de información, se lo lleva a una pantalla de detalles de nivel inferior. Proporcionar acceso al nivel superior de tu aplicación ofrece más flexibilidad de navegación y puede reemplazar un acceso directo exclusivo a la app que los usuarios usarían para navegar a ella desde la pantalla principal. Si usas el ícono de tu app para esta funcionalidad, también puedes proporcionar una identidad clara a tu widget si los datos que estás mostrando son ambiguos.

Cambio del tamaño del widget

Widget estándar del Reloj de Google
Figura 6: Widget de Reloj de Google estándar

Si mantienes presionado un widget que se puede cambiar de tamaño y, luego, lo sueltas, este se pondrá en el modo de cambio de tamaño. Los usuarios pueden usar los controladores de arrastre o las esquinas de los widgets para establecer su tamaño preferido.

El cambio del tamaño permite a los usuarios ajustar la altura y el ancho de un widget según las restricciones de la cuadrícula de ubicación de la pantalla principal. Puedes decidir si tu widget puede cambiar de tamaño libremente o si está limitado a cambios de tamaño en forma horizontal o vertical. No es necesario admitir el cambio de tamaño si tu widget es de tamaño fijo.

Permitir a los usuarios cambiar el tamaño de los widgets tiene importantes beneficios:

  • Pueden ajustar la cantidad de información que desean ver en cada widget.
  • Pueden influir mejor en el diseño de los widgets y accesos directos en sus paneles principales.

Planifica una estrategia de cambio de tamaño para tu widget según el tipo de widget que estés creando. Los widgets de colección basados en listas o cuadrículas suelen ser sencillos, ya que el cambio de tamaño del widget expande o contrae el área de desplazamiento vertical. Sin importar el tamaño del widget, el usuario puede desplazar todos los elementos de información hasta la vista.

Los widgets informativos requieren más planificación práctica, ya que no se pueden desplazar y todo el contenido debe ajustarse a un tamaño determinado. Debes ajustar de forma dinámica el contenido y el diseño de tu widget según el tamaño que el usuario defina mediante la operación de cambio de tamaño.

En el siguiente ejemplo, el usuario puede cambiar el tamaño de un widget del clima en tres pasos, lo que expone información más detallada sobre el clima en la ubicación actual a medida que el widget crece.

Ejemplo de widget del clima en el tamaño más pequeño de cuadrícula de 3 × 2, en el que se muestra el nombre de la ubicación (Tokio), la temperatura (14°) y el símbolo que indica un clima parcialmente nublado
Figura 7: Ejemplo de widget del clima en una cuadrícula de 3 × 2 de tamaño "pequeño".


Ejemplo de widget del clima en un tamaño "mediano" de 5 × 2, que incluye toda la IU del tamaño de la cuadrícula de 3 × 2, además de la etiqueta "mayormente nublado" y las temperaturas pronosticadas de 4 p.m. a 7 p.m.
Figura 8: Ejemplo de widget del clima con un tamaño “mediano” de una cuadrícula de 5 × 2.


Ejemplo de widget del clima en un tamaño “grande” de 5 × 4, que incluye toda la IU de los tamaños de cuadrícula de 3 × 2 y 5 × 2, además de un pronóstico del clima de martes a viernes
Figura 9: Ejemplo de widget del clima en el tamaño "grande" de la cuadrícula de 5 × 4.

Para cada tamaño del widget, determina qué parte de la información de tu app se muestra. Para tamaños más pequeños, concéntrate en la información esencial y, luego, agrega información contextual a medida que el widget se expanda de forma horizontal y vertical.

Consideraciones de diseño

Puede ser tentador diseñar los widgets de acuerdo con las dimensiones de la cuadrícula de posiciones de un dispositivo con el que desarrollas apps. Esta puede ser una aproximación inicial útil, pero ten en cuenta los siguientes puntos:

  • Si planificas la estrategia de cambio de tamaño de tus widgets en "buckets de tamaño", en lugar de dimensiones de cuadrícula variables, obtendrás los resultados más confiables.
  • La cantidad, el tamaño y la separación de las celdas pueden variar mucho de un dispositivo a otro. Por lo tanto, es muy importante que tu widget sea flexible y pueda incorporar más espacio de lo previsto.
  • A medida que el usuario modifique el tamaño de un widget, el sistema responderá con un rango de tamaño en dp según el cual se podrá rediseñar el widget.
  • A partir de Android 12, puedes proporcionar atributos de tamaño más definidos y diseños más flexibles. Esto incluye lo siguiente:

Configuración de widgets por parte de los usuarios

A veces, el usuario debe configurar el widget para que pueda ser útil. Piensa en un widget de correo electrónico en el que el usuario debe seleccionar la carpeta de correo electrónico para que se pueda mostrar la bandeja de entrada, o un widget de fotos estático en el que el usuario debe asignar una foto de la galería para que se muestre. Los widgets de Android muestran las opciones de configuración justo después de que el usuario lo suelta en una pantalla principal.

Lista de tareas de diseño de widgets

  • Concéntrate en pequeñas porciones de información visible en el widget. Expande la información en tu aplicación.
  • Elige el tipo de widget adecuado para tu objetivo.
  • Planifica cómo se adapta el contenido de tu widget a diferentes tamaños.
  • Para lograr que el diseño del widget sea independiente de la orientación y del dispositivo, asegúrate de que el diseño se pueda estirar y contraer.
  • Considera si tu widget necesita alguna configuración adicional.