Calidad del widget

Los widgets son un componente fundamental para personalizar la pantalla principal de un usuario. A menudo, los usuarios pueden completar un recorrido crítico del usuario para una app con un solo toque usando widgets o ver un resumen rápido de las actualizaciones importantes. Los usuarios también pueden personalizar los widgets para adaptarlos a sus preferencias individuales.

Listas de tareas de compatibilidad con widgets

La calidad de los widgets afecta la participación de los usuarios con el contenido y las funciones de tu app. Las listas de tareas de compatibilidad definen criterios para ayudarte a evaluar la calidad de tu widget. Los niveles incluyen lo siguiente:

Ícono de baja calidad de nivel 3

NIVEL 3: Calidad baja

Estos widgets no cumplen con el estándar de calidad mínimo y ofrecen una experiencia del usuario deficiente. Se considera que un widget es de baja calidad si no cumple con los criterios estándar de diseño, color, descubrimiento y contenido.

Ícono de nivel 2 estándar

NIVEL 2: Estándar

Estos widgets son útiles, prácticos y proporcionan una experiencia de calidad.Para que se considere estándar, el widget debe cumplir con todos los criterios de diseño, color, descubrimiento y contenido que se indican a continuación.

Ícono de Nivel 1: Diferenciada

NIVEL 1: Diferenciado

Estos son widgets ejemplares que ofrecen experiencias destacadas personalizadas y que ayudan a los usuarios a crear pantallas principales únicas y productivas.


Ícono de baja calidad de nivel 3

NIVEL 3

Características de los widgets de baja calidad

Si tu widget se puede describir con cualquiera de las siguientes opciones, se considera de baja calidad:

Categoría ID Descripción
Diseño WL-1

Cuando un usuario coloca el widget en la superficie del host, el widget no llena los límites de la cuadrícula del host.

WL-1.1

El widget no toca al menos 2 bordes opuestos de la cuadrícula. En otras palabras, no es necesario que todos los widgets sean rectangulares, sino que pueden tener formas personalizadas, siempre que los bordes de la forma toquen al menos 2 bordes de la cuadrícula.

Color WC-3

Los botones de íconos y texto del widget no tienen suficientes proporciones de contraste de color para cumplir con los requisitos de accesibilidad.

Discovery WD-4.2

El nombre del widget no se incluye en su diseño.

WD-4.3

El widget no tiene una imagen de vista previa.

Contenido WT-3

El contenido del widget está desactualizado o no es oportuno.

WT-3.1

El widget no se actualiza después de que el usuario completa una acción desde el widget.

WT-3.2

El widget no se actualiza después de que el usuario completa una acción relacionada desde la app.

WT-4

La IU del widget no funciona o el contenido está recortado.

Ícono de nivel 2 estándar

NIVEL 2

Requisitos de los widgets estándar

Los widgets que cumplen con este nivel de calidad de referencia se consideran estándar, pero no se consideran widgets de presentación que se destacarán o recomendarán.

Categoría ID Descripción
Diseño WL-1

El widget se alinea con otros elementos del host en el eje vertical u horizontal y no ocupa espacio adicional.

WL-1.2

Todas las formas deben tocar al menos 2 bordes opuestos de los límites de la cuadrícula.

WL-4

Si se puede cambiar el tamaño de un widget, define un tamaño mínimo y máximo. Reorganiza el diseño para mostrar más contenido a medida que crece el widget. No escales el texto ni los íconos de forma lineal.

WL-4.1

Si un tamaño de widget más grande solo agrega espacio en blanco, establece un ancho o una altura máximos. Cuando un widget más grande muestra más contenido, como una lista de desplazamiento más alta, permite cambiar el tamaño sin restricciones.

WL-4.2

El tamaño mínimo del widget debe ser lo suficientemente grande como para mostrar un caso de uso claro y cumplir con el requisito de objetivo táctil de 48 x 48 dp. El sistema puede ajustar la escala de los objetivos táctiles para las pantallas de computadoras de escritorio o de automóviles.

Discovery WD-4

El widget debe tener vistas previas precisas en el selector de widgets (recurso estático).

Contenido WT-1

Los estados cero y vacío deben escalar a límites de widgets más grandes sin áreas dispersas. Cuando un usuario instala el widget antes de conectarse, este debe mostrar un caso de uso distinto o un llamado a la acción.

WT-2

El widget permite que los usuarios actualicen el contenido de forma manual si se espera que los datos se actualicen con más frecuencia que la IU.

Proporciona objetivos táctiles de 48 × 48 dp.
Crear objetivos táctiles demasiado pequeños
Asegúrate de que haya suficiente contraste de color.
Usar colores con un contraste insuficiente
Figura 1: No crees un widget con una vista previa imprecisa.

Ícono de Nivel 1: Diferenciada

NIVEL 1

Requisitos de widgets diferenciados

Estos widgets admiten personalizaciones premium de la pantalla principal y se recomendarán a los usuarios y se mostrarán a los desarrolladores como práctica recomendada. Los widgets diferenciados ofrecen experiencias destacadas y Android los aprovecha para inspirar y revitalizar el ecosistema. Cumplen con todos los criterios diferenciados de diseño, color, descubrimiento y contenido.

Categoría ID Descripción
Diseño WL-1

El widget se alinea con otros elementos del host en el eje vertical u horizontal y no ocupa espacio adicional.

WL-1.1

Todos los widgets rectangulares DEBEN tocar los cuatro bordes de los límites de la cuadrícula. Todos los widgets con formas personalizadas DEBEN tocar los 4 bordes de los límites de una cuadrícula cuadrada. Si el tamaño es de 4 x 1 y contiene una barra de búsqueda, se permite que toque solo 2 bordes.

WL-2

Los usuarios pueden cambiar el tamaño del widget a 2 × 1 y, al menos, a dos de estos tamaños: 1 × 1, 2 × 2, 4 × 2 y 4 × 4.

WL-3

El encabezado del widget se usa y se aplica de forma coherente.

  • Te recomendamos que uses un encabezado en los siguientes casos:
    • El widget contiene contenido que se desplaza.
    • El contenido del encabezado proporciona un contexto útil, como el nombre de una lista.
  • El uso de un encabezado es opcional en los siguientes casos:
    • El widget tiene sangrado completo, como un widget de fotos.
    • Tenemos cupos limitados.
    • Cuando el contenido del encabezado es redundante.
  • Si usas un encabezado, asegúrate de lo siguiente:
    • El ícono siempre está presente.
    • El título aparece cuando hay suficiente espacio
    • Las acciones se basan en el contexto del widget.
WL-5

Los widgets de colección y de feed admiten contenedores de desplazamiento vertical. En tamaños más grandes, como 4 × 2 y 4 × 4, estos widgets muestran más elementos y más detalles por elemento.

Color WC-1

El widget admite temas de color según el contexto del dispositivo o de la app.

WC-2

El widget admite paletas de temas claros y oscuros.

Discovery WD-1

La vista previa muestra las proporciones del diseño para el factor de forma de destino y, además, incluye contenido del usuario, aplica un tema del sistema o ambas opciones.

WD-4.4

El widget tiene una descripción que ayuda a los usuarios a comprender su valor.

WD-4.5

El nombre del widget es descriptivo y único en comparación con los otros widgets de la app.

Coherencia del sistema WS-2

Los widgets rectangulares deben usar el radio de esquina que proporciona el sistema (específico del OEM).

WS-3

El widget usa la especificación del estado de carga y muestra los errores directamente en la IU del widget.

WS-4

El widget usa la configuración del sistema en lugar de un punto de entrada de configuración de widget personalizado.

WS-5

El widget usa la transición de inicio del sistema cuando se ingresa a la app o se sale de ella desde el widget.

Haz que el widget se expanda a los 4 bordes de los límites de la cuadrícula.
Crea un tamaño personalizado que no complete los límites de la cuadrícula.
Proporciona un encabezado que cumpla con las especificaciones del widget.
Usa especificaciones personalizadas para el tamaño y los títulos.
Incluye una descripción breve y única.
Proporciona una descripción genérica.
Usa el radio de esquina del sistema.
Establece un radio de esquina personalizado.