Qt5 モジュール

Qt5モジュールは、Qtに必要な様々なツールと手順を自動的に処理するためのツールを提供します。

compile_resources

0.59.0で追加

Qtのリソースコレクションファイル（.qrc）をC++ファイルにコンパイルします。

位置引数は必要ありません。以下のキーワード引数を使用します。

  • name (文字列 | 空): 指定した場合、単一の.cppファイルが生成され、すべてのqrcファイルの出力がこのファイルに結合されます。指定しない場合、各qrcファイルは独自のcppファイルに書き込まれます。
  • sources (ファイル | 文字列 | custom_target | custom_target インデックス | generator_output)[]: トランスパイルするソースのリスト。必須で、少なくとも1つのソースが必要です。0.60.0で追加: custom_target、custom_target_index、generator_outputのサポート。
  • extra_args 文字列[]: qt-rccに直接渡す追加の引数
  • method 文字列: Qtを検出するために使用するメソッド。詳細はdependency()を参照してください。

compile_ui

0.59.0で追加

Qtのuiファイル（.ui）をヘッダーファイルにコンパイルします。

位置引数は必要ありません。以下のキーワード引数を使用します。

  • sources (ファイル | 文字列 | custom_target | custom_target インデックス | generator_output)[]: トランスパイルするソースのリスト。必須で、少なくとも1つのソースが必要です。0.60.0で追加: custom_target、custom_target_index、generator_outputのサポート。
  • extra_args 文字列[]: qt-uicに直接渡す追加の引数
  • method 文字列: Qtを検出するために使用するメソッド。詳細はdependency()を参照してください。
  • preserve_paths bool: 1.4.0から。trueの場合、出力ファイルはターゲットの一時ディレクトリ内でディレクトリ構造を維持する必要があることを指定します。たとえば、subdir/one.inputというファイルが処理されると、trueの場合は{target private directory}/subdir/one.out、false（デフォルト）の場合は{target private directory}/one.outというファイルが生成されます。

compile_moc

0.59.0で追加

Qtのmocファイル（.moc）をヘッダーファイルおよび/またはソースファイルにコンパイルします。キーワード引数headersとsourcesの少なくとも一方は指定する必要があります。

位置引数は必要ありません。以下のキーワード引数を使用します。

  • sources (ファイル | 文字列 | custom_target | custom_target インデックス | generator_output)[]: 手動でインクルードするための.mocファイルにトランスパイルするソースのリスト。0.60.0で追加: custom_target、custom_target_index、generator_outputのサポート。
  • headers (ファイル | 文字列 | custom_target | custom_target インデックス | generator_output)[]: .cppファイルにトランスパイルするヘッダーのリスト。0.60.0で追加: custom_target、custom_target_index、generator_outputのサポート。
  • extra_args 文字列[]: qt-mocに直接渡す追加の引数
  • method 文字列: Qtを検出するために使用するメソッド。詳細はdependency()を参照してください。
  • dependencies: mocで使用されるインクルードディレクトリを持つ依存オブジェクト。
  • include_directories (文字列 | IncludeDirectory)[]: .mocファイルをトランスパイルする際に使用されるinclude_directory()オブジェクトのリスト
  • preserve_paths bool: 1.4.0で追加。trueの場合、出力ファイルはターゲットの一時ディレクトリ内でディレクトリ構造を維持する必要があることを指定します。たとえば、subdir/one.inputというファイルが処理されると、trueの場合は{target private directory}/subdir/one.out、false（デフォルト）の場合は{target private directory}/one.outというファイルが生成されます。

preprocess

代わりにcompile_resources、compile_ui、compile_mocを使用することを検討してください。

moc、uic、rccのソースを受け取り、それらをコンパイルするためのC++ファイルに変換します。

シグネチャは次のとおりです。qt.preprocess(name: str | None, *sources: str)

nameパラメーターが渡された場合、すべてのrccファイルは単一の出力ファイルに書き込まれます。

可変長引数sourcesとキーワード引数sourcesは、Meson 0.59.0以降非推奨となりました。これらのファイルはプリプロセッサを通して変更されずに渡されます。これを行わないでください。ジェネレータの出力を別のソースリストに追加するだけです。

sources = files('a.cpp', 'main.cpp', 'bar.c')
sources += qt.preprocess(qresources : ['resources'])

このメソッドは、以下のキーワード引数を取ります。

  • qresources (文字列 | ファイル)[]: RCCコンパイラに渡されます。
  • ui_files: (文字列 | ファイル | CustomTarget)[]: uicコンパイラに渡されます。
  • moc_sources: (文字列 | ファイル | CustomTarget)[]: mocコンパイラに渡されます。これらは#includeされることを意図した.mocファイルに変換されます。
  • moc_headers: (文字列 | ファイル | CustomTarget)[]: mocコンパイラに渡されます。これらは.cppファイルに変換されます。
  • include_directories (IncludeDirectories | 文字列)[], mocのヘッダー検索パスに追加するディレクトリ。
  • moc_extra_arguments 文字列[]: mocへの追加の引数。v0.44.0から。
  • uic_extra_arguments 文字列[]: uicへの追加の引数。v0.49.0から。
  • rcc_extra_arguments 文字列[]: rccへの追加の引数。v0.49.0から。
  • dependencies Dependency[]: mocに必要な依存オブジェクト。v0.48.0から。
  • sources: 変更されずに出力に追加される追加のソースのリスト。0.59.0で非推奨。
  • preserve_paths bool: 1.4.0で追加。trueの場合、出力ファイルはターゲットの一時ディレクトリ内でディレクトリ構造を維持する必要があることを指定します。たとえば、subdir/one.inputというファイルが処理されると、trueの場合は{target private directory}/subdir/one.out、false（デフォルト）の場合は{target private directory}/one.outというファイルが生成されます。

コンパイルターゲットに渡すターゲットとソースの配列を返します。

compile_translations

0.44.0から

このメソッドは、lreleaseを使用して翻訳ファイルをビルドするために必要なターゲットを生成します。位置引数は必要ありません。以下のキーワード引数を使用します。

  • ts_files (ファイル | 文字列 | custom_target | custom_target インデックス | generator_output)[]: Qtのlupdateツールによって生成された入力翻訳ファイルのリスト。0.60.0で追加: custom_target、custom_target_index、generator_outputのサポート。
  • install bool: trueの場合、このターゲットはインストールステップでインストールされます（オプション）。
  • install_dir 文字列: インストール先のディレクトリ（オプション）。
  • build_by_default bool: trueに設定すると、このターゲットはデフォルトでビルドされます（つまり、meson compileを呼び出した場合）。デフォルト値はfalseです（オプション）。
  • qresource 文字列: ts_filesを抽出するrccソースファイル。ts_filesキーワード引数と併用することはできません。v0.56.0から。
  • rcc_extra_arguments 文字列[]: rccへの追加の引数（オプション）。`qresourceと併用する場合。v0.56.0から。

コンパイルされた翻訳のCustomTargetのリスト、またはqresourceファイルを使用している場合は、処理されたソースファイルを含む単一のCustomTargetを返します。これはメインビルドターゲットに渡す必要があります。

has_tools

0.54.0から

このメソッドは、このモジュールで使用されるすべてのツールが見つかった場合はtrue、見つからない場合はfalseを返します。

オプションのQtコードをコンパイルするために使用する必要があります。

qt5 = import('qt5')
if qt5.has_tools(required: get_option('qt_feature'))
  moc_files = qt5.preprocess(...)
  ...
endif

このメソッドは、以下のキーワード引数を取ります。

  • required bool | FeatureOption: デフォルトでは、requiredはfalseに設定されています。requiredがtrueまたは有効なfeatureに設定され、いくつかのツールが見つからない場合、Mesonは異常終了します。
  • method 文字列: Qt依存関係を見つけるために使用されるメソッド（デフォルトはauto）。

依存関係

Qt依存関係を参照してください。

'modules'引数は、プロジェクトにQtモジュールを含めるために使用されます。モジュールのリストについては、Qtのドキュメントを参照してください。

'private_headers'引数は、Qtのモジュールのプライベートヘッダーの使用を許可します。(v0.47.0から)

例

簡単な例を以下に示します。

qt5 = import('qt5')
qt5_dep = dependency('qt5', modules: ['Core', 'Gui'])
inc = include_directories('includes')
moc_files = qt5.compile_moc(headers : 'myclass.h',
                            extra_args: ['-DMAKES_MY_MOC_HEADER_COMPILE'],
                            include_directories: inc,
                            dependencies: qt5_dep)
translations = qt5.compile_translations(ts_files : 'myTranslation_fr.ts', build_by_default : true)
executable('myprog', 'main.cpp', 'myclass.cpp', moc_files,
           include_directories: inc,
           dependencies : qt5_dep)

場合によっては、翻訳はqresourceファイルを使用してバイナリに埋め込まれます。この場合、tsファイルを明示的にリストする必要はありませんが、qresourceファイルにリストされているビルドされたqmファイルから推測されます。例：

qt5 = import('qt5')
qt5_dep = dependency('qt5', modules: ['Core', 'Gui'])
lang_cpp = qt5.compile_translations(qresource: 'lang.qrc')
executable('myprog', 'main.cpp', lang_cpp,
           dependencies: qt5_dep)

検索の結果は次のとおりです。