qt_add_lrelease
Añade objetivos para transformar archivos .ts de Qt Linguist en archivos .qm.
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_lrelease(TS_FILES file1.ts [file2.ts ...]
[LRELEASE_TARGET target-name]
[EXCLUDE_FROM_ALL]
[NO_GLOBAL_TARGET]
[QM_OUTPUT_DIRECTORY directory] # since 6.9
[QM_FILES_OUTPUT_VARIABLE variable-name]
[MERGE_QT_TRANSLATIONS]
[QT_TRANSLATION_CATALOGS catalog1 [catalog2 ...]]
[OPTIONS ...])Desde la versión 6.2 (obsoleto):
qt_add_lrelease(target TS_FILES file1.ts [file2.ts ...]
[NO_TARGET_DEPENDENCY]
[NO_GLOBAL_TARGET]
[QM_FILES_OUTPUT_VARIABLE variable-name]
[OPTIONS ...])Si los comandos sin versión están desactivados, utiliza qt6_add_lrelease() en su lugar. Admite el mismo conjunto de argumentos que este comando.
Advertencia: Para llamar a « qt_add_lrelease » en un ámbito de directorio distinto al del directorio de destino se requiere, como mínimo, la versión 3.18 de CMake.
Descripción
Crea un comando personalizado para transformar archivos ` .ts ` en archivos ` .qm ` con `lrelease`.
La ejecución del comando personalizado se controla mediante un destino personalizado que se crea de forma predeterminada. El nombre predeterminado de ese destino personalizado es « ${PROJECT_NAME}_lrelease ». Las llamadas posteriores a « qt_add_lrelease » crearán nombres de destino con un número creciente añadido al final. El nombre del destino personalizado se puede especificar con la opción « LRELEASE_TARGET ».
Los archivos .ts deben especificarse con el argumento TS_FILES.
Esta función está diseñada para utilizarse junto con qt_add_lupdate(). Véase también la función de envoltura qt_add_translations().
Opciones
Se pueden establecer opciones adicionales de OPTIONS que deben pasarse al invocar lrelease. Las opciones disponibles se pueden consultar en la documentación de lrelease.
Ubicación de los archivos .qm generados
Por defecto, los archivos .qm se colocarán en el directorio de compilación actual (CMAKE_CURRENT_BINARY_DIR). A partir de Qt 6.9, se puede utilizar el argumento QM_OUTPUT_DIRECTORY para generar los archivos .qm en un directorio diferente. Las rutas relativas se consideran situadas por debajo de CMAKE_CURRENT_BINARY_DIR.
Por ejemplo, con el siguiente código, los archivos .qm se generan en un directorio translations situado bajo el directorio de compilación actual.
qt_add_lrelease(
TS_FILES myapp_en.ts myapp_de.ts
QM_OUTPUT_DIRECTORY translations
)Para un control más preciso, puedes especificar el directorio de salida de cada uno de los archivos « .qm » configurando la propiedad del archivo fuente « OUTPUT_LOCATION » en el archivo « .ts » correspondiente. Esto debe hacerse antes de llamar a « qt_add_lrelease ».
La propiedad del archivo fuente « OUTPUT_LOCATION » anula el directorio pasado a través de « QM_OUTPUT_DIRECTORY ».
Por ejemplo, con el siguiente código, los archivos .qm se generan en un directorio translations situado debajo del directorio de compilación actual.
set_source_files_properties(app_en.ts app_de.ts
PROPERTIES OUTPUT_LOCATION "${CMAKE_CURRENT_BINARY_DIR}/translations")
qt_add_lrelease(TS_FILES myapp_en.ts myapp_de.ts)Procesamiento de los archivos .qm generados
Para seguir procesando los archivos « .qm » generados, por ejemplo, para crear reglas de instalación, « qt_add_lrelease » puede almacenar las rutas de los archivos « .qm » en una variable. Para ello, pasa « QM_FILES_OUTPUT_VARIABLE <variable-name> » a la función.
Compilación por defecto
De forma predeterminada, el comando crea un objetivo personalizado que se añade al objetivo de compilación predeterminado. Esto garantiza que los archivos .qm estén siempre actualizados cuando se compila el proyecto. Este comportamiento se puede desactivar con el argumento EXCLUDE_FROM_ALL. En este caso, el usuario debe compilar el objetivo ${PROJECT_NAME}_lrelease manualmente.
Objetivo paraguas
Además del objetivo ${target}_lrelease, se crea un objetivo global release_translations. Este objetivo compilará todos los objetivos ${target}_lrelease que se hayan creado con qt_add_lrelease.
Pasa NO_GLOBAL_TARGET a qt_add_lrelease para evitar este comportamiento.
El nombre de este objetivo se puede anular configurando la variable QT_GLOBAL_LRELEASE_TARGET antes de llamar a qt_add_lrelease.
Fusionar las traducciones proporcionadas por Qt
Desde Qt 6.9, puedes fusionar las traducciones proporcionadas por Qt en archivos ` .qm ` específicos de la aplicación. Para ello, pasa la opción ` MERGE_QT_TRANSLATIONS ` a ` qt_add_translations`. Esto determinará los catálogos de traducción de Qt que pertenecen a los módulos utilizados por tu proyecto y los fusionará en los archivos ` .qm ` generados por ` lrelease`.
Los catálogos de traducción de Qt se determinan mediante las llamadas a find_package en el ámbito de su CMakeLists.txt donde se invoca a qt_add_translations. Por ejemplo, la siguiente secuencia fusionará los catálogos qtbase y qtmultimedia en sus archivos .qm:
find_package(Qt6 COMPONENTS MultimediaWidgets)
...
qt_add_lrelease(
TS_FILES myapp_de.ts myapp_fi.ts
MERGE_QT_TRANSLATIONS
)Para especificar los catálogos de forma explícita, utiliza el argumento QT_TRANSLATION_CATALOGS:
qt_add_lrelease(
TS_FILES myapp_de.ts myapp_fi.ts
MERGE_QT_TRANSLATIONS
QT_TRANSLATION_CATALOGS qtbase qtmultimedia
)Si su proyecto admite un idioma para el que Qt no ofrece su propia traducción, se mostrará una advertencia durante la configuración. Puede suprimir esta advertencia estableciendo la variable CMake QT_NO_MISSING_CATALOG_LANGUAGE_WARNING en ON.
Firma de comando obsoleta
Las versiones anteriores de qt_add_lrelease tomaban un objetivo como primer argumento. Esto sigue siendo posible, pero está en desuso.
Ejemplos
Añade los objetivos « myapp_lrelease » y « release_translations » para transformar los archivos « .ts » dados en archivos « .qm ». Además, instala los archivos « .qm » generados. El objetivo « myapp_lrelease » se compila de forma predeterminada.
project(myapp)
...
qt_add_lrelease(
TS_FILES myapp_de.ts myapp_fr.ts
QM_FILES_OUTPUT_VARIABLE qm_files
)
install(FILES ${qm_files} DESTINATION "translations")Puedes especificar el nombre del objetivo creado pasando el argumento LRELEASE_TARGET:
qt_add_lrelease(
LRELEASE_TARGET create_myapp_qm_files
TS_FILES myapp_de.ts myapp_fr.ts
QM_FILES_OUTPUT_VARIABLE qm_files
)© 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.