qt_add_lupdate
Añade objetivos para generar o actualizar archivos .ts de Qt Linguist.
El comando está definido en el componente « LinguistTools » del paquete « Qt6 ». Carga el paquete con:
find_package(Qt6 REQUIRED COMPONENTS LinguistTools)Este comando se introdujo en Qt 6.2.
Sinopsis
Desde la versión 6.7:
qt_add_lupdate(TS_FILES file1.ts [file2.ts ...]
[PLURALS_TS_FILE file.ts]
[SOURCE_TARGETS target1 [target2 ...]]
[SOURCES source1.cpp [sources2.cpp ...]]
[INCLUDE_DIRECTORIES directory1 [directory2 ...]]
[LUPDATE_TARGET target-name]
[NO_GLOBAL_TARGET]
[OPTIONS ...])Desde la versión 6.2 (obsoleto):
qt_add_lupdate(target TS_FILES file1.ts [file2.ts ...]
[SOURCES source1.cpp [sources2.cpp ...]]
[INCLUDE_DIRECTORIES directory1 [directory2 ...]]
[NO_GLOBAL_TARGET]
[OPTIONS ...])Si los comandos sin versión están desactivados, utiliza en su lugar qt6_add_lupdate(). Admite el mismo conjunto de argumentos que este comando.
Descripción
Crea un objetivo personalizado para generar o actualizar los archivos Qt Linguist y .ts con lupdate.
El nombre predeterminado de ese objetivo personalizado es « ${PROJECT_NAME}_lupdate ». Las llamadas posteriores a « qt_add_lupdate » crearán nombres de objetivos a los que se les añadirá un número creciente. El nombre del objetivo personalizado se puede especificar con la opción « LUPDATE_TARGET ».
Con el argumento SOURCE_TARGETS se puede especificar una lista de destinos que contengan fuentes con cadenas traducibles. Si no se especifica SOURCE_TARGETS, se puede especificar SOURCES, tal y como se describe a continuación. Si no se proporciona ni SOURCE_TARGETS ni SOURCES, se llama al comando qt_collect_translation_source_targets() para recuperar la lista de destinos.
Los archivos « .ts » deben especificarse con el argumento « TS_FILES ».
Esta función está diseñada para utilizarse junto con qt_add_lrelease(). Véase también la función de conveniencia qt_add_translations().
Fuentes y directorios de inclusión
Con ` SOURCES ` se pueden especificar explícitamente archivos fuente adicionales que contengan cadenas traducibles.
Puede utilizar ` INCLUDE_DIRECTORIES ` para especificar explícitamente los directorios de inclusión de dichos archivos fuente.
Opciones
Se pueden establecer opciones adicionales de « OPTIONS » que se pasarán al invocar « lupdate ». Las opciones disponibles se pueden consultar en la documentación de lupdate.
Objetivo «Umbrella»
Además del destino ${target}_lupdate, se crea un destino «paraguas» update_translations. Este destino compilará todos los destinos ${target}_lupdate que se hayan creado con qt_add_lupdate.
Pasa NO_GLOBAL_TARGET a qt_add_lupdate para evitar este comportamiento.
El nombre de este objetivo se puede sobrescribir estableciendo la variable QT_GLOBAL_LUPDATE_TARGET antes de llamar a qt_add_lupdate.
Formas plurales
QT_I18N_SOURCE_LANGUAGE especifica el idioma en el que están escritas las cadenas del código fuente. Para gestionar correctamente las formas plurales, crea un archivo .ts adicional para ese idioma que solo contenga cadenas traducibles para formas plurales. Consulta «Gestión de formas plurales» para obtener más detalles.
Con ` PLURALS_TS_FILE ` puede especificar el archivo ` .ts ` para el idioma de origen. Este archivo solo contendrá formas plurales.
Firma de comando obsoleta
Las versiones anteriores de qt_add_lupdate tomaban un destino como primer argumento. Esto ha quedado obsoleto. Utilice en su lugar el argumento SOURCE_TARGETS.
Ejemplos
Añade los destinos myapp_lupdate y update_translations para actualizar el archivo .ts de una aplicación myapp.
qt_add_lupdate(
SOURCE_TARGETS myapp
TS_FILES myapp_de.ts
PLURALS_TS_FILE myapp_en.ts
)Puede especificar el nombre del objetivo creado pasando el argumento LUPDATE_TARGET:
qt_add_lupdate(
LUPDATE_TARGET update_application_translations
TS_FILES myapp_de.ts
PLURALS_TS_FILE myapp_en.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.