バグ、機能と既知問題

QGISは主にボランティアにより運営されるプロジェクトで、開発者は、文書作成、翻訳者や支持者の専門チームの仕事です。チームではバグのないQGISをリリースしようと努力しておりますが、それでもバグが残っているかもしれません。バグを見つけたり新しい機能を追加したい場合は、ぜひご報告ください!

どこに報告?

QGISプロジェクトの各部分について、問題(機能要求やバグ)を報告、管理、および議論できる専用の場所があります。問題に遭遇した分野に応じて、以下の表はそれを報告するための正しいリポジトリを示しています:

バグを見つけた場所、または次の機能を要求した場所

問題を報告する場所

アプリケーション(QGISデスクトップ、QGISサーバー)

https://github.com/qgis/QGIS/issues

QGIS ウェブサイト(https://qgis.org)

https://github.com/qgis/QGIS-Website/issues

QGIS文書(https://docs.qgis.org)

https://github.com/qgis/QGIS-Documentation/issues

C++ API (https://qgis.org/api)

https://github.com/qgis/QGIS/issues

PyQGIS API (https://qgis.org/pyqgis)

https://github.com/qgis/QGIS/issues (内容について)および https://github.com/qgis/pyqgis/issues (形式について)

外部プラグイン

プラグインの説明で設定された著者リポジトリ

ヘルプや質問については QGISメーリングリスト にご連絡ください。

QGISのアプリケーション上の問題を報告

QGISアプリケーション(QGISデスクトップおよびQGISサーバー)の問題は、 Github で入手できます。レポートを送信またはコメントするには、登録してログインする必要があります。

問題を報告する前に

問題を提出する前に、現在サポートされているバージョン 3.34.5 または 3.36.1 または開発バージョン 3.37 を実行していることを確認し( リリースのスケジュール も参照)、現在オープンな問題を見直して重複しないようにしてください。問題に関する追加情報がある場合は、既存のチケットに追加することができます。サードパーティのプラグインが問題を引き起こすこともあります。 インストールされている場合は、そのプラグインがなくても問題が再現できるかどうかも確認する必要があります。 1つのバグレポートで、複数の無関係なバグを報告しないでください。

ログインしていると、新規発行 ボタンが表示されます。それを選択し、その指示に従ってください。

レポートを送信する前に、「プレビュー」をクリックして、レポートの書式設定を確認してください。誤植がないかぎり既存のレポートの編集は避けてください。その他のどんな場合も、さらにコメントを追加するとより良い。

バックトレースを作成する

クラッシュする場合は、そのバグを別のマシン上で再現できないかもしれないので、バックトレースを含めることが有益であるかもしれません。

LinuxではQGIS上で自動的にバックトレースを生成するためにクラッシュしたプロセスに接続するために gdb を使用しようとします。しかし、いくつかのディストリビューションでは、実行中のプロセスにデバッガを接続する可能性を無効化します。その場合には gdb のようなかなり役に立たないメッセージが作成されるだけです:

QGIS died on signal 11Could not attach to process.
If your uid matches the uid of the target process,
check the setting of /proc/sys/kernel/yama/ptrace_scope, or try
again as the root user.
For more details, see /etc/sysctl.d/10-ptrace.conf
ptrace: Operation not permitted.
No thread selected
No stack.
gdb returned 0
Aborted (core dumped)

その場合、 /etc/sysctl.d/10-ptrace.conf (または /etc/sysctl.conf または /etc/sysctl.d/ 中の何か他のファイル) 中の kernel.yama.ptrace_scope を0に設定し、rootとして sysctl -p を実行することで、そのオプションを再度有効にする必要があります。その後クラッシュを再現すると、バックトレースが代わりに印刷されます。

クラッシュを再現できない場合でも、現在のディレクトリにコア・ダンプがあるはずで、それはプロセスがすでに終了した後に分析できます。それは core と呼ばれています(ドットとプロセスIDがファイル名に追加されるシステムもある)。

いくつかのディストリビューションではコアダンプの作成も無効にされています。その場合はクラッシュが発生したときに Aborted (core dumped) 中止(コアダンプが作成されました) でなく Aborted 中止 とだけ出ます。そのときはQGISを起動する前に ulimit -c unlimited を実行する必要があります。ログインしたときにそれが常に有効になっているように、 .profile 中に入れておくこともできます。

コアファイルからバックトレースを生成するには gdb /path/to/the/qgis/binary core を開始します。バイナリは、通常GRASSプラグインのインストールされたDebianの /usr/bin/qgis または /usr/bin/qgis.bin にあります。 gdb では bt を実行しバックトレースを生成します。

Windows上でのログ出力

OSGeo4W_でのナイトリービルド(パッケージQGIS-dev)はDebugView_で見ることができ、デバッグ出力で構築されています。問題を再現することが容易でない場合、この出力がQGISがクラッシュした場所についての何らかの手掛かりになることがあります。

QGISウェブサイトやマニュアルの問題点を報告

QGISプロジェクトでは活発な ウェブサイト と豊かな 文書 を提供しています。私たちの努力にもかかわらず、古くなった情報や間違ったり不明瞭な文を見つけたとき、貴重な情報がないときは、お気軽にご報告ください。

これらの文書の主なソースはGitHubのリポジトリでホストされ、管理されています。ですからバグを報告したり、パッチを提出するためには、GitHubのアカウントとログインが必要です。

開始するには、まず、 GitHubのアカウントを作成

その後、適切なリポジトリを選択します。

報告したい問題がすでに入力されていないか確認してください。

新しい問題 をクリックして、問題についてタイトルおよび明確な説明を入力します。

設定が完了したら、新しい問題を提出 をクリックしてください。

注釈

このページを修正 リンクがウェブサイトのどのページの下部にも設けられており、直接このページを改善してプルリクエストを送信するために役立ちます。

このオプションは、ドキュメントのフッターにも使用可能です。

プラグインの問題を報告する

QGISのプラグインのほとんどは、公式の QGISプラグインリポジトリ に掲載されています。それらに関連するバグや機能リクエストはそれぞれのバグトラッキングシステムで開か なければなりません

  • QGISレポジトリで利用可能なプラグインに関しては、そのメタデータの中にそのバグトラッカーへのリンクがあります。それ以外の場合は、プラグインのマニュアルを参照して、関連するバグ追跡システムのアドレスまたは開発者に連絡してください。

    情報がない場合は、 開発者メーリングリスト に報告してください。

  • 他のプラグインについては、そのような情報が提供されることを保証する手段はありません。

QGISプロジェクトにパッチを提出する

問題の報告に加えて、問題の解決を助けることもできます。問題を修正することはプルリクエストを通じてGitHubの中で行われます。貢献したい リポジトリをフォーク する必要があります、以下でプルリクエストを提出します:

パッチやプルリクエストをQGISプロジェクトに簡単に取り込むためのガイドラインは、Submitting Pull Requests に記載されています。また、より広く、開発プロセス の章を読む必要があるかもしれません。