注: 現在,プロジェクトで活動している開発者数は少なすぎる.したがって,開かれた問題すべてにすぐに答え,タグ付けすることはできませんが,私たちはそれを認識し読みます.良いバグレポートは重要なフィードバックを提供します.そのために感謝し,常に感謝します.

虫報告ガイド

このガイドには,ジャミで遭遇するバグや問題を報告するためのステップ・バイ・ステップ指示が含まれています.

環境を整え

  • データを失くする準備をしてください. アカウントをバックアップして,できるだけ多くのデバイスにリンクしてください.

  • 古いバージョンに対してバグ/問題報告はあまり役に立たないため,新しいバージョンでは既に修正されている可能性が高い.

虫を報告する方法

  1. [Jami GitLab]https://git.jami.net/users/sign_up]でアカウントを作成してください.

  2. 発行を投稿する適切なプロジェクトを選択してください

  • ゲート・プロジェクト ゲート・プロジェクト

  • Qtクライアント

  • GNOME/GTKクライアント (<gitlab-project}Qtクライアント <jami-client-qt>)

  • ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ

  • MacOSクライアント (<gitlab-project}Qtクライアント <jami-client-qt>)

  • 株式会社ジャミプロジェクト 一般 (または確信がない場合)

  • [あなたが何をしているのか知っているなら,他のプロジェクトの一つを選びます]

  1. 複数の問題がある場合は,別々のバグ報告を提出してください. その方法で追跡することがはるかに簡単になります.

  2. タイトルはバグの明示的な概要である (例:アイコンサイズによりヘッダバーが大きすぎる)

  3. バグを複製するための手順を計算します

  • 誤差報告を作成する際に 必要な手順を用意します.

  • 特定の手順 を 踏まえて 繰り返し 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み 読み

  • 問題を再現できない場合,合理的に解決できる可能性はほとんどない.報告した場合,その発生に関する可能な限り多くの情報/ヒントを提供するために最善を尽くしてください.

  1. ソフトウェアが最新であることを確認してください. 開発中のバージョンをテストして,バグが既に修正されているかどうかを確認してください.

  2. 環境から隔離して再現する (すなわち複数の装置でテスト) を試みる.

  3. 環境を記述する:

  • OS バージョン

  • 精密なデバイスモデル (モバイルデバイスにとって重要)

  • ベータ版を使用している場合

  • 作成した場合は,Jamiの正確なJami Daemonバージョンとクライアントバージョンを指定してください (Jami-vと jami-gnome-vまたは jami-v`を使用して取得できますが,私たちのパッケージがかなり頻繁に更新されていることに注意してください)

  • ネットワーク条件:両デバイスは同じローカルネットワークにあるのか? 異なるネットワークなのか? NATの裏にあるのか? LTEを使っているのか? WiFiを使っているのか?

  • 必要に応じて他の要素:SIPプロバイダー,ハードウェアなど

明確な要約を書くこと

開発者が見る最初の部分です. 開発者には,このバグが表示されるのは,

よい概要は,エラー 報告を迅速かつユニークに識別し,問題を説明すべきであり,提案された解決策ではない.

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"

複製するための正確なステップを書き出す

  • 開発者は コンピュータでバグを 作り出すことができるのか?

    複製する手順は,あらゆるバグレポートの最も重要な部分です.開発者がバグを複製できれば,バグが修正される可能性が高い.ステップが不明である場合,バグが修正されたかどうかを知ることは不可能かもしれません.一部のバグがあなたにとって明らかに見えるかもしれませんが,おそらくあなたの環境に関連していることがわかります.あなたがより正確にすれば,バグを修正できるほど速くなります.

  • 虫の報告に何を含めるべきか?

    誤差を任意に,偶発的に,あるいはまったく再現できるかどうか示してください.各ステップの意図に加えて,ジャミとのやり取りの方法を説明してください.あなたのステップの後,観察された (実際の) 結果と予想された結果を正確に記述してください.事実 (観察) を推測から明確に分離してください.

いいわ

私は常にこれらのステップに従って再生することができます:

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.

悪い

Try to transfer a file
It doesn't work.

達成 さ れ た 結果

記入してください

  • ジュミデモン (ジミドまたはリブジミまたはリブリング) とクライアントのデバッグログ.

  • 製造されたとしても 核廃棄物です

期待する結果

期待された行動や 望んだ行動の記述です

追加情報提供

フォローする情報は,ほとんどのバグ報告に求められます.期待される結果の下ではこの情報を提供することで時間を節約できます.

記録

QtベースのJamiクライアント (GNU/Linux,Windows,macOS)

障害解決セクションでは",ログを開く"をクリックして,統計 ("統計表示") を取得するか",ログを受け取る"を介して情報を記録し始めることができます.その後,結果をコピーして,シナリオを説明します.

GNU/Linux で

クラシックログ (デフォルトログでは >=警告のみが記録されます):

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

完全なログ: Jami クライアント (GUI) とデモンが分離されたプロセスであるため,両方のログを入手する最も簡単な方法は,手動で,一度に起動することです.

  1. チェックは `ps aux ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ

    • ジャミは窓が開かないとしても まだ走っているかもしれない あなたの好みに応じて.

    • ヽ kill PID` を使って終了します.

  2. ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ ヽ

    • この実行可能は通常は PATH でないし,Debian/Trisquel/Ubuntu パッケージでは, /usr/lib/x86_64-linux-gnu/jamid -d -c または /usr/libexec/jamid -d -c で位置している.

  3. 別の端末では,クライアントを起動し,例えば jami-gnome -dまたは jami -dを使用します.

プログラムを実行して GDB に戻る

gdb -ex run --args jami -d,または gdb -ex run jami-gnome,または gdb -ex run --args /usr/libexec/jamid -cd,デバッグする必要があるコンポーネントによって異なります.

クラッシュすると, bt (またはさらに良く, thread を bt をすべて適用) と入力して, Enter を押します.

macOS で

  • /Applications/Jami.app/Contents/MacOS/へ移動する.

  • ジャミをダブルクリックすると ジャミを起動し 端末へのログを印刷します

  • 端末からファイルにログをコピーする

ターミナルから /<パスがJami>/Jami.app/Contents/MacOS/Jami -d を実行できます.

Android で

ジャーミを本人に用いて電話で記録を収集する

  • 会話

  • 右上の3点メニューをタップします

  • ヽ 設定をタップする

  • `診断記録をタップする

Android デバッグブリッジ (adb) を使用してコンピュータを通じてログを収集するには:

  • アドビーを設定する必要があります

  • 智能手機でジャミを起動して実行します

  • ``` `

  • 顧客の記録を含むファイルが

窓口

端末 (cmd.exe) を開き,以下のオプションで Jami.exe を起動します.

  • -d ログを受け取るための別々のコンソールウィンドウを開く

  • -f %ローカルppdata%\jami\jami.log にログを書く