ב-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 אפשר לשפר את החוויה של בוחר הווידג'טים לשיפור האפליקציה על ידי הוספת תצוגות מקדימות דינמיות של ווידג'טים ותיאורי ווידג'טים. למידע נוסף, ראו הוספת תצוגות מקדימות של ווידג'טים שניתן לשנות את הגודל שלהם לבורר הווידג'טים והוספת תיאור לווידג'ט.
הפעלת מעברים חלקים יותר
החל מגרסה 12 של Android, מרכזי האפליקציות מספקים מעבר חלק יותר כשמשתמש מפעיל את האפליקציה שלכם מווידג'ט. ראו הפעלה חלקה יותר של המעברים.
שימוש בקולקציות RemoteViews פשוטות
ב-Android 12 נוספה השיטה setRemoteAdapter(int viewId, RemoteViews.RemoteCollectionItems items), שמאפשרת לאפליקציה להעביר אוסף ישירות כשמאכלסים ListView. בעבר, כשהשתמשתם ב-ListView, הייתם צריכים להטמיע ולהצהיר על RemoteViewsService כדי להחזיר את הערך RemoteViewsFactory.
פרטים נוספים זמינים במאמר שימוש באוספים של RemoteViews.
שימוש בשינוי זמן הריצה של RemoteViews
ב-Android 12 נוספו כמה שיטות RemoteViews שמאפשרות להפעיל זמן ריצה
שינוי של מאפייני RemoteViews. מידע נוסף על RemoteViews API
כדי לראות את הרשימה המלאה של השיטות שנוספו.
לפרטים נוספים אפשר לעיין בשימוש בשינוי זמן ריצה של
RemoteViews