יצירת קיצורי דרך

כשמעצבים ויוצרים את קיצורי הדרך של האפליקציה, חשוב לפעול לפי ההנחיות הבאות:

הקפדה על הנחיות העיצוב

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

פרסום של ארבעה קיצורי דרך שונים בלבד

למרות שה-API תומך בשילוב של עד 15 קיצורי דרך סטטיים ודינמיים לאפליקציה, מומלץ לפרסם רק ארבעה קיצורי דרך שונים כדי לשפר את המראה שלהם בהפעלה.

בנוסף להצגת קיצורי דרך במפעיל האפליקציות, אפשר להשתמש בספריית השילוב של קיצורי הדרך של Google כדי להציג קיצורי דרך בפלטפורמות של Google, כמו Google Assistant. הספרייה הזו תומכת בדחיפה של מספר בלתי מוגבל של קיצורי דרך דינמיים. אם אתם משתמשים בספרייה הזו כדי להוסיף מספר גדול של קיצורי דרך, מומלץ להגדיר את rank של קיצורי הדרך שצריכים להופיע במרכזי אפליקציות נתמכים באמצעות קריאה לשיטה setRank().

הגבלת האורך של תיאור קיצור הדרך

השטח בתפריט שבו מוצגים קיצורי הדרך של האפליקציה במפעיל מוגבל. אם אפשר, כדאי להגביל את האורך של התיאור הקצר של קיצור הדרך ל-10 תווים, ואת האורך של התיאור הארוך ל-25 תווים.

מידע נוסף על תוויות לקיצורי דרך סטטיים זמין במאמר התאמה אישית של ערכי מאפיינים. למידע על קיצורי דרך דינמיים וקיצורי דרך שמוצמדים, אפשר לקרוא את מסמכי העזר בנושא setLongLabel() ו-setShortLabel().

שמירה של היסטוריית השימוש בקיצורי דרך ובפעולות

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

עדכון קיצורי דרך רק אם המשמעות שלהם נשמרת

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

• קיצורי דרך דינמיים: pushDynamicShortcut().

• קיצורי דרך מוצמדים: requestPinShortcut().

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

בדיקת קיצורי דרך דינמיים בכל הפעלה של האפליקציה

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