דיווח על תקלות

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

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

שלב 1: לשדרג לגרסה העדכנית ביותר

נא לשדרג לגרסאות העדכניות ביותר שיצאו לאור של Kdenlive. אנחנו לא עונים על דיווחי תקלות לגרסאות ישנות של Kdenlive (אלא אם כן עדיין ניתן לשחזר אותן בגרסה העדכנית ביותר).

שלב 2: לחפש בתיעוד הרשמי Kdenlive

‏RTFM - „נא לקרוא את המדריך המשובח” (באנגלית: „Read The Fine Manual”) הוא ביטוי שלרוב נועד ללעוג למשתמשים ששואלים שאלות שמופיעות בצורה די ברור בתיעוד. כיום כשהכול זמין במדריכים ב־YouTube זה כנראה לא תקף יותר, אבל אכן מומלץ לגשת לתיעוד הרשמי של Kdenlive. אפשר לחפש בו ויש בו עושר בלתי נדלה של מידע איכותי ובעל ערך.

שלב 3: לחפש בפורומים

ל־Kdenlive יש קהילה גדולה שפעילה בפורום ובחדרי שיחות. כדאי לפנות למגוון מקורות כדי לראות אם משתמשים נתקלו באותה הבעיה. אולי יש תיקון או דרך מעקף:

• הפורום הרשמי
• הסאברדיט r/kdenlive
• דיסקורד
• טלגרם
• מסטודון

שלב 4: לבדוק בנושאים הפתוחים

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

• REPORTED (מדווח) היא תקלה שדווחה אך לא קרה איתה עדיין משהו. יכול להיות שיש דיונים לגביה, לכן שווה לבדוק אם הם תקפים לבעיה שחווית.
• NEEDSINFO (דרוש מידע נוסף) היא תקלה מדווחת שדורשת משוב נוסף, כלומר, מישהו או מישהי מצוות הפיתוח עיין בה אבל ראו צורך בפירוט נוסף
• CONFIRMED (עבר אישור) משמעותו שאפשר לייצר את התקלה מחדש (או על ידי משתמשים אחרים או על ידי צוות הפיתוח)
• ASSIGNED (הוקצה) משמעותו שמפתח או מפתחת מטפלים בתקלה
• RESOLVED (נפתר) משמעותו שהתקלה נפתרה בגרסת הפיתוח

שלב 5: לדווח על התקלה

אם נתקלת בקריסה בעלייה של Kdenlive או בעת הניסיון לנגן קובץ וידאו, נא לפעול לפי השלבים הבאים:

1. אם הידרת את Kdenlive ו/או את MLT בעצמך, נא לוודא שפעלת לפי השלבים שמתוארים בהנחיות שלנו.
2. נא לבדוק שלא מותקנות אצלך מספר גרסאות שונות של MLT
3. כדאי לנסות לנגן את קובץ הווידאו שלך עם הנגן של FFmpeg. מחלונית מסוף: ffplay myvideo.mpg
4. כדאי לנסות לנגן את קובץ הווידאו שלך עם הנגן של MLT. מחלונית מסוף: melt myvideo.mpg

יש לצרף את התוצאות לדיווח התקלה שלך כקבצים.

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

• גרסת ה־Kdenlive וה־MLT שלך. אפשר להעתיק את הפרטים האלה מתפריט Kdenlive > עזרה > על אודות.
• מערכת ההפעלה שלך (OS), כגון Windows, הפצת לינוקס או MacOS לרבות הגרסה המותקנת
• שיטת ההתקנה של Kdenlive, כגון התקנה או חבילה עצמאית ב־Windows, או flatpak/snap/ppa או appimage בלינוקס
• צעדים מפורטים להפקת התקלה מחדש. צילומי והקלטות מסך מאוד שימושיים להגעה לתקלה מחדש.
• הודעות שגיאה או קובצי יומן כלשהם שניתן לספק. בבקשה לא להעתיק ולהדביק את תוכן היומן לדוח התקלה אלא לצרף אותו כקובץ.
• אם התקלה מקריסה של Kdenlive, יש לספק מעקב קריאות (backtrace).

איך לקבל פרטים שימושיים על הקריסה (מעקב קריאות/backtrace)

מעקב אירועים (backtrace) מכיל מידע רב ערך לצוות הפיתוח. הוא דורש קצת ידע בהגדרות ייעודית למערכת ההפעלה ושורת הפקודות ולכן יכול להיות שלא כולם יוכלו לגשת לזה באותו האופן.

AppImage של לינוקס

נא להתקין את החבילות הבאות: gdb,‏ kdenlive-dbg,‏ libmlt-dbg (שמות החבילות עלולים להיות שונים כתלות בהפצה שלך)

לאחר קריסת Kdenlive, אם חלונית הטיפול בקריסות של KDE קופצת, אפשר להעתיק את הנתונים שהיא מספקת. אם לא, יש להפעיל את Kdenlive ממסוף באופן הבא:

1. יש להקליד gdb kdenlive
2. לאחרי ש־gdb קרא את סמלי ניפוי השגיאות, יש להקליד run

Flatpak בלינוקס

קודם כל יש לוודא שסמלי ניפוי השגיאות של Flatpak מותקנים על ידי הקלדת flatpak install org.kde.kdenlive.Debug בשורת הפקודה.

עכשיו אפשר להפעיל את ה־Flatpak משורת הפקודות כך:

1. אפשר להפעיל מטעפת בתוך הסביבה המבודדת של ה־Flatpak של Kdenlive: flatpak run --command=sh --devel org.kde.kdenlive
2. יש להקליד gdb /app/bin/kdenlive
3. לאחרי ש־gdb קרא את סמלי ניפוי השגיאות, יש להקליד run

כאן אפשר למצוע מידע נוסף על ניפוי תקלות ב־Flatpak:‏ https://docs.flatpak.org/en/latest/debugging.html

Windows

1. בניית Kdenlive עם KDE Craft מקומית מתוארת כאן.
2. להקליד בשורת הפקודות cd C:/CraftRoot/mingw64/bin
3. להפעיל את gdb עם gdb
4. להפעיל את Kdenlive -> לתעד את מזהה התהליך (PID)
5. attach 3288 (להחליף את 3288 במזהה התהליך/PID שתיעדת)
6. להמתין לשורת הבקשות (gdb)
7. להקליד c

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

thread apply all bt full

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