قابلية اكتشاف الأداة

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

مثال على تثبيت تطبيق مصغّر
الشكل 1: مثال على تثبيت تطبيق مصغّر

السماح للمستخدمين بتثبيت تطبيق مصغّر

في تطبيقك، يمكنك إنشاء طلب للنظام لتثبيت تطبيق مصغّر على مشغّل تطبيقات متوافق من خلال إكمال الخطوات التالية:

  1. تأكَّد من تعريف التطبيق المصغّر في ملف بيان تطبيقك.

  2. استدعِ الإجراء requestPinAppWidget() كما هو موضّح في مقتطف الرمز التالي:

val appWidgetManager = AppWidgetManager.getInstance(context)
val myProvider = ComponentName(context, ExampleAppWidgetProvider::class.java)

if (appWidgetManager.isRequestPinAppWidgetSupported) {
    // Create the PendingIntent object only if your app needs to be notified
    // when the user chooses to pin the widget. Note that if the pinning
    // operation fails, your app isn't notified. This callback receives the ID
    // of the newly pinned widget (EXTRA_APPWIDGET_ID).
    val successCallback = PendingIntent.getBroadcast(
        /* context = */ context,
        /* requestCode = */ 0,
        /* intent = */ Intent(
            // ...
        ),
        /* flags = */ PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE
    )

    appWidgetManager.requestPinAppWidget(myProvider, null, successCallback)
}

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