ב-Android 12 (רמת API 31) יש שינוי של Widgets API הקיים כדי לשפר את חוויית המשתמש והמפתח בפלטפורמה ובמרכזי האפליקציות. המדריך הזה מסביר איך לוודא שהווידג'ט תואם ל-Android 12, וכולל גם חומר עזר בנושא ממשקי API לרענון הווידג'ט הקיים.
מוודאים שהווידג'ט תואם ל-Android 12
לווידג'טים ב-Android 12 יש פינות מעוגלות. כשמשתמשים בווידג'ט של אפליקציה במכשיר עם Android גרסה 12 ואילך, מרכז האפליקציות מזהה באופן אוטומטי את הרקע של הווידג'ט וחותך אותו כך שיהיו לו פינות מעוגלות.
במקרה כזה, יכול להיות שהווידג'ט לא יוצג כמו שצריך אם מתקיים אחד מהתנאים הבאים:
הווידג'ט מכיל תוכן בפינות: יכול להיות שחלק מהתוכן בפינות ייחתך.
הווידג'ט משתמש ברקע שלא מושפע מחיתוך. זה כולל רקע שקוף, תצוגות או פריסות ריקות, או כל סוג אחר של רקע מיוחד שלא נוטה להיחתך. יכול להיות שהמערכת לא תצליח לזהות את הרקע הנכון.
אם הווידג'ט שלכם יושפע מהשינוי הזה, מומלץ לרענן אותו עם פינות מעוגלות (כפי שמתואר בסעיף הבא) כדי לוודא שהוא מוצג כמו שצריך.
שימוש בדוגמה
כדי לראות את כל ממשקי ה-API האלה בפעולה, אפשר לעיין בווידג'ט לדוגמה של רשימה.
הטמעת פינות מעוגלות
ב-Android 12 נוספו הפרמטרים system_app_widget_background_radius ו-system_app_widget_inner_radius של המערכת, שמאפשרים להגדיר את הרדיוס של הפינות המעוגלות של הווידג'ט.
1 פינת הווידג'ט.
2 פינה של תצוגה בתוך הווידג'ט.
פרטים נוספים זמינים במאמר הטמעת פינות מעוגלות.
הוספת עיצוב למכשיר
החל מ-Android 12, אפשר להשתמש בווידג'ט בצבעים של עיצוב המכשיר ללחצנים, לרקעים ולרכיבים אחרים, כולל עיצובים בהירים וכהים. כך המעברים בין הווידג'טים השונים חלקים ועקביים יותר.
מידע נוסף זמין במאמר הוספת עיצוב למכשיר.
התאמה אישית קלה יותר של ווידג'טים
אם מציינים פעילות הגדרה באמצעות המאפיין configure של appwidget-provider, המארח של ווידג'ט האפליקציה מפעיל את הפעילות הזו מיד אחרי שהמשתמש מוסיף את הווידג'ט למסך הבית.
ב-Android 12 יש אפשרויות חדשות שמאפשרות לכם לספק למשתמשים חוויית הגדרה טובה יותר. פרטים נוספים זמינים במאמר איך מאפשרים למשתמשים להגדיר ווידג'טים.
הוספת כפתורים משולבים חדשים
ב-Android 12 נוספה תמיכה חדשה בהתנהגות עם שמירת מצב באמצעות הרכיבים הקיימים הבאים:
הווידג'ט עדיין בלי שמירת מצב. האפליקציה צריכה לאחסן את המצב ולהירשם לאירועים של שינוי מצב.
פרטים נוספים זמינים במאמר תמיכה בהתנהגות עם שמירת מצב.
שימוש בממשקי API משופרים לגדלים ולפריסות של ווידג'טים
החל מ-Android 12, אתם יכולים להשתמש במאפייני גודל מעודנים יותר ובפריסות גמישות יותר, על ידי ציון אילוצים נוספים לגבי גודל הווידג'ט ועל ידי מתן פריסות רספונסיביות ופריסות מדויקות.
פרטים נוספים זמינים במאמר הוספת פריסות גמישות לווידג'טים.
איך לשפר את חוויית השימוש בבורר הווידג'טים באפליקציה
ב-Android 12 אפשר לשפר את חוויית השימוש בכלי לבחירת הווידג'טים באפליקציה, על ידי הוספת תצוגות מקדימות דינמיות ותיאורים של הווידג'טים. פרטים נוספים זמינים במאמרים הוספת תצוגות מקדימות של ווידג'טים שניתנים להתאמה לבורר הווידג'טים והוספת תיאור לווידג'ט.
הפעלת מעברים חלקים יותר
החל מ-Android 12, מרכזי האפליקציות מספקים מעבר חלק יותר כשהמשתמש מפעיל את האפליקציה מווידג'ט. פרטים נוספים מופיעים בקטע הפעלת מעברים חלקים יותר.
שימוש באוספים פשוטים של RemoteViews
ב-Android 12 נוספה השיטה setRemoteAdapter(int viewId, RemoteViews.RemoteCollectionItems items), שמאפשרת לאפליקציה להעביר אוסף ישירות בזמן האכלוס של ListView. בעבר, כשמשתמשים ב-ListView, היה צריך להטמיע ולהצהיר על RemoteViewsService כדי להחזיר את RemoteViewsFactory.
פרטים נוספים זמינים במאמר שימוש באוספים של RemoteViews.
שימוש בשינוי בזמן ריצה של RemoteViews
ב-Android 12 נוספו כמה שיטות של RemoteViews שמאפשרות לשנות את המאפיינים של RemoteViews בזמן הריצה. הרשימה המלאה של השיטות שנוספו מופיעה במאמרי העזרה של ה-API של RemoteViews.
פרטים נוספים זמינים במאמר שימוש בשינוי בזמן ריצה של RemoteViews.