qt_add_lupdate

Add targets to generate or update Qt Linguist .ts files.

The command is defined in the LinguistTools component of the Qt6 package. Load the package with:

find_package(Qt6 REQUIRED COMPONENTS LinguistTools)

This command was introduced in Qt 6.2.

Synopsis

qt_add_lupdate(target TS_FILES file1.ts [file2.ts ...]
               [SOURCES source1.cpp [sources2.cpp ...]]
               [INCLUDE_DIRECTORIES directory1 [directory2 ...]]
               [NO_GLOBAL_TARGET]
               [OPTIONS ...])

If versionless commands are disabled, use qt6_add_lupdate() instead. It supports the same set of arguments as this command.

Description

Creates a target ${target}_lupdate to generate or update Qt Linguist .ts files with lupdate.

The parameter target is an existing executable or library target that contains sources with translatable strings.

The .ts files must be specified with the argument TS_FILES.

This function is designed to be used in conjunction with qt_add_lrelease. See also the convenience wrapper qt_add_translations.

Sources and Include Directories

By default, qt_add_lupdate extracts the source files and include directories from the given target and passes them to lupdate.

With SOURCES you can explicitly specify source files that contain translatable strings. This turns off the automatic extraction of source files from the target.

You can use INCLUDE_DIRECTORIES to explicitly specify include directories. This turns off the automatic extraction of include directories from the target.

Options

You can set additional OPTIONS that should be passed when lupdate is invoked. You can find possible options in the lupdate documentation.

Umbrella Target

In addition to the target ${target}_lupdate, an umbrella target update_translations is created. This target will build all ${target}_lupdate targets that were created with qt_add_lupdate.

Pass NO_GLOBAL_TARGET to qt_add_lupdate to prevent this behavior.

The name of this target can be overridden by setting the variable QT_GLOBAL_LUPDATE_TARGET before calling qt_add_lupdate.

Examples

Add the targets myapp_lupdate and update_translations for updating the .ts file of an application myapp.

qt_add_lupdate(myapp TS_FILES myapp_de.ts)

© 2024 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.