Watch Face Format

הערה: Watch Face Format נדרש כדי להתקין תצוגות שעון במכשירים עם Wear OS 5 ואילך שמותקנות מראש, ולכל תצוגות השעון החדשות שיפורסמו ב-Google Play.

החל מינואר 2026, תצוגות השעון יידרשו להיות בפורמט Watch Face Format כדי שיהיה אפשר להתקין אותן בכל מכשירי Wear OS.

במאמר הזה במרכז העזרה תוכלו לקרוא מידע נוסף על השינויים שמשפיעים על המשתמשים.

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

קהל

בעזרת הפורמט החדש של תצוגת השעון (WFF) קל יותר מתמיד ליצור תצוגת שעון. בשיתוף עם Samsung, השקנו את Watch Face Studio – כלי 'מה שרואים זה מה שמקבלים' שמאפשר לכם לעצב את תצוגת השעון ישירות.

אם אתם מעדיפים לנהל את הגדרות השעון באופן ידני, תוכלו גם להגדיר תצוגות שעון באמצעות XML. המדריכים האלה מיועדים למפתחים שמשתמשים ב-XML או שמפתחים כלים מותאמים אישית ליצירת תצוגות שעון באמצעות Watch Face Format. ב-Android Studio יש גם תמיכה ביצירה ובהרצה של תצוגות שעון שמשתמשות ב-Watch Face Format.

הפורמט Watch Face Format נוצר בשיתוף עם Samsung, והוא פורמט XML דקלרטיבי להגדרת המראה וההתנהגות של תצוגות השעון. בניגוד לממשקי API אחרים של תצוגות שעון, שבהם קובץ ה-APK חייב לכלול את הקוד לעיבוד תצוגת השעון, ב-Watch Face Format נדרשים רק משאבים והוראות מוצגות. פלטפורמת Wear OS מטפלת בלוגיקה הנדרשת לעיבוד תצוגת השעון, כך שתוכלו להתמקד ברעיונות היצירתיים שלכם ולא באופטימיזציה של הקוד או בביצועי הסוללה.

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

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

הלב של תצוגת שעון בפורמט Watch Face Format ‏ (WFF) הוא מסמך שמגדיר את הפריסה ואת ההתנהגות של תצוגת השעון. המסמך הזה נכתב ב-XML בהתאם למפרט WFF.

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

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

כדי לפרוס שעון בפורמט Watch Face במכשיר, צריך לארוז את מסמך ה-XML בחבילת AAB או APK רגילה.

בתרשים הבא מוצגת סקירה כללית של הגישה:

איך מערכת Wear OS מייצרת תצוגת שעון ממסמך XML בפורמט Watch Face Format.

ניהול גרסאות ב-WFF

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

לדוגמה, בגרסה 2 של WFF נוספה תמיכה במזג האוויר כמקור נתונים, שלא זמין בגרסה 1 של WFF.

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

כל גרסה של WFF תואמת לגרסה של Wear OS:

גרסת WFF הגרסה המינימלית של Wear OS רמת API מינימלית
1 4 33
2 5 34
3 5.1 35
4 6 36

כאן מוסבר איך להגדיר את קובץ ה-build של AndroidManifest.xml ו-Gradle בצורה נכונה.

מידע נוסף

מידע נוסף על Watch Face Format זמין במדריכים הבאים:

  • תכונות זמינות: כאן תוכלו לבדוק אילו יכולות של תצוגת השעון נתמכות בכל גרסה של Watch Face Format.
  • הנחיות לעיצוב: כאן תוכלו לקרוא על שיטות מומלצות לפריסה ולחוויית המשתמש של לוח השעון.
  • הגדרה: מגדירים Android App Bundle שתומך בפורמט של חזית השעון.
  • דוגמאות ב-GitHub: כדי להתחיל, יוצרים חזיתות שעון לדוגמה ופורסים אותן במהנת Wear OS או במכשיר הפיזי.
  • אופטימיזציה של השימוש בזיכרון: איך מגדירים את תצוגת השעון כך שהמערכת תצרוך כמה שפחות זיכרון כשהיא תיצור את תצוגת השעון.
  • חומר עזר בנושא XML: כאן תוכלו לקרוא על האלמנטים הנפרדים שמרכיבים קובץ Watch Face Format. רכיב הבסיס הוא תמיד WatchFace. הערה: כדי להציג תכונות מגרסה ספציפית של Watch Face Format במסמך העזרה בנושא XML, צריך לוודא שהלחצן המתאים לגרסה מסוימת מסומן בראש הדף.
  • מדריך לפרסום: כאן מוסבר איך מפרסמים את תצוגת השעון ומניבים ממנה הכנסות דרך חנות Play ושיטות חלופיות.
  • כלי לאימות WFF וזיכרון: בעזרת הכלים האלה בקוד פתוח תוכלו לבדוק אם יש שגיאות בקובץ בפורמט Watch Face Format, ולאשר את השימוש הנדרש בזיכרון לפני שליחת הקובץ ל-Google Play.