テスト

手順：テスト

テスト、テストフレームワーク、およびテストツールの処理をカスタマイズします。

テストの処理に関する設定を行うには、[Preferences ] > [Testing ] > [General] の順に選択します。

「テスト」設定の「一般」タブ

次の表は、一般的なテスト設定の概要です。

設定	値
Scan threads	テストのスキャンに使用するワーカースレッドの数を設定します。デフォルトでは、Qt Creator は利用可能な論理 CPU の 4 分の 1 を使用します。
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 Test

Qt Testの設定を行うには、[Preferences ] > [Testing ] > [ ] を選択します。. Qt Testに移動してください。

「テスト」設定の「Qt Test」タブ

ベンチマークテスト内のコードは計測され、正確な測定結果を得るために数回繰り返される場合もあります。これは、Benchmark Metrics で選択した測定バックエンドによって異なります：

実時間
CPU ティックカウンター
イベントカウンター
ValgrindCallgrind
Linux Perf

詳細については、「ベンチマークの作成」を参照してください。

以下の表は、その他の Qt Test 設定をまとめたものです。

設定	値
Disable crash handler while debugging	アサーション時にデバッガが Qt Test を中断できるようにします。
Use XML output	XML 出力は解析上の問題を回避できますが、プレーンテキストの方が人間にとって読みやすいです。注：プレーンテキストでは、所要時間などの一部の情報が欠落します。
Verbose benchmarks	ベンチマークの実行時に詳細な出力を取得する。
Log signals and slots	テストログにシグナルおよびスロットに関する情報を記録します。
Limit warnings	テストログ内の警告の最大数を明示的に制限します。制限を一切設けない場合は、制限値を 0 に設定してください。デフォルトの制限値は 2000 です。
Check for derived Qt Quick tests	Qt Quick のチェックTestCase から派生したテスト。注：この機能は処理負荷が高く、スキャン時間が大幅に増加します。
Find user-defined locations	メッセージを以下のパターンで解析し、位置情報として使用します：`file://filepath:line` ここで、「:line」は省略可能です。注：コード内でこれらのパターンを使用すると、デバッグメッセージやその他のメッセージの位置情報が改善される可能性がありますが、位置情報が不正確になったり、パフォーマンスが低下したりするリスクがあります。

Google テスト

Google テストの実行設定を指定するには、[Preferences ] > [Testing ] > [Google Test] に移動します。

「テスト」設定内の「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 ベースのテストを実行するための設定を指定するには、[Preferences ] > [Testing ] > [CTest] の順に選択します。

「テスト」環境設定の「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 で設定された閾値を超える場合、新しいテストを開始しません。

「方法: テスト」も参照してください 。

ヘルプのスタートページを選択既存のテストプロジェクトにテストを追加する

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.