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 en 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, en especial después de que completan una tarea relacionada o cuando acceden de forma reiterada a una función de tu app.

Crea una solicitud de PIN

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

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

@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. successCallback es un PendingIntent que se activa cuando el widget se fija correctamente.

Controla la respuesta de la solicitud de fijación

Cuando un usuario responde al diálogo de solicitud de fijación, tu app recibe una respuesta. Si el usuario acepta la solicitud, el 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 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.