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

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

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

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

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

1. يجب تحديد أداة في ملف البيان الخاص بتطبيقك.

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

Kotlin

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)

    appWidgetManager.requestPinAppWidget(myProvider, null, successCallback)
}

Java

AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
ComponentName myProvider = new ComponentName(context, ExampleAppWidgetProvider.class);

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).
    PendingIntent successCallback = PendingIntent.getBroadcast(
            /* context = */ context,
            /* requestCode = */ 0,
            /* intent = */ new Intent(...),
            /* flags = */ PendingIntent.FLAG_UPDATE_CURRENT);

    appWidgetManager.requestPinAppWidget(myProvider, null, successCallback);
}

ملاحظة: إذا لم يكن تطبيقك بحاجة إلى إشعار ما إذا كان النظام سيتم بنجاح يثبّت تطبيقًا مصغّرًا في مشغّل تطبيقات متوافق، ويمكنك تمرير null كالطرف الثالث الوسيطة إلى requestPinAppWidget().

إرشادات التصميم ذات الصلة

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