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 recibir 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:

Nivel 3: Baja calidad

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

Nivel 2: Estándar

Estos widgets son útiles, fáciles de usar y brindan una experiencia de calidad.Para que se considere estándar, el widget debe cumplir con todos los siguientes criterios de diseño, color, descubrimiento y contenido.

Nivel 1: Diferenciado

Estos son widgets ejemplares que ofrecen experiencias de héroe personalizadas y que ayudan a los usuarios a crear pantallas de inicio únicas y productivas.

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	El widget no llena los límites establecidos por la cuadrícula del selector cuando se suelta en la pantalla principal.
Diseño	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 y cuando los bordes de la forma toquen al menos 2 bordes de la cuadrícula.
Color	WC-3	Los botones de texto y de íconos del widget no tienen relaciones de contraste de color suficientes para cumplir con los requisitos de accesibilidad.
Descubrimiento	WD-4.2	El nombre del widget no se incluye en el diseño del widget.
Descubrimiento	WD-4.3	El widget no tiene una imagen de vista previa.
Contenido	WT-3	El contenido del widget es constantemente obsoleto o inoportuno.
	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.

NIVEL 2

Requisitos de los widgets estándar

Los widgets que cumplen con este estándar de calidad se consideran estándar, pero no se consideran widgets destacados que se mostrarán o recomendarán.

Categoría	ID	Descripción
Diseño	WL-1	El widget se alinea correctamente con otros elementos de la pantalla principal en el eje vertical u horizontal, y no ocupa espacio innecesario.
	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 pueden cambiar de tamaño, los widgets deben tener un tamaño mínimo y máximo adecuado.
	WL-4.1	Se debe establecer el tamaño máximo si cambiar el tamaño del widget solo agrega espacio en blanco.
	WL-4.2	El tamaño mínimo de tu widget debe seguir ofreciendo valor y cumplir con los requisitos del objetivo táctil (48 x 48).
Descubrimiento	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 son intencionales y muestran el valor del widget o proporcionan un llamado a la acción cuando el widget está instalado, pero el usuario aún no accedió.
Contenido	WT-2	El widget permite a los usuarios actualizar el contenido de forma manual si se espera que los datos se actualicen con más frecuencia que la IU.

Qué debes hacer

Proporciona objetivos táctiles de 48 × 48 dp.

Qué no debes hacer

Hacer que los objetivos táctiles sean demasiado pequeños

Qué debes hacer

Asegúrate de que haya suficiente contraste de color.

Qué no debes hacer

Usar colores con contraste insuficiente

Video 1: No crees un widget con una vista previa imprecisa.

NIVEL 1

Requisitos de widgets diferenciados

Estos widgets admiten personalizaciones premium de la pantalla principal y se recomendarán a los usuarios y se destacará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 correctamente con otros elementos de la pantalla principal en el eje vertical u horizontal, y no ocupa espacio innecesario.
	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 4 x 1 y contiene una barra de búsqueda, se permite que solo toque 2 bordes.
	WL-2	El widget se puede cambiar de tamaño a al menos uno de los siguientes tamaños: 2 x 2, 4 x 1 y 4 x 2.
	WL-3	El encabezado del widget se usa y aplica de forma coherente. Recomendamos usar un encabezado en los siguientes casos: El widget contiene contenido de desplazamiento. El contenido del encabezado proporciona 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. Los cupos son 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.
Color	WC-1	El widget admite temas de color basados en el contexto de un dispositivo o una app.
Color	WC-2	El widget admite paletas de modo claro y modo oscuro.
Descubrimiento	WD-1	La vista previa incluye contenido del usuario o aplica un tema del sistema.
	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.
	WS-4	El widget usa la configuración del sistema en lugar de un punto de entrada de configuración del widget personalizado.
	WS-5	El widget usa la transición de inicio del sistema cuando se ingresa o se sale de la app desde el widget.