המשתמשים יכולים להגדיר ווידג'טים של אפליקציות

אפשר להגדיר את הווידג'טים של האפליקציות. לדוגמה, בווידג'ט של שעון אפשר לאפשר למשתמשים להגדיר את אזור הזמן שיוצג.

אם רוצים לאפשר למשתמשים להגדיר את ההגדרות של הווידג'ט, צריך ליצור הגדרת ווידג'ט Activity.

הצהרה על פעילות ההגדרה

ההצהרה על פעילות ההגדרה במניפסט והקישור שלה בתוך המטא-נתונים של ספק ה-XML זהים גם בווידג'טים של אפליקציות שמבוססים על Views וגם בווידג'טים של אפליקציות שמבוססים על Glance.

כדי ללמוד איך להצהיר על פעילות ההגדרה, אפשר לעיין בסעיף ההצהרה על פעילות ההגדרה במסמכי התיעוד של הגדרת Glance.

הטמעה של פעילות ההגדרה

פעילויות ההגדרה הן רכיבים סטנדרטיים שהפלטפורמה מפעילה, ולכן הקריאות החוזרות הבסיסיות שלהן למחזור החיים צריכות לפעול לפי כללי ערך ההחזרה של המערכת.

כדי ללמוד איך להטמיע פעילות הגדרה, אפשר לעיין בקטע Implement the configuration activity (הטמעה של פעילות ההגדרה) במסמכי התיעוד של Glance.

עדכון הווידג'ט מפעילות ההגדרה

בווידג'טים מסורתיים שמבוססים על Views, מעדכנים את הווידג'ט אחרי השלמת ההגדרה באמצעות AppWidgetManager ופריסת RemoteViews.

אם אתם יוצרים ווידג'ט מבוסס-Views מדור קודם וצריכים לעדכן את פריסת RemoteViews, תוכלו להיעזר בקוד לדוגמה של עדכון Views ב-GitHub. לגבי ווידג'טים מודרניים שנוצרו באמצעות Compose, אפשר לעיין בעדכון מהקטע 'פעילות ההגדרה' במסמכי התיעוד של Glance.

אפשרויות להגדרת הווידג'ט

התנהגויות של ווידג'טים (כמו אפשרות להגדיר מחדש מאוחר יותר או לדלג על השלבים הראשוניים של הגדרת ההגדרות) נרשמות בתוך מאפייני מטא-נתונים באמצעות דגלים סטנדרטיים של Android 12.

כדי ללמוד איך להשתמש באפשרויות דינמיות של הווידג'ט, אפשר לעיין בקטע אפשרויות להגדרת הווידג'ט במאמר בנושא הגדרת Glance.

המשתמשים יכולים להגדיר מחדש ווידג'טים שהוצבו

כדי להבין איך מוסיפים טריגרים מותאמים אישית להגדרה מחדש, אפשר לעיין בקטע Enable users to reconfigure placed widgets (איך מאפשרים למשתמשים להגדיר מחדש ווידג'טים שהוצבו) בתיעוד של Glance.

שימוש בהגדרת ברירת המחדל של הווידג'ט

בקטע Use the widget's default configuration בתיעוד של Glance מוסבר איך לדלג על הגדרות ברירת המחדל.