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 の出力はfile に向けられます。 このオプションが指定されていない場合、qmake は実行中のモードに応じて適切なファイル名を出力に使用しようとします。
  が指定された場合、出力は標準出力に向けられる。
• -d
  qmakeはデバッグ情報を出力する。-d を複数回追加すると冗長性が増す。

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

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

警告情報のレベルは、プロジェクトファイルの問題を見つけるのに役立つように微調整できます：

• -Wall
  qmake はすべての既知の警告を報告します。
• -Wnone
  qmake はすべての既知の警告を報告します。
• -Wparser
  qmake はすべての既知の警告を報告します。これは、プロジェクトファイルのパースにおける一般的な落とし穴や潜在的な問題を警告します。
• -Wlogic
  qmake はプロジェクトファイルによくある落とし穴や潜在的な問題を警告します。例えば、qmake はリスト内のファイルが複数回出現することや、ファイルが見つからないことを報告します。

Makefile モードのオプション

qmake -makefile [options] files

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

• -after
  qmake は指定されたファイルの後にコマンドラインで与えられた代入を処理します。
• -nocache
  qmake は.qmake.cache ファイルを無視します。
• -nodepend
  qmake は依存情報を生成しません。
• -cache file
  qmake はfile をキャッシュファイルとして使用し、他の .qmake.cache ファイルは無視します。
• -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に追加されます。

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