qt_deploy_translations | Qt Core 6.7.3
Description: Deploy Qt translations needed by an executable.

- Qt 6.7
- Qt Core
- CMake Commands in Qt6 Core
- qt_deploy_translations
- Qt 6.7.3 Reference Documentation

# qt_deploy_translations

Deploy Qt translations needed by an executable.

The command is defined in the `Core` component of the `Qt6` package, which can be loaded like so:

     find_package(Qt6 REQUIRED COMPONENTS Core)

Unlike most other CMake commands provided by Qt, `qt_deploy_translations()` can only be called from a deployment script. It cannot be called directly by the project during the configure stage.

This command was introduced in Qt 6.5.

Note: This command is in technology preview and may change in future releases.

Note: This command does not usually need to be called directly. It is used internally by other higher level commands, but projects wishing to implement more customized deployment logic may find it useful.

## Synopsis

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

## Description

When installing an application, it may be desirable to also install the translations that belong to the used Qt modules. The `qt_deploy_translations` command collects the necessary `.qm` file from the Qt installation and compiles them into one `qt_${language}.qm` file per language. The `.qm` files are installed into `QT_DEPLOY_TRANSLATIONS_DIR`.

## Arguments

The `LOCALES` argument specifies for which locales translations should be deployed. This is a list of language/region combinations as described in Qt Linguist's manual for translators. Examples for valid locales are: `de`, `pl`, or `pt_BR`.

If `LOCALES` is omitted, then all available locales are deployed.

The `CATALOGS` argument specifies a list of translation catalogs to be deployed. If this argument is omitted, then all catalogs are deployed that belong to any Qt module that is used in the project via `find_package`.

The `LCONVERT` argument specifies the `lconvert` executable that is used to combine the catalogs. By default, the Qt installation's `lconvert` is used.

For debugging purposes, the `VERBOSE` argument can be set to turn on diagnostic messages.

## Example

The following example deploys Danish and German translations of the Qt libraries.

     qt_deploy_translations(
         LOCALES da de
     )

See also QT_DEPLOY_TRANSLATIONS_DIR.