יכולת הגילוי של ווידג'טים

במכשירים עם Android מגרסה 8.0 (API ברמה 26) ואילך, מרכזי האפליקציות שמאפשרים למשתמשים ליצור קיצורי דרך מוצמדים מאפשרים להם גם להצמיד ווידג'טים למסך הבית. בדומה לקיצורי דרך מוצמדים, הווידג'טים המוצמדים האלה מעניקים למשתמשים גישה למשימות ספציפיות באפליקציה, וניתן להוסיף אותם למסך הבית ישירות מהאפליקציה, כפי שמתואר בסרטון הבא.

איור 2. דוגמה להצמדה של ווידג'ט

לאפשר למשתמשים להצמיד ווידג'ט

באפליקציה, אפשר ליצור בקשה למערכת להצמיד וידג'ט למרכז אפליקציות נתמך. לשם כך, מבצעים את השלבים הבאים:

1. חשוב להצהיר על ווידג'ט בקובץ המניפסט של האפליקציה.

2. קוראים ל-method‏ 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().

הנחיות עיצוב קשורות

המשתמשים מגלים את הווידג'ט ומוסיפים אותו דרך הכלי לבחירת ווידג'טים או מתוך האפליקציה, כשהפונקציונליות של הווידג'ט רלוונטית ביותר. מידע נוסף זמין במאמר חשיפת המוצרים וקידום המכירות שלהם.