בדף הזה מפורטות שיטות מומלצות ליצירת ווידג'ט מתקדם יותר לחוויית משתמש טובה יותר.
אופטימיזציות לעדכון תוכן של ווידג'טים
עדכון התוכן של הווידג'טים יכול להיות יקר. כדי לחסוך בצריכת הסוללה צריכה, לבצע אופטימיזציה של סוג העדכון, התדירות והתזמון.
סוגי העדכונים לווידג'טים
קיימות שלוש דרכים לעדכן ווידג'ט: עדכון מלא, עדכון חלקי, במקרה של ווידג'ט של אוסף, רענון הנתונים מתבצע. לכל אחד יש עלויות חישוביות והשלכות.
בהמשך מתוארים כל סוג של עדכון וקטעי קוד לכל אחד מהם.
עדכון מלא: שיחה
AppWidgetManager.updateAppWidget(int, android.widget.RemoteViews)
כדי לעדכן את הווידג'ט באופן מלא. הפעולה הזו מחליפה את ההגדרות הקודמותRemoteViews
עם חשבון חדשRemoteViews
. זה העדכון הממוחשב ביותר.Kotlin
val appWidgetManager = AppWidgetManager.getInstance(context) val remoteViews = RemoteViews(context.getPackageName(), R.layout.widgetlayout).also { setTextViewText(R.id.textview_widget_layout1, "Updated text1") setTextViewText(R.id.textview_widget_layout2, "Updated text2") } appWidgetManager.updateAppWidget(appWidgetId, remoteViews)
Java
AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context); RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.widgetlayout); remoteViews.setTextViewText(R.id.textview_widget_layout1, "Updated text1"); remoteViews.setTextViewText(R.id.textview_widget_layout2, "Updated text2"); appWidgetManager.updateAppWidget(appWidgetId, remoteViews);
עדכון חלקי: שיחה
AppWidgetManager.partiallyUpdateAppWidget
כדי לעדכן חלקים של הווידג'ט. הפעולה הזו תמזג אתRemoteViews
החדש עם סופקו בעבר:RemoteViews
. המערכת מתעלמת מהשיטה הזו אם ווידג'ט לא מקבל לפחות עדכון מלא אחד דרךupdateAppWidget(int[], RemoteViews)
.Kotlin
val appWidgetManager = AppWidgetManager.getInstance(context) val remoteViews = RemoteViews(context.getPackageName(), R.layout.widgetlayout).also { setTextViewText(R.id.textview_widget_layout, "Updated text") } appWidgetManager.partiallyUpdateAppWidget(appWidgetId, remoteViews)
Java
AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context); RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.widgetlayout); remoteViews.setTextViewText(R.id.textview_widget_layout, "Updated text"); appWidgetManager.partiallyUpdateAppWidget(appWidgetId, remoteViews);
רענון של נתוני איסוף: שיחה
AppWidgetManager.notifyAppWidgetViewDataChanged
כדי לבטל את תוקף הנתונים של תצוגת אוסף בווידג'ט. זה מפעילRemoteViewsFactory.onDataSetChanged
בינתיים, הנתונים הישנים מוצגים בווידג'ט. אפשר: לבצע משימות יקרות באופן סינכרוני עם השיטה הזו.Kotlin
val appWidgetManager = AppWidgetManager.getInstance(context) appWidgetManager.notifyAppWidgetViewDataChanged(appWidgetId, R.id.widget_listview)
Java
AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context); appWidgetManager.notifyAppWidgetViewDataChanged(appWidgetId, R.id.widget_listview);
תוכלו להפעיל את השיטות האלה מכל מקום באפליקציה, כל עוד באפליקציה יש
אותו UID כמו
AppWidgetProvider
.
קביעת התדירות של עדכון ווידג'ט
הווידג'טים מתעדכנים מדי פעם בהתאם לערך שצוין עבור
updatePeriodMillis
. הווידג'ט יכול להתעדכן בתגובה לאינטראקציה של המשתמש, לשידור
עדכונים, או את שניהם.
עדכון מדי פעם
אפשר לשלוט בתדירות של העדכון התקופתי על ידי ציון ערך עבור
AppWidgetProviderInfo.updatePeriodMillis
ב-XML של appwidget-provider
. כל אחד
העדכון מפעיל את השיטה AppWidgetProvider.onUpdate()
, שבה
יכולים להציב את הקוד כדי לעדכן את הווידג'ט. אבל כדאי לשקול את החלופות
עדכונים של מקלט השידורים שמתוארים
הקטע הבא אם הווידג'ט שלכם צריך לטעון נתונים באופן אסינכרוני או שהוא לוקח יותר
מ-10 שניות כדי לעדכן, כי אחרי 10 שניות המערכת מתייחסת
BroadcastReceiver
כדי לא להגיב.
updatePeriodMillis
לא תומך בערכים של פחות מ-30 דקות. אבל אם
שרוצים להשבית את העדכונים התקופתיים, אפשר לציין 0.
אתם יכולים לאפשר למשתמשים לשנות את תדירות העדכונים בהגדרות אישיות. עבור
למשל, ייתכן שהם ירצו לראות מניה מסוימת להתעדכן כל 15 דקות או רק ארבע
פעמים ביום. במקרה הזה, צריך להגדיר את הערך של updatePeriodMillis
ל-0 ולהשתמש
WorkManager
במקום זאת.
עדכון בתגובה לאינטראקציה של משתמש
הנה כמה דרכים מומלצות לעדכון הווידג'ט בהתאם לאינטראקציה של המשתמש:
מפעילות של האפליקציה: התקשרות ישירה
AppWidgetManager.updateAppWidget
בתגובה לאינטראקציה של משתמש, כמו כהקשה של משתמש.מאינטראקציות מרחוק, כמו התראה או ווידג'ט של אפליקציה: ליצור
PendingIntent
, ואז לעדכן את הווידג'ט מהמופעלActivity
,Broadcast
אוService
. אתם יכולים לבחור עדיפות משלכם. עבור לדוגמה, אם בוחריםBroadcast
עבורPendingIntent
, אפשר לבחור שידור קדמי כדי לתת עדיפותBroadcastReceiver
.
עדכון בתגובה לאירוע שמשודר
דוגמה לאירוע שידור שדורש עדכון ווידג'ט היא כאשר משתמש מצלם תמונה. במקרה זה, תרצו לעדכן את הווידג'ט כשתמונה חדשה כשמתבצע זיהוי.
אפשר לתזמן משימה עם JobScheduler
ולהגדיר שידור בתור
באמצעות הפקודה
JobInfo.Builder.addTriggerContentUri
.
אפשר גם לרשום BroadcastReceiver
לשידור — לדוגמה,
האזנה למשך
ACTION_LOCALE_CHANGED
.
עם זאת, מכיוון שהפעולה הזו צורכת משאבים במכשיר, חשוב להפעיל שיקול דעת ולהאזין
רק לשידור הספציפי. עם ההשקה של broadcast
מגבלות ב-Android
7.0 (רמת API 24) ו-Android 8.0 (רמת API 26), אפליקציות לא יכולות לבצע רישום משתמע
משודרים במניפסטים שלהם,
חריגים.
שיקולים לעדכון ווידג'ט מ- BroadcastReceiver
אם הווידג'ט מעודכן דרך BroadcastReceiver
, כולל
AppWidgetProvider
, חשוב לשים לב לשיקולים הבאים
משך הזמן והעדיפות של עדכון ווידג'ט.
משך העדכון
בדרך כלל, המערכת מאפשרת למקלטי שידורים, שפועלים בדרך כלל ה-thread הראשי, ירוץ למשך עד 10 שניות לפני שהוא נחשב ללא תגובה הפעלת יישום לא שגיאת תגובה (ANR). אם התהליך נמשך זמן רב יותר, ומעדכנים את הווידג'ט, לשקול את החלופות הבאות:
לתזמן משימה באמצעות
WorkManager
.נותנים למקבל התשלום עוד זמן באמצעות
goAsync
. כך המקלטים יכולים לפעול במשך 30 שניות.
לעיון במאמר שיקולי אבטחה שיטות עבודה נוספות מידע.
עדיפות העדכון
כברירת מחדל, שידורים — כולל שידורים שבוצעו באמצעות
AppWidgetProvider.onUpdate
– להריץ כתהליכים ברקע. כלומר
עומס יתר במשאבי מערכת עלול לגרום לעיכוב בהפעלת השידור
הנמען. כדי לתת עדיפות לשידור, צריך להפוך אותו לתהליך שפועל בחזית.
לדוגמה, הוסף את
Intent.FLAG_RECEIVER_FOREGROUND
דגל ל-Intent
שמועבר אל PendingIntent.getBroadcast
כשהמשתמש
שמקישים על חלק מסוים בווידג'ט.
יצירת תצוגות מקדימות מדויקות שכוללות פריטים דינמיים
![](https://developer.android.com/static/images/appwidgets/missing-list.png?authuser=9&hl=he)
הקטע הזה מסביר את הגישה המומלצת להצגת מספר פריטים
תצוגה מקדימה של ווידג'ט לווידג'ט עם אוסף
תצוגה מפורטת – כלומר, ווידג'ט שמשתמש
ListView
, GridView
או StackView
.
אם הווידג'ט משתמש באחת מהתצוגות האלה, המערכת יוצרת תצוגה מקדימה ניתנת להתאמה על ידי לספק את הווידג'ט עצמו פוגעת כשאין פריטים בתצוגה המקדימה של הווידג'ט. הסיבה לכך היא הנתונים בתצוגת האוסף מוגדרים באופן דינמי בזמן הריצה, והם נראים דומים בתמונה שמוצגת באיור 1.
כדי שתצוגות מקדימות של ווידג'טים עם תצוגות אוספים יוצגו כראוי בווידג'ט.
מומלץ לתחזק קובץ פריסה נפרד שמיועד רק
תצוגה מקדימה. קובץ הפריסה הנפרד הזה כולל את פריסת הווידג'ט עצמו
תצוגת אוסף placeholder עם פריטים מזויפים. לדוגמה, אפשר לחקות
ListView
על ידי הוספת placeholder של LinearLayout
עם כמה רשימות מזויפות
פריטים.
כדי להמחיש דוגמה של ListView
, צריך להתחיל בקובץ פריסה נפרד:
// res/layout/widget_preview.xml
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:background="@drawable/widget_background"
android:orientation="vertical">
// Include the actual widget layout that contains ListView.
<include
layout="@layout/widget_view"
android:layout_width="match_parent"
android:layout_height="wrap_content" />
// The number of fake items you include depends on the values you provide
// for minHeight or targetCellHeight in the AppWidgetProviderInfo
// definition.
<TextView android:text="@string/fake_item1"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_marginVertical="?attr/appWidgetInternalPadding" />
<TextView android:text="@string/fake_item2"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_marginVertical="?attr/appWidgetInternalPadding" />
</LinearLayout>
צריך לציין את קובץ פריסת התצוגה המקדימה כשמציינים את המאפיין previewLayout
של
את המטא-נתונים AppWidgetProviderInfo
. עדיין צריך לציין את פריסת הווידג'ט בפועל
עבור המאפיין initialLayout
ולהשתמש בפריסת הווידג'ט בפועל כאשר
ליצור RemoteViews
בזמן ריצה.
<appwidget-provider
previewLayout="@layout/widget_previe"
initialLayout="@layout/widget_view" />
פריטים מורכבים ברשימה
הדוגמה בקטע הקודם מספקת פריטי רשימה מזויפים, מכיוון שהרשימה
פריטים הם TextView
אובייקטים. זה יכול להיות
לספק פריטים מזויפים אם הפריסה מורכבת.
נבחן פריט רשימה שמוגדר ב-widget_list_item.xml
וכולל
שני אובייקטים מסוג TextView
:
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="wrap_content">
<TextView android:id="@id/title"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="@string/fake_title" />
<TextView android:id="@id/content"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="@string/fake_content" />
</LinearLayout>
כדי לספק פריטים מזויפים ברשימה, ניתן לכלול את הפריסה מספר פעמים, אך תגרום לכל פריט ברשימה להיות זהה. כדי לספק פריטים ייחודיים ברשימה: את השלבים הבאים:
יוצרים קבוצת מאפיינים לערכי הטקסט:
<resources> <attr name="widgetTitle" format="string" /> <attr name="widgetContent" format="string" /> </resources>
יש להשתמש במאפיינים הבאים כדי להגדיר את הטקסט:
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent" android:layout_height="wrap_content"> <TextView android:id="@id/title" android:layout_width="match_parent" android:layout_height="wrap_content" android:text="?widgetTitle" /> <TextView android:id="@id/content" android:layout_width="match_parent" android:layout_height="wrap_content" android:text="?widgetContent" /> </LinearLayout>
אפשר ליצור כמה סגנונות שרוצים לתצוגה המקדימה. הגדירו מחדש את הערכים ב- כל סגנון:
<resources> <style name="Theme.Widget.ListItem"> <item name="widgetTitle"></item> <item name="widgetContent"></item> </style> <style name="Theme.Widget.ListItem.Preview1"> <item name="widgetTitle">Fake Title 1</item> <item name="widgetContent">Fake content 1</item> </style> <style name="Theme.Widget.ListItem.Preview2"> <item name="widgetTitle">Fake title 2</item> <item name="widgetContent">Fake content 2</item> </style> </resources>
החלת הסגנונות על הפריטים המזויפים בפריסת התצוגה המקדימה:
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent" android:layout_height="wrap_content" ...> <include layout="@layout/widget_view" ... /> <include layout="@layout/widget_list_item" android:theme="@style/Theme.Widget.ListItem.Preview1" /> <include layout="@layout/widget_list_item" android:theme="@style/Theme.Widget.ListItem.Preview2" /> </LinearLayout>