לוקליזציה

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

הכרטיס שולף את ערכי הטקסט המקומיים מהקטע entity_component בתוך dreame_vacuum קבצי תרגום לאינטגרציה.

מפתחות תרגום

בתוך קבצי השפה, הכרטיס משתמש בעיקר בכמה קטגוריות מפתחות שמתחילות ב-frontend_ כדי להציג את הממשק שלו:

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

• frontend_config: קטע זה מכיל את כל התוויות, התיאורים וההגדרות המשמשים בתוך ממשק הכרטיס הויזואלי.

• frontend_message: מכיל הודעות סטטוס, התראות, דוחות שגיאה ואזהרות שמוצגות בכרטיס.

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

• entity: בלוק זה עוסק בדומיינים של ישויות Home Assistant כגון select, sensor, switch, number, time ו-input. הכרטיס מושך באופן דינמי את השמות והמצבים של ישויות אלו, כגון רמת יניקה או שקט, ישירות מהאינטגרציה כדי להבטיח עקביות.

  • מצבים ייחודיים לכרטיס: מספק תרגומים למצבים פנימיים המשמשים אך ורק בממשק המשתמש של הכרטיס ולא בישויות Home Assistant. זה כולל שמות חדרים (שהם נגזרים מהישות segment_name), יחד עם מזהים ספציפיים כמו task_type, edit_type, map_type, object_type, furniture_type, obstacle_type, obstacle_reason, task_end_type, task_interrupt_reason, startup_method, cleanup_method ו-recovery_map_type.

עיצוב תאריכים, שעות ויחידות

בנוסף לתרגומי טקסט, הכרטיס מתאים אוטומטית להעדפות עיצוב מקומיות ללא צורך בהגדרה ידנית:

• שפה ומיקום: הכרטיס נותן עדיפות לשפה שנבחרה בפרופיל Home Assistant. אם לא נבחרה שפה שם באופן מפורש, הוא חוזר אוטומטית לשפת ברירת המחדל של דפדפן האינטרנט.
• פורמט זמן 12/24 שעות: הכרטיס מכבד את פורמט הזמן שהוגדר בפרופיל ה-Home Assistant. אם לא צויין, הוא מאמץ אוטומטית את פורמט הזמן הסטנדרטי של האזור שבו נמצא המכשיר.
• יום ראשון בשבוע: הכרטיס קורא את הגדרת היום הראשון בשבוע ישירות מ-Home Assistant. אם לא הוגדרה, הוא קובע באופן דינמי האם לוח השנה יתחיל ביום ראשון או ביום שני בהתאם לאזור המקומי.
• מערכת יחידות: הכרטיס בודק באופן רציף את ההגדרות הגלובליות של Home Assistant. אם המערכת משתמשת במערכת היחידות האימפריאלית, הכרטיס מחדש באופן אוטומטי את חישובי השטח והמרחקים, ומציג אותם באופן טבעי ברגליים, רגל מרובעת, או יארד.
• תרגומי יחידות מקור: סיומות וקיצורים נפוצים ליחידות, כגון מטר, קילומטר, רגל, יארד, דקה ו-שעה, אינם דורשים תרגום ידני. הכרטיס מתרגם אותם בזמן אמת באמצעות תכונות מובנות בדפדפן המותאמות במיוחד לשפה הפעילה.

תקן או שפר תרגומים

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

הכללת תרגום

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

תהליך העדכון כולל את השלבים הבאים:

1. פקע את המאגר: פקיעת מאגר האינטגרציה של Dreame Vacuum Home Assistant ב-GitHub.
2. מצא את קובץ התרגום: ניווט לתיקייה custom_components/dreame_vacuum/translations/ במאגר המפוצל כדי לאתר את קובץ התרגום שתואם לקוד השפה, כמו de.json או it.json.
3. בצע את השינויים: עדכון הטקסט השגוי. הבלוקים frontend_action, frontend_config, frontend_message ו-frontend_title מנהלים טקסט הקשור לממשק המשתמש. הבלוק entity מנהל שמות חיישנים, אפשרויות בחירה ומצבים שלהם.
4. שלח בקשת משיכה: פתיחת בקשת משיכה למאגר הראשי. לאחר שבקשת המשיכה נבדקה ומוזגה לגרסה חדשה של האינטגרציה, כרטיס Dreame Vacuum מקבל אוטומטית את התרגומים המעודכנים.