En esta página

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:

  • options significa una o varias opciones de lrelease.
  • project-file es el archivo de configuración del proyecto.
  • ts-files son los archivos TS que se utilizarán como entrada para los archivos QM.
  • qm-file es 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 -help

Opciones de lrelease

OpciónAcción
-helpMuestra información de ayuda actualizada y sale.
-idbasedObsoleta. 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.
-compressComprimir los archivos QM.
-nounfinishedNo incluir traducciones incompletas.
-fail-on-invalidDará error si se encuentran traducciones que no superen las siguientes comprobaciones:
  • comprobación de validez de los atajos
  • comprobación de validez de los espacios en blanco circundantes
  • comprobación de validez de la puntuación final
  • comprobación de validez de los marcadores de posición

Para obtener más detalles, consulta la ayuda de « Qt Linguist ».

-fail-on-unfinishedGenerar un error si se encuentran traducciones incompletas
-removeidenticalSi 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.
-silentNo explicar lo que se está haciendo.
-verboseExplica lo que se está haciendo (por defecto).
-versionMostrar 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:

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.