Cómo fijar widgets de De un vistazo en la app

Con Android 8.0 (nivel de API 26) y versiones posteriores, puedes permitir que los usuarios fijen tus widgets a la pantalla principal dentro de tu app. Promocionar widgets directamente en tu app es una excelente manera de aumentar la participación de los usuarios, especialmente después de que un usuario completa una tarea relacionada o cuando un usuario accede repetidamente a una función en tu app.

Cómo crear una solicitud de fijación

Para iniciar la fijación de widgets, usa el método requestPinGlanceAppWidget de la clase GlanceAppWidgetManager. Para las apps que se ejecutan en versiones anteriores de Android, se devuelve false. Sin embargo, si la solicitud se envía correctamente al sistema, se devuelve el valor verdadero.

A continuación, se muestra un ejemplo de cómo puedes crear una solicitud de PIN:

@Composable
fun AnInAppComposable() {
    val context = LocalContext.current
    val coroutineScope = rememberCoroutineScope()
    Button(
        onClick = {
            coroutineScope.launch {
                GlanceAppWidgetManager(context).requestPinGlanceAppWidget(
                    receiver = MyWidgetReceiver::class.java,
                    preview = MyWidget(),
                    previewState = DpSize(245.dp, 115.dp)
                )
            }
        }
    ) {}
}
GlancePinAppWidget.kt

En este ejemplo, MyWidgetReceiver es la clase que recibe las devoluciones de llamada del widget, y MyWidget es el widget de Glance que quieres fijar. El successCallback es un PendingIntent que se activa cuando el widget se fija correctamente.

Cómo controlar la respuesta a la solicitud de PIN

Cuando un usuario responde el diálogo de solicitud de PIN, tu app recibe una respuesta. Si el usuario acepta la solicitud, tu widget se fijará en su pantalla principal y se activará el successCallback PendingIntent. Si el usuario rechaza la solicitud, no sucede nada.

Es importante tener en cuenta que el objeto successCallback solo se activa si el widget se agrega correctamente a la pantalla principal. No se activa si el usuario rechaza la solicitud o si el selector no admite la fijación.