lrelease の使用方法
lrelease コマンドラインツールは、TSファイルからQMファイルを生成します。QMファイル形式は、ローカライズされたアプリケーションが使用するコンパクトなバイナリ形式です。これにより、翻訳の検索が極めて高速に行われます。
qmake を使用してビルドする場合は、コマンドラインまたは .pro ファイルで処理対象のファイルを指定してください。
CMake を使用してビルドする場合は、CMake コマンドを使用して、TS ファイルを作成または更新し、それらを QM ファイルに変換するターゲットを追加します。lrelease ツールは、ターゲットをビルドする際にコマンドに渡すオプションとともに実行されます。
初期のテスト版から最終リリース版に至るまで、アプリケーションをリリースする際はいつでも `lrelease ` を実行してください。アプリケーションの実行に QM ファイルは必要ありませんが、QM ファイルが存在する場合、アプリケーションはそれらを検出して自動的に使用します。
注： lrelease ツールは 、完了としてマークされた翻訳のみを取り込みます。それ以外の場合は、元のテキストが使用されます。
lrelease の構文
lrelease [options] -project project-file
lrelease [options] ts-files [-qm qm-file]場所：
optionsは、1つまたは複数のlrelease オプションを表します。project-fileはプロジェクト設定ファイルです。ts-filesは、QMファイルの入力として使用するTSファイルです。qm-fileは、生成するQMファイルの名前です。
注： lrelease に.proファイルを渡す方法は 非推奨です。qmakeを使用する場合は、lrelease-pro ツールまたはlrelease.prf 機能を使用してください。
最新のヘルプを表示するには、次のように入力してください:
lrelease -helplrelease オプション
| オプション | 動作 |
|---|---|
-help | 最新のヘルプ情報を表示して終了します。 |
-idbased | 非推奨。このフラグはもはや必要とされず、将来のバージョンで削除される予定です。以前は、ID ベースの翻訳を有効にするために使用されていました。 |
-compress | QM ファイルを圧縮します。 |
-nounfinished | 未完了の翻訳は含めない。 |
-fail-on-invalid | 以下のチェックに失敗した翻訳が見つかった場合は、処理を中止します：
詳細については、Qt Linguist のヘルプを参照してください |
-fail-on-unfinished | 未完了の翻訳が見つかった場合にエラーを生成する |
-removeidentical | 翻訳されたテキストがソーステキストと同じ場合は、そのメッセージを除外します。 |
-markuntranslated <prefix> | メッセージに実際の翻訳がない場合は、代わりに、指定された文字列を先頭に付加したソーステキストを使用します。 |
-project <filename> | JSON 形式でプロジェクトの説明が記載されたファイルの名前。lupdate-pro -dump-json を使用して、.pro ファイルからこのファイルを生成することができます。 |
-silent | 何が行われているのかについては説明しない。 |
-verbose | 何が行われているかを説明する (デフォルト)。 |
-version | lrelease のバージョンを表示して終了します。 |
例
CMake での lrelease の使用
CMake を使用してビルドを行う場合は、CMake コマンドを使用して `CMakeLists.txt` ファイルのターゲットに翻訳を追加し、その後、ターゲットをビルドします。
以下のオプションのいずれかを選択してください：
- app などのターゲットに対してqt_add_translationsを使用します。これにより、qt_add_lupdateおよびqt_add_lrelease が呼び出されます。
- ターゲットに対して `
qt_add_lrelease` を使用します。
ターゲット（例: `app_lrelease`）をビルドして、そのターゲットの .qm ファイルを更新します。すべてのターゲットの .qm ファイルを更新するには、ターゲット `release_translations` をビルドします。
qmake での lrelease の使用
プロジェクトファイルを指定せずにlrelease を実行するには：
lrelease.exe main_en.ts languages\main_fr.ts© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
