テスト
テストの処理に関する環境設定を行うには、環境設定>Testing >General に進みます。
次の表は、一般的なテストの環境設定をまとめたものです。
| 設定 | 設定値 |
|---|---|
| Scan threads | テストのスキャン時に使用するワーカースレッドの量を設定します。デフォルトでは、Qt Creator が使用可能な論理 CPU の 1/4 を使用します。 |
| Omit internal messages | 内部メッセージを省略する。 |
| Omit run configuration warnings | 推論された構成に対する実行構成の警告を省略する。 |
| Limit result output | デフォルトでは、テスト結果出力は最大100,000文字を表示します。 |
| Limit result description | テスト結果のツールチップと説明の最大行数を設定します。 |
| Open results when tests start | テスト開始時にテスト結果を自動的に表示する。 |
| Open results when tests finish | テスト終了時にテスト結果を自動的に表示する。 |
| Open results only for unsuccesfull test runs | 失敗したテスト、致命的なテスト、予期せず通過したテストが含まれる場合にのみ、テスト結果を表示する。 |
| Automatically scroll results | ビューは自動的にスクロールして、最新の結果を表示します。 |
| Group results by application | テストの実行に使用する実行可能パスでテスト結果をグループ化します。これは、複数のテスト実行可能ファイルを一度に実行する場合に便利です。 |
| Process arguments | 実行設定で指定した引数をテスト実行ファイルに渡します。これは実験的な機能で、テスト実行ファイルの実行に失敗する可能性があります。使用されているテストフレームワークと干渉することが知られているオプションはフィルタリングされます。 |
| Automatically run | 現在のプロジェクトのビルドに成功した後、すべてまたは選択したテストを自動的に実行します。 |
| Timeout | テストケースを実行する最大時間を秒単位で設定します。 |
| Reset Cached Choices | Qt Creator が、使用する実行ファイルや実行設定を判断できないことがあります。テストを実行しようとするときに、実行するテストを選択するように何度も要求される場合は、選択したテストをキャッシュして、適切な場所で使用することができます。Qt Creator は、別のプロジェクトに切り替えたり、現在のプロジェクトを閉じたり、この設定を選択したりすると、キャッシュをクリアします。 |
| Active Test Frameworks | Qt Creator が処理するテストを選択します。テストのフル スキャンのパフォーマンスを向上させるには、使用しないテストフレームワークを無効にします。 |
| Group | アクティブなテスト フレームワークの関連するテスト ケースをグループ化します。デフォルトでは、Qt Creator は、同じディレクトリにあるテストをグループ化します。 |
現在のプロジェクトの環境設定を上書きするには、Projects >Project Settings >Testing にアクセスしてください。
Qt テスト
Qt Tests のプリファレンスを設定するには、Preferences>Testing > Qt Tests に進みます。 Qt Test.
ベンチマークテスト内のコードは測定され、正確な測定を行うために何度か繰り返されます。これは、Benchmark Metrics で選択した測定バックエンドに依存します：
- ウォールタイム
- CPUティックカウンター
- イベントカウンター
- Valgrind Callgrind
- Linux Perf
詳細については、Creating a Benchmark を参照してください。
次の表は、その他の Qt Test の環境設定をまとめたものです。
| 設定 | 値 |
|---|---|
| Disable crash handler while debugging | デバッガがアサーションで Qt テストを中断できるようにします。 |
| Use XML output | XML 出力は解析の問題を回避しますが、プレーンテキストの方が読みやすいです。 注意: プレーンテキストでは、期間などの情報が欠落します。 |
| Verbose benchmarks | ベンチマークの実行時に、冗長な出力を受け取ります。 |
| Log signals and slots | シグナルとスロットに関する情報をテストログに記録する。 |
| Limit warnings | テストログ内の警告の最大数を明示的に制限する。制限を全く設けない場合は、制限を0に設定する。デフォルトの上限は 2000 です。 |
| Check for derived Qt Quick tests | TestCase から派生したQt Quick テストをチェックする。 注意: この機能はかなり高価であり、スキャン時間が大幅に増加します。 |
| Find user-defined locations | 以下のパターンでメッセージを解析し、位置情報として使用する：file://filepath:lineここで、":line "はオプションである。 注意 : このパターンをコードで使用すると、デバッグ・メッセージやその他のメッセージの位置情報が改善される可能性があります。 |
Google テスト
Google テストを実行するための設定を指定するには、Preferences>Testing >Google Test に進んでください。
次の表は、Googleテストの設定をまとめたものです。
| 設定 | 設定値 |
|---|---|
| Run disabled tests | テスト実行中に無効なテストを実行する。 |
| Throw on failure | アサーション失敗を C++ 例外に変換する。 |
| Break on failure while debugging | 失敗をデバッガのブレークポイントにする。 |
| Repeat tests | テストを複数回繰り返す。 |
| Iterations | テストの実行回数。 |
| Shuffle tests | 毎回異なる順序でテストを実行することで、テストの独立性と再現性を確保する。 |
| Seed | ランダマイザーを初期化する際のシード。0 を指定すると、現在のタイムスタンプに基づいたシードが生成されます。 |
| Group mode | GTest Filter を使用して Google のテストをグループ化します。 |
| Active filter | 使用する GTest フィルタ。 |
GTest フィルタについての詳細は、テストのサブセットを実行する を参照ください。
Boost テスト
Boost テストを実行するための設定を指定するには、Preferences（環境設定） >Testing >Boost Test を開きます。
以下の表に、Boostテストの環境設定をまとめます。
| 設定 | 値 |
|---|---|
| Log format | テスト・レポートに記録するイベントのタイプ。 |
| Report level | テスト結果レポートの冗長性レベル。レポートを作成しない場合は、No を選択します。 |
| Randomize | ランダムな順序でテストを実行します。 |
| Seed | ランダマイザを初期化するシード。値 0 はランダム化を行わないことを意味し、値 1 は現在の時刻を使用します。 |
| Catch system errors | システム・エラーを捕捉または無視する。 |
| Floating point exceptions | 浮動小数点例外トラップの検出。 |
| Detect memory leaks | メモリー・リークの検出。 |
Catch2 テスト
Catch2 テストを実行するための設定を指定するには、Preferences（環境設定） >Testing >Catch Test を開いてください。
以下の表は、Catch2 テストの環境設定をまとめたものです。
| 設定 | 値 |
|---|---|
| Show success | 成功した式も表示する。デフォルトでは、Catch2 は失敗した式のみを表示します。 |
| Break on failure while debugging | 失敗をデバッガのブレークポイントにする。 |
| Skip throwing assertions | スローされた例外をテストするアサーションをスキップする。 |
| Visualize whitespace | 空白文字をエスケープシーケンスに変換する。 |
| Abort after | ボックス内で指定した失敗回数の後にテストを中止する。 |
| Benchmark samples | ベンチマーク実行中に収集するサンプル数。 |
| Benchmark resamples | ベンチマーク後の統計的ブートストラップに使用する再サンプル数。 |
| Benchmark confidence interval | 統計的ブートストラップの信頼区間。 |
| Benchmark warmup time | ベンチマーク開始前の各テストのウォームアップ時間。 |
| Disable analysis | 統計解析とブートストラップを無効にします。 |
CTest ベースのテスト
CTest ベースのテストを実行するための設定を指定するには、環境設定>Testing >CTest に進みます。
次の表は、CTest の環境設定をまとめたものです。
| 設定 | 設定値 |
|---|---|
| Output on failure | テストが失敗した場合にテスト固有の出力を表示する。CTest のデフォルトとは逆に、この設定はデフォルトでオンになっています。 |
| Schedule random | テストをランダムな順序で実行する。 |
| Stop on failure | 最初に失敗したテストでテストの実行を自動的に停止する。 |
| Output mode, | CTest 出力の冗長性レベル。 注： この設定は、テキスト表示の出力にのみ影響します。 |
| Repeat tests | Repetition mode で決定されたテストの再実行。Count で、テストを繰り返す最大回数を設定します。 |
| Run in Parallel | Jobs Test load で、並列実行を制限します。CTest は、CPU 負荷が で設定されたしきい値を超える場合、新しいテストを開始しません。Threshold |
How To: TestおよびTest Resultsも参照してください 。
Copyright © The Qt Company Ltd. and other contributors. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
