לוקליזציה

האינטגרציה כוללת תרגומים לכל השמות והמצבים של הישויות שנוצרו דרך מערכת התרגום הסטנדרטית של Home Assistant, המאוחסנים ב-custom_components/dreame_vacuum/translations/*.json. קבצים אלו משמשים גם כמילון בסיסי שהממשקים השונים משתמשים בו לטקסט שלהם בממשק.

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

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

הכללת תרגום

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

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

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

תרגומי ממשק קדמי

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