qt_deploy_translations

実行ファイルに必要なQtの翻訳をデプロイします。

このコマンドは、Qt6 パッケージのCore コンポーネントで定義されており、次のように読み込むことができます:

find_package(Qt6 REQUIRED COMPONENTS Core)

Qt が提供する他のほとんどの CMake コマンドとは異なり、qt_deploy_translations() はデプロイスクリプトからのみ呼び出すことができます。configure 段階において、プロジェクトから直接呼び出すことはできません。

このコマンドは Qt 6.5 で導入されました。

概要

qt_deploy_translations(
    [CATALOGS catalogs]
    [LOCALES locales]
    [LCONVERT lconvert_executable]
    [VERBOSE]
)

説明

アプリケーションをインストールする際、使用されるQtモジュールに属する翻訳も併せてインストールしたい場合があります。qt_deploy_translations コマンドは、Qtのインストール先から必要な.qm ファイルを収集し、言語ごとに1つのqt_${language}.qm ファイルにコンパイルします。.qm ファイルは、QT_DEPLOY_TRANSLATIONS_DIR にインストールされます。

引数

LOCALES 引数は、どのロケールに対して翻訳を展開するかを指定します。これは、Qt Linguist の翻訳者向けマニュアルに記載されている言語と地域の組み合わせのリストです。有効なロケールの例としては、de 、pl 、またはpt_BR などがあります。

LOCALES を省略した場合、利用可能なすべてのロケールが展開されます。

CATALOGS 引数は、デプロイする翻訳カタログのリストを指定します。この引数が省略された場合、find_package を介してプロジェクトで使用されているQtモジュールに属するすべてのカタログがデプロイされます。

LCONVERT 引数は、カタログを結合するために使用されるlconvert 実行ファイルを指定します。デフォルトでは、Qt インストール先のlconvert が使用されます。

デバッグの目的で、VERBOSE 引数を設定することで、診断メッセージを表示させることができます。

例

次の例では、Qt ライブラリのデンマーク語およびドイツ語の翻訳をデプロイしています。

qt_deploy_translations(
    LOCALES da de
)