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

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

דוגמה להצמדת ווידג'ט
איור 1. דוגמה להצמדת ווידג'ט.

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

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

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

  2. מפעילים את ה-method‏ 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)
}

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