דיווח על באגים ותכונות

כל דיווחי באגים, בקשות תכונות ודיונים הולכים ל- מאגר ה-GitHub של האינטגרציה.

בדוק עדכונים

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

בדוק את השאלות הנפוצות קודם

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

פתח בעיה ב-GitHub

בקשת תכונה

רעיונות חדשים לשיפורים ותכונות תמיד מתקבלים בברכה.

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

בקשת תמיכה בדגם חדש אופציונלי

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

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

• גרסת Home Assistant
• מספר דגם המכשיר
• יומן מכשיר לא נתמך (יש לחלץ זאת מתוך יומני Home Assistant ולספק בפריט)

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

שאלת שאלה

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

דיווח על באג

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

• שם הדגם (למשל, dreame.vacuum.p2028)
• גרסת הקושחה (למשל, 1156)
• גרסת Home Assistant
• סוג תצורה
• שגיאות או אזהרות מהרשומות של Home Assistant (אם רלוונטי)

קבל יומני דיבוג

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

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

הגן על נתונים רגישים

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