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 בזמן ריצה. רשימה מלאה של השיטות שנוספו מופיעה בRemoteViewsמאמרי העזרה של ה-API.
פרטים נוספים מופיעים במאמר בנושא שימוש בשינוי בזמן ריצה של RemoteViews.