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

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

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

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

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

כדי ללמוד איך להצהיר על פעילות ההגדרה, אפשר לעיין בסעיף בנושא הצהרה על פעילות ההגדרה במסמכי התיעוד של הגדרת 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.

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

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