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.