חשוב

We are currently a small number of developers active on the project. As such, we cannot answer and tag all of the opened issues immediately, but we do notice and read them. Good bug reports provide us important feedback, which we thank you for and always appreciate.

מדריך דו“ח חרקים

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

תארגן את הסביבה שלך

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

איך לדווח על תבוך

ליצור חשבון ב [Jami GitLab]https://git.jami.net/users/sign_up) אם אין לך כבר אחד.
בחר את הפרויקט הנכון לפרסם את הנושא שלך:
- {gitlab-פרויקט}הלקוח אנדרואיד <jami-client-android>
- {gitlab-project}`הלקוח Qt
- {gitlab-project}`הלקוח של iOS
- לקלינט macOS (מפוגנת על ידי לקלינט Qt)
- {gitlab-project}`הפרויקט ג’מי בכלל (או אם אתה לא בטוח)
- [אם אתה יודע מה אתה עושה אתה יכול לבחור אחד מהפרויקטים האחרים]
אם יש לך בעיות רבות, בבקשה תגיש דוחות טעויות נפרדות. יהיה הרבה יותר קל לעקוב אחריהם בדרך זו.
הכותרת היא סיכום מפורש של הטעות (למשל: חוט העותר גדול מדי בגלל גודל האייקון)
תחשבו על הצעדים כדי להפיק את החייד:
- אם יש לך צעדים מדויקים כדי להפיק אותו (יפים!) אתה בדרך שלך ליצור דו“ח שגיאה שימושי.
- אם אתה יכול להפיק מספרים מדי פעם, אבל לא לאחר שנעשו צעדים ספציפיים, אנא תציע מידע נוסף על הנושא כדי לעזור לאחרים להבין ולנסות להפיק מספרים.
- If you can not reproduce the problem, there may be little chance of it being reasonably fixable. If you do report it, please try your best to provide as much information/clues about its occurrence as possible.
בדוק אם התוכנה שלך עדכנית. אידיאלית, בדוק גרסה מתפתחות כדי לראות אם הטעות שלך כבר תיקנה.
נסה להתבודד מהסביבה ולהתרבות (כלומר, בדיקת על מכשירים רבים).
תיאר את הסביבה שלך (s) על ידי תיאור הדברים הבאים:
- גרסה של מערכת ההישג
- מודל המכשיר המדויק (חשוב עבור מכשירים ניידים)
- אם אתה משתמש בגרסה בטה
- what build you are using (F-Droid, Play Store, App Store, from dl.jami.net, your own build, etc.). If you have built your own version of Jami, please specify the exact Jami Daemon version and client version (you can obtain it using jamid -v and jami -v; but note that our packages are updated quite often) and the Git commit.
- network conditions:
  - are both devices on the same local network?
  - Different networks?
  - Is one or both behind NAT?
  - Are you using LTE?
  - Are you using WiFi?
- other elements if needed:
  - SIP provider,
  - hardware,
  - etc.

כתיבת סיכום ברור

איך היית מתאר את הטעות באמצעות כ-10 מילים? זהו החלק הראשון של דו“ח הטעות שלך יראה מפעיל.

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

Good: "Cancelling a file transfer crashes Jami"
Bad: "Software crashes"

Good: "All calls hang up after 32 seconds"
Bad: "Not able to call my friends"

כתיבת צעדים מדויקים כדי להשיב

איך מתכנן יכול להפיק את החולצה במכשיר שלו?

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

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

Good

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

1. Start Jami by clicking on the desktop icon
2. Start a new conversation with anyone
3. Click the file transfer icon

Expected results: A window opens and asks me to choose a file to send.
Actual results: When I click the file transfer icon, nothing happens.

Bad

Try to transfer a file.
It doesn't work.

תוצאה

אנא הוסף:

הדיימון של ג’מי (ג’מיד או ליבג’י או לירות) ושישורי תיקון לקלינט.
המזבלה הליבה אם יצרו אחד.

תוצאה צפויה

זה תיאור של התנהגות צפויה או רצויה.

מסירת מידע נוסף

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

חתיכות

קלינט ג’אמי מבוסס Qt (GNU/Linux, Windows, macOS)

Go to the General settings. In the Troubleshoot section, you can click on ”Open logs“, where you will be able to get statistics (”Show stats“) or start recording information via ”Receive logs“. Then you can just copy the result and explain your scenario.

ב- GNU/Linux

שיטות קלאסיות (בדרך כלל שיטות אזהרה >= בלבד נדווגות):

journalctl --since "24h ago" | grep jami

Full log: The Jami client (GUI) and daemon are separate processes. To obtain logs from both processes, start each process manually, one at a time.

לוודא שאין לקוח ג’מי או דיימון מדוגמת פועלות: לבדוק על ידי לנהל `ps aux ‬
- ג’מי אולי עדיין פועלת גם אם חלונות לא פתוחים, בהתאם לעדפותיך.
- אם כל אחד מהלקוחות או הדיימון פועלים, לסיים אותם באמצעות kill PID.
באחד הטרמינלים, להתחיל את הדיימון עם jamid -d -c
- זה ניתן לבצע בדרך כלל לא ב- PATH, ובחבילות Debian/Trisquel/Ubuntu, הוא ממוקם ב- /usr/lib/x86_64-linux-gnu/jamid -d -c או /usr/libexec/jamid -d -c.
In another terminal, start the client, using jami -d.

כדי לקבל עקבות אחורה, אתה יכול להפעיל את התוכנית בתוך GDB:

gdb -ex run --args jami -d, or gdb -ex run --args /usr/libexec/jamid -cd, depending on the component you need to debug.

כאשר זה מתנגש, אתה יכול להקליד bt (או אפילו יותר טוב, thread ליישם את כל bt) ואז לחץ על Enter.

ב macOS

לכו ל- /Applications/Jami.app/Contents/MacOS/.
לחץ פעמיים על ג’מי, זה יפעיל את ג’מי וידפיס את היומן לתרמיל.
עותק את היומן מהטרמונל לקובץ.

באופן חלופי, אתה יכול לנהל /<דרך לג'מי>/ג'מי.אפ/תוכן/מקרוס/ג'מי -ד מהטרמונל.

באנדרואיד

כדי לאסוף רשומות באמצעות הטלפון שלך באמצעות ג’מי עצמו:

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

כדי לאסוף רשומות באמצעות המחשב שלך באמצעות גשר הגירוי של אנדרואיד (adb):

אתה צריך להקים AdB במחשב שלך.
תפעיל את ג’מי על הטלפון החכם שלך ואז תוציאו להורג
```db logcat *:D ♬ grep db shell ps ♬ egrep 'cx.ring' ♬ חתוך -c10-15d > logring.txt``
יש לך עכשיו קבוצה המכילה את היומן של הלקוח

עבור חלונות

פתח טערמינל (cmd.exe) ופתח Jami.exe עם האפשרויות הבאות:

-d לפתוח חלון קונסול נפרד לקבלת רשומות
-f לכתוב רישומים ל % lokappdata%\jami\jami.log