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

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

إنشاء طلب رقم تعريف شخصي

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

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

@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 يتم تشغيله عند تثبيت التطبيق المصغّر بنجاح.

التعامل مع الردّ على طلب رقم التعريف الشخصي

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

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