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

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

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

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

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

כדי ללמוד איך להצהיר על פעילות ההגדרה, אפשר לעיין בקטע הצהרה על פעילות ההגדרה ב-Compose-first במסמכי התיעוד של הגדרת Glance.

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

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

כדי ללמוד איך להטמיע פעילות הגדרה, עיינו בקטע הטמעת פעילות ההגדרה ב-Compose-first במסמכי התיעוד של Glance.

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

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

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

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

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

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

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

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

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

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