qmakeの実行

qmakeの実行時には、コマンドラインでさまざまなオプションを指定することで、その動作をカスタマイズできます。これにより、ビルドプロセスを微調整したり、有用な診断情報を取得したり、プロジェクトのターゲットプラットフォームを指定したりすることができます。

コマンド構文

qmake を実行するための構文は、以下の簡単な形式になります。

qmake [mode] [options] files

動作モード

qmake は 2 つの異なる動作モードをサポートしています。デフォルトモードでは、qmake はプロジェクトファイル内の情報を使用して Makefile を生成しますが、qmake を使用してプロジェクトファイルを生成することも可能です。モードを明示的に設定したい場合は、他のすべてのオプションの前にそれを指定する必要があります。mode には、以下の 2 つの値のいずれかを指定できます:

• -makefile
  qmake の出力は Makefile になります。
• -project
  qmake の出力はプロジェクトファイルになります。
  

  注： 生成されたファイルは編集が必要になる可能性が高いです 。たとえば、プロジェクトに必要なモジュールに合わせてQT 変数を追加するなどです。

options を使用すると、一般的な設定とモード固有の設定の両方を指定できます。Makefile モードにのみ適用されるオプションについては「Makefile モードのオプション」セクションで、プロジェクトファイルの作成に影響を与えるオプションについては「プロジェクトモードのオプション」セクションで説明されています。

ファイル

files 引数は、スペースで区切られた 1 つ以上のプロジェクトファイルのリストを表します。

一般的なオプション

ビルドプロセスをカスタマイズしたり、お使いのプラットフォームのデフォルト設定を上書きしたりするために、qmakeのコマンドラインで幅広いオプションを指定できます。以下の基本オプションは、qmakeの使用方法に関するヘルプを表示したり、qmakeが出力ファイルを書き込む場所を指定したり、コンソールに出力されるデバッグ情報のレベルを制御したりします。

• -help
  qmake はこれらの機能について解説し、役立つヘルプを提供します。
• -o file
  qmake の出力は へリダイレクトされます。このオプションが指定されていない場合、qmake は実行中のモードに応じて、出力に適切なファイル名を使用しようとします。 '-' が指定された場合、出力は stdout へリダイレクトされます。file
  
• -d
  qmakeはデバッグ情報を出力します。 を複数回指定すると、出力の詳細度が高まります。-d

プロジェクトに使用されるテンプレートは、通常、プロジェクトファイル内のTEMPLATE変数によって指定されます。以下のオプションを使用することで、これを上書きまたは変更することができます。

• -t tmpl
  qmakeは、設定済みの 変数を で上書きしますが、これは.proファイルの処理TEMPLATE tmplが完了した後に行われます。
• -tp prefix
  qmakeは、 を 変数に追加します。prefix TEMPLATE

プロジェクトファイル内の問題を発見しやすくするために、警告情報のレベルを微調整できます:

• -Wall
  qmakeは、既知の警告をすべて報告します。
• -Wnone
  qmake による警告情報は生成されません。
• -Wparser
  qmakeはパーサーの警告のみを生成します。これにより、プロジェクトファイルの解析における一般的な落とし穴や潜在的な問題に注意を喚起します。
• -Wlogic
  qmake は、プロジェクトファイルにおける一般的な落とし穴や潜在的な問題について警告します。たとえば、リスト内のファイルの重複や、ファイルの欠落などを報告します。

Makefile モードのオプション

qmake -makefile [options] files

Makefile モードでは、qmake はプロジェクトのビルドに使用される Makefile を生成します。さらに、このモードでは、プロジェクトファイルの生成方法に影響を与えるために、以下のオプションを使用できます。

• -after
  qmake は、指定されたファイルの後にコマンドラインで与えられた割り当てを処理します。
• -nocache
  qmakeは ファイルを無視します。.qmake.cache
• -nodepend
  qmakeは依存関係情報を一切生成しません。
• -cache file
  qmakeは をキャッシュファイルとして使用し、見つかった他の.qmake.cacheファイルは無視します。file
• -spec spec
  qmakeは をプラットフォームおよびコンパイラ情報のパスとして使用し、spec QMAKESPECの値は無視します。

コマンドラインで qmake の設定を渡すこともできます。これらは、指定されたすべてのファイルよりも先に処理されます。たとえば、次のコマンドは test.pro から Makefile を生成します:

qmake -makefile -o Makefile "CONFIG+=test" test.pro

ただし、指定されたオプションの中にはデフォルト値であるため省略できるものもあります:

qmake "CONFIG+=test" test.pro

変数を指定されたファイルの後に処理したいことが確実な場合は、-after オプションを指定できます。これを指定すると、-after オプションの後に続くコマンドライン上のすべての割り当ては、指定されたファイルの解析が完了するまで延期されます。

プロジェクトモードのオプション

qmake -project [options] files

プロジェクトモードでは、qmakeはプロジェクトファイルを生成します。さらに、このモードでは以下のオプションを指定できます:

• -r
  qmakeは、指定されたディレクトリを再帰的に検索します。
• -nopwd
  qmakeは、現在の作業ディレクトリ内のソースコードを検索しません。指定された のみを使用します。files

このモードでは、files 引数はファイルまたはディレクトリのリストにすることができます。ディレクトリが指定された場合、そのディレクトリはDEPENDPATH変数に含められ、そこから関連するコードが生成されるプロジェクトファイルに組み込まれます。ファイルが指定された場合、その拡張子に応じて適切な変数に追加されます。 たとえば、UI ファイルはFORMS に、C++ ファイルはSOURCES に追加されます。

このモードでは、コマンドラインから割り当てを指定することもできます。その場合、これらの割り当ては生成されるプロジェクトファイルの最後に配置されます。