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

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

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

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

في ما يلي مثال على كيفية إنشاء طلب رمز 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

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

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

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

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