Cómo utilizar lrelease
La herramienta de línea de comandos « lrelease » genera archivos QM a partir de archivos TS. El formato de archivo QM es un formato binario compacto que utiliza la aplicación localizada. Permite una búsqueda extremadamente rápida de traducciones.
Al compilar con qmake, especifica los archivos que se van a procesar en la línea de comandos o en un archivo .pro.
Al compilar con CMake, utilice los comandos de CMake para añadir objetivos que creen o actualicen archivos TS y los transformen en archivos QM. La herramienta lrelease se ejecuta con las opciones que se pasan a los comandos al compilar el objetivo.
Ejecuta lrelease siempre que quieras lanzar la aplicación, desde la versión de prueba inicial hasta la versión final. La aplicación no necesita archivos QM para ejecutarse, pero si están disponibles, la aplicación los detecta y los utiliza automáticamente.
Nota: La herramienta lrelease solo incorpora las traducciones que se marquen como finalizadas. De lo contrario, utiliza el texto original.
Sintaxis de lrelease
lrelease [options] -project project-file
lrelease [options] ts-files [-qm qm-file]Donde:
optionssignifica una o varias opciones de lrelease.project-filees el archivo de configuración del proyecto.ts-filesson los archivos TS que se utilizarán como entrada para los archivos QM.qm-filees el nombre del archivo QM que se va a generar.
Nota: El uso de archivos .pro con « lrelease » ha quedado obsoleto. Utiliza la herramienta lrelease-pro o la función lrelease.prf cuando utilices qmake.
Para consultar la ayuda más reciente, escribe:
lrelease -helpOpciones de lrelease
| Opción | Acción |
|---|---|
-help | Muestra información de ayuda actualizada y sale. |
-idbased | Obsoleta. Esta opción ya no es necesaria y se eliminará en una versión futura. Se utilizaba para habilitar la traducción basada en ID. |
-compress | Comprimir los archivos QM. |
-nounfinished | No incluir traducciones incompletas. |
-fail-on-invalid | Dará error si se encuentran traducciones que no superen las siguientes comprobaciones:
Para obtener más detalles, consulta la ayuda de « Qt Linguist ». |
-fail-on-unfinished | Generar un error si se encuentran traducciones incompletas |
-removeidentical | Si el texto traducido es igual que el texto original, excluye el mensaje. |
-markuntranslated <prefix> | Si un mensaje no tiene una traducción real, utiliza en su lugar el texto de origen precedido por la cadena indicada. |
-project <filename> | Nombre de un archivo que contiene la descripción del proyecto en formato JSON. Puedes utilizar lupdate-pro -dump-json para generar el archivo a partir de un archivo .pro. |
-silent | No explicar lo que se está haciendo. |
-verbose | Explica lo que se está haciendo (por defecto). |
-version | Mostrar la versión de lrelease y salir. |
Ejemplos
Uso de lrelease con CMake
Al compilar con CMake, utiliza los comandos de CMake para añadir traducciones a los objetivos en el archivo CMakeLists.txt y, a continuación, compila los objetivos.
Seleccione una de las siguientes opciones:
- Utilice «qt_add_translations » en un objetivo, como «app». Esto invoca «qt_add_lupdate » y «qt_add_lrelease».
- Utiliza «
qt_add_lrelease» en un objetivo.
Compila un objetivo (por ejemplo, ` app_lrelease`) para actualizar sus archivos .qm. Para actualizar los archivos .qm de todos los objetivos, compila el objetivo ` release_translations`.
Uso de lrelease con qmake
Para ejecutar lrelease sin especificar un archivo de proyecto:
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.