تثبيت تطبيقات Glance المصغّرة داخل التطبيق

باستخدام Android 8.0 (مستوى واجهة برمجة التطبيقات 26) والإصدارات الأحدث، يمكنك السماح للمستخدمين بتثبيت تطبيقاتك المصغّرة على شاشتهم الرئيسية داخل تطبيقك. ويُعد الترويج للتطبيقات المصغّرة مباشرةً داخل تطبيقك طريقة رائعة لزيادة تفاعل المستخدمين، خاصةً بعد أن يكمل المستخدم مهمة ذات صلة، أو عندما يصل المستخدم بشكل متكرّر إلى ميزة في تطبيقك.

إنشاء طلب تثبيت

لبدء عملية تثبيت التطبيق المصغّر، استخدِم طريقة requestPinGlanceAppWidget من فئة GlanceAppWidgetManager. بالنسبة إلى التطبيقات التي تعمل على إصدارات Android الأقل، تعرض هذه الطريقة القيمة "خطأ". ومع ذلك، إذا تم إرسال الطلب بنجاح إلى النظام، تعرض هذه الطريقة القيمة "صحيح".

في ما يلي مثال على كيفية إنشاء طلب تثبيت:

@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

في هذا المثال، MyWidgetReceiver هي الفئة التي تتلقّى معاودة الاتصال الخاصة بالتطبيق المصغّر ، وMyWidget هو تطبيق Glance المصغّر الذي تريد تثبيته. successCallback هو PendingIntent يتم تشغيله عند تثبيت التطبيق المصغّر بنجاح.

التعامل مع ردّ طلب التثبيت

عندما يردّ المستخدم على مربّع حوار طلب التثبيت، يتلقّى تطبيقك ردًّا. إذا وافق المستخدم على الطلب، يتم تثبيت تطبيقك المصغّر على شاشته الرئيسية، ويتم تشغيل PendingIntent الخاص بـ successCallback. إذا رفض المستخدم الطلب، لا يحدث أي شيء.

من المهم ملاحظة أنّه يتم تشغيل successCallback فقط إذا تمت إضافة التطبيق المصغّر بنجاح إلى الشاشة الرئيسية. لا يتم تشغيله إذا رفض المستخدم الطلب أو إذا كان مشغّل التطبيقات لا يتيح التثبيت.