lupdate の使用方法

lupdate コマンドラインツールは、C++ソースファイル、C++ヘッダーファイル、Java、Python、QML、およびUIファイル内の翻訳可能な文字列を検出し、TSファイルを生成または更新します。

qmake を使用してビルドする場合は、コマンドラインまたは .pro ファイル内で処理対象のファイルを指定してください。

CMake を使用してビルドする場合は、CMake コマンドを使用して、TS ファイルを作成または更新し、それらを QM ファイルに変換するターゲットを追加します。lupdate ツールは、ターゲットをビルドする際にコマンドに指定したオプションとともに実行されます。

プロジェクトファイルでの翻訳の指定に関する詳細については、「アプリケーションのローカライズ」を参照してください。

lupdate の構文

lupdate [options] [project-file]...
lupdate [options] [source-file|path|@lst-file]... -ts ts-files|@lst-file

ここで：

• options は、1つまたは複数のlupdate オプションを表します。
• project-file はプロジェクトの設定ファイルです。
• source-file は、翻訳可能な文字列を含むファイルです。
• path は、翻訳用ソースファイルが含まれるフォルダのパスです。
• @lst-file lst-file から追加のファイル名（1 行に 1 つ）またはインクルードパス（1 行に 1 つ、先頭に-I を付加）を読み込みます。
• ts-files 生成または更新する TS ファイルです。

最新のヘルプを表示するには、次のように入力してください：

lupdate -help

lupdate オプション

例

CMake での lupdate の使用方法

CMake を使用してビルドを行う場合は、CMake コマンドを使用して CMakeLists.txt ファイルのターゲットに翻訳を追加し、その後、ターゲットをビルドします。

以下のオプションのいずれかを選択してください：

• app などのターゲットに対してqt_add_translationsを使用します。これにより、qt_add_lupdateおよびqt_add_lrelease が呼び出されます。
• ターゲットに対して `qt_add_lupdate ` を使用します。

ターゲット（例: `app_lupdate`）をビルドして、そのターゲットの .ts ファイルを更新します。すべてのターゲットの .ts ファイルを更新するには、ターゲット `update_translations` をビルドしてください。

qmake での lupdate の使用

単一の QML ファイルの翻訳ファイルを生成するには：

lupdate main.qml -ts main_en.ts

別の言語（例えばフランス語）の翻訳ファイルを作成するには、main_en.ts を main_fr.ts にコピーし、フランス語の TS ファイル内の文字列を翻訳します。

lupdate .qrc ファイルにリストされているQMLファイルを処理します:

RESOURCES += qml.qrc

すべての QML ファイルをlupdate で処理するには：

lupdate application.qrc -ts myapp_en.ts

.qrc ファイルを使用せずに、現在の作業ディレクトリ（またはそのサブフォルダ）内のすべてのQMLファイルを処理するには：

lupdate . -extensions qml -ts myapp_en.ts

QML ソースファイルと C++ ソースファイルの両方で、翻訳可能な文字列があるかどうかを確認するには：

lupdate qml.qrc filevalidator.cpp -ts myapp_en.ts

プロジェクトファイルで言語を指定せずに、英語とフランス語で使用する .ts ファイルを生成するには：

lupdate qml.qrc filevalidator.cpp -ts myapp_en.ts myapp_fr.ts

TSファイルを翻訳者に渡し、翻訳者はQt Linguist を使用してファイルを読み込み、翻訳文を挿入します。

XLIFF形式のファイル

TSファイル形式は、バージョン管理システムで使用できる、人間が読みやすいシンプルなXML形式です。さらに、lupdate は、Localization Interchange File Format（XLIFF）ファイル（.xlf ）を処理することができます。

Qt Linguist では、XLIFF ファイルを開いて編集することができます。