שימוש בווידג'טים של אוספים

כדאי לנסות את הדרך של Compose

‫Jetpack Compose היא ערכת הכלים המומלצת לבניית ממשק משתמש ל-Android. איך יוצרים ווידג'טים באמצעות ממשקי API בסגנון Compose

Jetpack Glance →

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

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

‫ListView: תצוגה שבה הפריטים מוצגים ברשימה עם גלילה אנכית.

‫GridView: תצוגה שבה הפריטים מוצגים ברשת גלילה דו-ממדית.

‫StackView: תצוגת כרטיסים מוערמים – כמו כרטיסיות מסתובבות – שבה המשתמש יכול להחליק את הכרטיס הקדמי למעלה או למטה כדי לראות את הכרטיס הקודם או הבא, בהתאמה.

‫AdapterViewFlipper: ViewAnimator שנתמך על ידי מתאם ומציג אנימציה של מעבר בין שתי תצוגות או יותר. בכל פעם מוצג רק ילד אחד.

תצוגות האוספים האלה מציגות אוספים שמגובים בנתונים מרוחקים, ולכן הן משתמשות ב-Adapter כדי לקשר את ממשק המשתמש שלהן לנתונים. ‫Adapter מחבר פריטים בודדים מקבוצת נתונים לאובייקטים בודדים של View.

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

‫RemoteViewsService הוא שירות שמאפשר למתאם מרוחק לבקש אובייקטים של RemoteViews. ‫RemoteViewsFactory הוא ממשק למתאם בין תצוגת אוסף – כמו ListView, GridView ו-StackView – לבין הנתונים הבסיסיים של התצוגה הזו. בדוגמה הבאה מתוך StackWidgetהדוגמה, מוצג קוד boilerplate להטמעה של השירות והממשק הזה:

class StackWidgetService : RemoteViewsService() {
    override fun onGetViewFactory(intent: Intent): RemoteViewsFactory =
        StackRemoteViewsFactory(this.applicationContext, intent)
}

class StackRemoteViewsFactory(
    private val context: Context, intent: Intent
) : RemoteViewsService.RemoteViewsFactory {

    // See the RemoteViewsFactory API reference for the full list of methods to implement.

}
Collections.kt

אפליקציה לדוגמה

קטעי הקוד בקטע הזה נלקחו גם הם מStackWidget הדוגמה:

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

• המשתמש יכול להעיף את התצוגה העליונה בווידג'ט אנכית כדי להציג את התצוגה הבאה או הקודמת. זו התנהגות מובנית של StackView.

• ללא אינטראקציה עם המשתמש, הווידג'ט עובר אוטומטית בין התצוגות שלו ברצף, כמו מצגת. הסיבה לכך היא ההגדרה android:autoAdvanceViewId="@id/stack_view" בקובץ res/xml/stackwidgetinfo.xml. ההגדרה הזו חלה על מזהה התצוגה המפורטת, שבמקרה הזה הוא מזהה התצוגה המפורטת של תצוגת הערימה.

• אם המשתמש מקיש על התצוגה העליונה, בווידג'ט מוצגת ההודעה Toast Touched view n (התצוגה n הוקשה), כאשר n הוא האינדקס (המיקום) של התצוגה שהוקשה. מידע נוסף על הטמעה של התנהגויות זמין בקטע הוספת התנהגות לפריטים ספציפיים.

הטמעה של ווידג'טים באמצעות אוספים

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

מניפסט לווידג'טים עם אוספים

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

לדוגמה, כשיוצרים ווידג'ט שמשתמש ב-RemoteViewsService כדי לאכלס תצוגת אוסף, יכול להיות שרשומה במניפסט תיראה כך:

<service android:name="MyWidgetService"
    android:permission="android.permission.BIND_REMOTEVIEWS" />

בדוגמה הזו, android:name="MyWidgetService" מתייחס למחלקת המשנה שלכם של RemoteViewsService.

פריסה של ווידג'טים עם אוספים

הדרישה העיקרית מקובץ ה-XML של פריסת הווידג'ט היא שהוא יכלול אחת מתצוגות האוסף: ListView, GridView, StackView או AdapterViewFlipper. הנה קובץ widget_layout.xml לדוגמה של StackWidget:

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
    <StackView
        android:id="@+id/stack_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:gravity="center"
        android:loopViews="true" />
    <TextView
        android:id="@+id/empty_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:gravity="center"
        android:background="@drawable/widget_item_background"
        android:textColor="#ffffff"
        android:textStyle="bold"
        android:text="@string/empty_view_text"
        android:textSize="20sp" />
</FrameLayout>
widget_layout.xml

חשוב לשים לב שתצוגות ריקות צריכות להיות באותה רמה של תצוגת האוסף שהתצוגה הריקה מייצגת את המצב הריק שלה.

בנוסף לקובץ הפריסה של הווידג'ט כולו, יוצרים עוד קובץ פריסה שמגדיר את הפריסה של כל פריט באוסף – לדוגמה, פריסה לכל ספר באוסף של ספרים. בדוגמה StackWidget יש רק קובץ אחד של פריסת פריטים, widget_item.xml, כי כל הפריטים משתמשים באותה פריסה.

המחלקות AppWidgetProvider לווידג'טים עם אוספים

בדומה לווידג'טים רגילים, רוב הקוד במחלקת המשנה AppWidgetProvider בדרך כלל מופיע ב-onUpdate(). ההבדל העיקרי בהטמעה של onUpdate() כשיוצרים ווידג'ט עם אוספים הוא שצריך להפעיל את setRemoteAdapter(). ההגדרה הזו מציינת לתצוגת האוסף מאיפה לקבל את הנתונים. לאחר מכן, RemoteViewsService יכול להחזיר את ההטמעה של RemoteViewsFactory, והווידג'ט יכול להציג את הנתונים המתאימים. כשקוראים לשיטה הזו, מעבירים כוונה שמפנה להטמעה של RemoteViewsService ומזהה הווידג'ט שמציין את הווידג'ט לעדכון.

לדוגמה, כך מיושמת הדוגמה StackWidget של שיטת הקריאה החוזרת onUpdate() כדי להגדיר את RemoteViewsService כמתאם מרוחק לאוסף הווידג'טים:

override fun onUpdate(
    context: Context, appWidgetManager: AppWidgetManager, appWidgetIds: IntArray
) {
    // Update each of the widgets with the remote adapter.
    appWidgetIds.forEach { appWidgetId ->

        // Set up the intent that starts the StackViewService, which
        // provides the views for this collection.
        val intent = Intent(context, StackWidgetService::class.java).apply {
            // Add the widget ID to the intent extras.
            putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId)
            data = Uri.parse(toUri(Intent.URI_INTENT_SCHEME))
        }
        // Instantiate the RemoteViews object for the widget layout.
        val views = RemoteViews(context.packageName, R.layout.widget_layout).apply {
            // Set up the RemoteViews object to use a RemoteViews adapter.
            // This adapter connects to a RemoteViewsService through the
            // specified intent.
            // This is how you populate the data.
            setRemoteAdapter(R.id.stack_view, intent)

            // The empty view is displayed when the collection has no items.
            // It must be in the same layout used to instantiate the
            // RemoteViews object.
            setEmptyView(R.id.stack_view, R.id.empty_view)
        }

        // Do additional processing specific to this widget.

        appWidgetManager.updateAppWidget(appWidgetId, views)
    }
    super.onUpdate(context, appWidgetManager, appWidgetIds)
}
Collections.kt

שמירת נתונים

כמו שמתואר בדף הזה, מחלקת המשנה RemoteViewsService מספקת את RemoteViewsFactory שמשמש לאכלוס תצוגת האוסף המרוחק.

צריך לבצע את הפעולות הבאות:

1. מחלקה משנית RemoteViewsService. ‫RemoteViewsService הוא השירות שדרכו מתאם מרוחק יכול לבקש RemoteViews.

2. במחלקת המשנה RemoteViewsService, כוללים מחלקה שמטמיעה את הממשק RemoteViewsFactory. ‫RemoteViewsFactory הוא ממשק למתאם בין תצוגת אוסף מרוחקת – כמו ListView,‏ GridView, ‏ StackView – לבין הנתונים הבסיסיים של התצוגה הזו. ההטמעה שלכם אחראית ליצירת אובייקט RemoteViews לכל פריט במערך הנתונים. הממשק הזה הוא עטיפה דקה סביב Adapter.

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

התוכן העיקרי של ההטמעה של RemoteViewsService הוא RemoteViewsFactory, שמתואר בקטע הבא.

הממשק RemoteViewsFactory

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

שתי השיטות הכי חשובות שצריך להטמיע עבור מחלקת המשנה RemoteViewsFactory הן onCreate() ו-getViewAt().

המערכת קוראת ל-onCreate() כשיוצרים את המפעל בפעם הראשונה. כאן מגדירים חיבורים או סמנים למקור הנתונים. לדוגמה, בדוגמה StackWidget נעשה שימוש ב-onCreate() כדי לאתחל מערך של אובייקטים מסוג WidgetItem. כשהווידג'ט פעיל, המערכת ניגשת לאובייקטים האלה באמצעות מיקום האינדקס שלהם במערך ומציגה את הטקסט שהם מכילים.

קטע מתוך ההטמעה של StackWidgetהדוגמהRemoteViewsFactory שמציג חלקים מהמתודה onCreate():

private const val REMOTE_VIEW_COUNT: Int = 10

class StackRemoteViewsFactory(
    private val context: Context
) : RemoteViewsService.RemoteViewsFactory {

    private lateinit var widgetItems: List<WidgetItem>

    override fun onCreate() {
        // In onCreate(), set up any connections or cursors to your data
        // source. Heavy lifting, such as downloading or creating content,
        // must be deferred to onDataSetChanged() or getViewAt(). Taking
        // more than 20 seconds on this call results in an ANR.
        widgetItems = List(REMOTE_VIEW_COUNT) { index -> WidgetItem("$index!") }
    }

}
Collections.kt

השיטה RemoteViewsFactory‏ getViewAt() מחזירה אובייקט RemoteViews שמתאים לנתונים במיקום position שצוין במערך הנתונים. קטע מתוך ההטמעה של StackWidget בדוגמה RemoteViewsFactory:

override fun getViewAt(position: Int): RemoteViews {
    // Construct a remote views item based on the widget item XML file
    // and set the text based on the position.
    return RemoteViews(context.packageName, R.layout.widget_item).apply {
        setTextViewText(R.id.widget_item, widgetItems[position].text)
    }
}
Collections.kt

הוספת התנהגות לפריטים ספציפיים

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

כפי שמתואר במאמר בנושא טיפול באירועים באמצעות המחלקה onUpdate(), בדרך כלל משתמשים ב-setOnClickPendingIntent() כדי להגדיר את התנהגות הקליק של אובייקט – למשל, כדי לגרום ללחצן להפעיל Activity. אבל אסור להשתמש בגישה הזו בתצוגות של פריטים משניים בפריט אוסף בודד. לדוגמה, אפשר להשתמש ב-setOnClickPendingIntent() כדי להגדיר לחצן גלובלי בווידג'ט של Gmail שמפעיל את האפליקציה, אבל לא בפריטים בודדים ברשימה.

במקום זאת, כדי להוסיף התנהגות קליק לפריטים ספציפיים באוסף, משתמשים ב-setOnClickFillInIntent(). מגדירים תבנית של intent בהמתנה לתצוגת הקולקציה ומגדירים Fill-in Intent בכל פריט בקולקציה באמצעות RemoteViewsFactory.

בקטע הזה אנחנו משתמשים בדוגמה StackWidget כדי להסביר איך מוסיפים התנהגות לפריטים בודדים. בדוגמה StackWidget, אם המשתמש מקיש על התצוגה העליונה, בווידג'ט מוצגת ההודעה Toast 'התצוגה n הוקשה', כאשר n הוא האינדקס (המיקום) של התצוגה שהוקשה. כך זה עובד:

• המחלקות StackWidgetProvider – מחלקה משנית של AppWidgetProvider – יוצרות intent בהמתנה עם פעולה מותאמת אישית בשם TOAST_ACTION.

• כשהמשתמש מקיש על תצוגה, הכוונה מופעלת והיא משודרת TOAST_ACTION.

• השידור הזה נחטף על ידי השיטה onReceive() של המחלקה StackWidgetProvider, והווידג'ט מציג את ההודעה Toast לתצוגה שהמשתמש נגע בה. הנתונים של הפריטים באוסף מסופקים על ידי RemoteViewsFactory דרך RemoteViewsService.

הגדרת תבנית של intent בהמתנה

המחלקת StackWidgetProvider (מחלקת משנה של AppWidgetProvider) מגדירה PendingIntent. אי אפשר להגדיר כוונות בהמתנה לפריטים ספציפיים באוסף. במקום זאת, האוסף כולו מגדיר תבנית של אובייקט Intent בהמתנה, והפריטים הבודדים מגדירים אובייקט Intent למילוי כדי ליצור התנהגות ייחודית על בסיס פריט-לפריט.

הכיתה הזו מקבלת גם את השידור שנשלח כשהמשתמש נוגע בתצוגה. הוא מעבד את האירוע הזה בשיטה onReceive() שלו. אם הפעולה של הכוונה היא TOAST_ACTION, בווידג'ט מוצגת הודעה Toast לגבי התצוגה הנוכחית.

const val TOAST_ACTION = "com.example.android.stackwidget.TOAST_ACTION"
const val EXTRA_ITEM = "com.example.android.stackwidget.EXTRA_ITEM"

class StackWidgetProvider : AppWidgetProvider() {

    // ...

    // Called when the BroadcastReceiver receives an Intent broadcast.
    // Checks whether the intent's action is TOAST_ACTION. If it is, the
    // widget displays a Toast message for the current item.
    override fun onReceive(context: Context, intent: Intent) {
        val mgr: AppWidgetManager = AppWidgetManager.getInstance(context)
        if (intent.action == TOAST_ACTION) {
            val appWidgetId: Int = intent.getIntExtra(
                AppWidgetManager.EXTRA_APPWIDGET_ID,
                AppWidgetManager.INVALID_APPWIDGET_ID
            )
            // EXTRA_ITEM represents a custom value provided by the Intent
            // passed to the setOnClickFillInIntent() method to indicate the
            // position of the clicked item. See StackRemoteViewsFactory in
            // Set the fill-in Intent for details.
            val viewIndex: Int = intent.getIntExtra(EXTRA_ITEM, 0)
            Toast.makeText(context, "Touched view $viewIndex", Toast.LENGTH_SHORT).show()
        }
        super.onReceive(context, intent)
    }

    override fun onUpdate(
        context: Context,
        appWidgetManager: AppWidgetManager,
        appWidgetIds: IntArray
    ) {
        // Update each of the widgets with the remote adapter.
        appWidgetIds.forEach { appWidgetId ->

            // Sets up the intent that points to the StackViewService that
            // provides the views for this collection.
            val intent = Intent(context, StackWidgetService::class.java).apply {
                putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId)
                // When intents are compared, the extras are ignored, so embed
                // the extra sinto the data so that the extras are not ignored.
                data = Uri.parse(toUri(Intent.URI_INTENT_SCHEME))
            }
            val rv = RemoteViews(context.packageName, R.layout.widget_layout).apply {
                setRemoteAdapter(R.id.stack_view, intent)

                // The empty view is displayed when the collection has no items.
                // It must be a sibling of the collection view.
                setEmptyView(R.id.stack_view, R.id.empty_view)
            }

            // This section makes it possible for items to have individualized
            // behavior. It does this by setting up a pending intent template.
            // Individuals items of a collection can't set up their own pending
            // intents. Instead, the collection as a whole sets up a pending
            // intent template, and the individual items set a fillInIntent
            // to create unique behavior on an item-by-item basis.
            val toastPendingIntent: PendingIntent = Intent(
                context,
                StackWidgetProvider::class.java
            ).run {
                // Set the action for the intent.
                // When the user touches a particular view, it has the effect of
                // broadcasting TOAST_ACTION.
                action = TOAST_ACTION
                putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId)
                data = Uri.parse(toUri(Intent.URI_INTENT_SCHEME))

                // The template must be mutable, because each item fills in its
                // own extras through setOnClickFillInIntent().
                PendingIntent.getBroadcast(
                    context, 0, this,
                    PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_MUTABLE
                )
            }
            rv.setPendingIntentTemplate(R.id.stack_view, toastPendingIntent)

            appWidgetManager.updateAppWidget(appWidgetId, rv)
        }
        super.onUpdate(context, appWidgetManager, appWidgetIds)
    }
}
Collections.kt

הגדרת כוונת המשתמש להשלמת פרטים

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

private const val REMOTE_VIEW_COUNT: Int = 10

class StackRemoteViewsFactory(
    private val context: Context,
    intent: Intent
) : RemoteViewsService.RemoteViewsFactory {

    private lateinit var widgetItems: List<WidgetItem>
    private val appWidgetId: Int = intent.getIntExtra(
        AppWidgetManager.EXTRA_APPWIDGET_ID,
        AppWidgetManager.INVALID_APPWIDGET_ID
    )

    override fun onCreate() {
        // In onCreate(), set up any connections or cursors to your data source.
        // Heavy lifting, such as downloading or creating content, must be
        // deferred to onDataSetChanged() or getViewAt(). Taking more than 20
        // seconds on this call results in an ANR.
        widgetItems = List(REMOTE_VIEW_COUNT) { index -> WidgetItem("$index!") }
        // ...
    }

    // ...

    override fun getViewAt(position: Int): RemoteViews {
        // Construct a remote views item based on the widget item XML file
        // and set the text based on the position.
        return RemoteViews(context.packageName, R.layout.widget_item).apply {
            setTextViewText(R.id.widget_item, widgetItems[position].text)

            // Set a fill-intent to fill in the pending intent template.
            // that is set on the collection view in StackWidgetProvider.
            val fillInIntent = Intent().apply {
                Bundle().also { extras ->
                    extras.putInt(EXTRA_ITEM, position)
                    putExtras(extras)
                }
            }
            // Make it possible to distinguish the individual on-click
            // action of a given item.
            setOnClickFillInIntent(R.id.widget_item, fillInIntent)
            // ...
        }
    }
    // ...
}
Collections.kt

שמירה על עדכניות נתוני האוסף

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

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

כדי לעשות את זה, משתמשים בפקודה AppWidgetManager כדי להתקשר אל notifyAppWidgetViewDataChanged(). השיחה הזו גורמת להחזרת קריאה (callback) לשיטה onDataSetChanged() של אובייקט RemoteViewsFactory, וכך אפשר לאחזר נתונים חדשים.

אפשר לבצע פעולות שדורשות הרבה משאבי עיבוד באופן סינכרוני בתוך הקריאה החוזרת (callback) של onDataSetChanged(). השיחה הזו מסתיימת לפני שליפת המטא-נתונים או נתוני הצפייה מ-RemoteViewsFactory. אפשר גם לבצע פעולות שדורשות הרבה משאבים בשיטה getViewAt(). אם הקריאה הזו נמשכת זמן רב, תצוגת הטעינה – שצוינה בשיטה getLoadingView() של האובייקט RemoteViewsFactory – מוצגת במיקום המתאים בתצוגת האוסף עד שהיא חוזרת.

שימוש ב-RemoteCollectionItems כדי להעביר אוסף ישירות

ב-Android 12 (רמת API 31) נוספה השיטה setRemoteAdapter(int viewId, RemoteViews.RemoteCollectionItems items), שמאפשרת לאפליקציה להעביר אוסף ישירות בזמן אכלוס תצוגת אוסף. אם מגדירים את המתאם באמצעות השיטה הזו, לא צריך להטמיע RemoteViewsFactory ולא צריך להתקשר אל notifyAppWidgetViewDataChanged().

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

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

דוגמה להטמעה של אוספים פשוטים של RemoteViews.

val itemLayouts = listOf(
    R.layout.item_type_1,
    R.layout.item_type_2,
    // ...
)

remoteView.setRemoteAdapter(
    R.id.list_view,
    RemoteViews.RemoteCollectionItems.Builder()
        .addItem(/* id= */ ID_1, RemoteViews(context.packageName, R.layout.item_type_1))
        .addItem(/* id= */ ID_2, RemoteViews(context.packageName, R.layout.item_type_2))
        // ...
        .setViewTypeCount(itemLayouts.count())
        .build()
)
Collections.kt