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 del usuario fundamental para una app con un solo toque usando widgets o bien obtener 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 nivel de calidad mínimo y ofrecen una experiencia de usuario deficiente. Un widget se considera 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, utilizables y proporcionan una experiencia de calidad.Para que se consideren 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 destacadas personalizadas y que ayudan a los usuarios a crear pantallas principales ú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, ya que pueden tener formas personalizadas, siempre que los bordes de la forma toquen al menos 2 bordes de la cuadrícula.
Color	WC-3	El texto del widget y los botones de íconos no tienen suficientes proporciones de contraste de color para cumplir con los requisitos de accesibilidad.
Discovery	WD-4.2	El nombre del widget no está incluido en el diseño del widget.
Discovery	WD-4.3	El widget no tiene una imagen de vista previa.
Contenido	WT-3	El contenido del widget está constantemente desactualizado o es 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 dentro de 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 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 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 alcanzar 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 aún debe ofrecer valor y cumplir con los requisitos del objetivo táctil (48 x 48).
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 son intencionales y muestran el valor del widget o proporcionan una llamada 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 x 48 dp.

Qué no debes hacer

No hagas 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

No uses colores con un contraste de color insuficiente.

Figura 1: No crees un widget con una vista previa inexacta.

NIVEL 1

Requisitos de los widgets diferenciados

Estos widgets admiten personalizaciones premium de la pantalla principal y se recomendarán a los usuarios y se destacarán para 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 alcanzar los cuatro bordes de los límites de la cuadrícula. TODOS los widgets con formas personalizadas DEBEN alcanzar 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 alcanzar solo 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, 4 x 2.
	WL-3	El encabezado del widget se usa y se aplica de manera 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. La capacidad es limitada. 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 un contexto de dispositivo o app.
Color	WC-2	El widget admite paletas de temas claros y oscuros.
Discovery	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 de 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.