Uso de lupdate
La herramienta de línea de comandos « lupdate » busca cadenas traducibles en archivos fuente de C++, de encabezado de C++, de Java, de Python, de QML y de interfaz de usuario, y genera o actualiza archivos TS.
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, utiliza los comandos de CMake para añadir objetivos que creen o actualicen archivos TS y los transformen en archivos QM. La herramienta lupdate se ejecuta con las opciones que se pasan a los comandos al compilar el objetivo.
Para obtener más información sobre cómo especificar traducciones en los archivos de proyecto, consulta «Localización de aplicaciones».
Sintaxis de «lupdate»
lupdate [options] [project-file]...
lupdate [options] [source-file|path|@lst-file]... -ts ts-files|@lst-fileDonde:
optionssignifica una o varias opciones de lupdate.project-filees el archivo de configuración del proyecto.source-filees un archivo que contiene cadenas traducibles.pathes la ruta a una carpeta que contiene los archivos fuente de traducción.@lst-filelee nombres de archivos adicionales (uno por línea) o rutas de inclusión (una por línea y precedidas por-I) del archivo lst.ts-filesson los archivos TS que se van a generar o actualizar.
Para ver la ayuda más reciente, escribe:
lupdate -helplupdate options
| Opción | Acción |
|---|---|
-help | Mostrar información de ayuda actualizada y salir. |
-no-obsolete | Eliminar todas las cadenas obsoletas y desaparecidas. |
-extensions <ext>[,<ext>]... | Procesar únicamente los archivos con las extensiones indicadas. Utilizar comas para separar las extensiones en la lista. No utilizar espacios en blanco. El valor por defecto es: java,jui,ui,c,c++,cc,cpp,cxx,ch,h,h++,hh,hpp,hxx,js,qs,qml,qrc. |
-pluralonly | Incluir únicamente mensajes en plural. |
-silent | No explique lo que se está haciendo. |
-no-sort | No ordenes los contextos en los archivos TS. |
-sort-messages | Ordena alfabéticamente los mensajes de un contexto en los archivos TS. |
-no-recursive | No escanee directorios de forma recursiva. |
-recursive | Escanear los directorios de forma recursiva (por defecto). |
-warnings-are-errors | Trata las advertencias como errores. |
-I <includepath> or -I<includepath> | Busca archivos de inclusión en esta ubicación adicional. Puedes especificar varias rutas. |
-locations {absolute|relative|none} | Especificar o anular la forma de guardar las referencias al código fuente en los archivos TS.
Si no se especifica la ubicación, |
-no-ui-lines | No registrar números de línea en las referencias a archivos de interfaz de usuario. |
-disable-heuristic {sametext|similartext} | Desactiva la heurística de fusión por nombre. Se puede especificar varias veces. |
-project <filename> | Nombre de un archivo que contiene la descripción del proyecto en formato JSON. Puedes utilizar lupdate-pro -dump-json <file> para generar el archivo a partir de un archivo .pro. |
-pro <filename> | Nombre de un archivo .pro. Útil para archivos con la sintaxis de un archivo .pro pero con otra extensión. Los proyectos se exploran de forma recursiva y se fusionan. Esta opción está en desuso. Utiliza en su lugar la herramienta lupdate-pro. |
-pro-out <directory> | Directorio de salida virtual para procesar los archivos .pro siguientes. |
-pro-debug | Registra el procesamiento de los archivos .pro. Especifícalo dos veces para obtener más detalles. |
-source-language <language>[_<region>] | Especifica el idioma de las cadenas de origen para los nuevos archivos. El valor predeterminado es POSIX si no se especifica. |
-target-language <language>[_<region>] | Especifica el idioma de las traducciones para los nuevos archivos. Si no se especifica el idioma, lupdate lo determina a partir del nombre del archivo. |
-tr-function-alias <function>{+=,=}<alias>[,<function>{+=,=}<alias>]... | Con « += », se reconoce « <alias> » como una grafía alternativa de « <function> ». Con « =, », se reconoce « <alias> » como la única grafía de « <function> ».Los valores disponibles de «
|
-ts <ts-file>... | Especifica los archivos de salida. Esto anula TRANSLATIONS. |
-version | Muestra la versión de lupdate y sale del programa. |
Ejemplos
Uso de lupdate 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 llama a qt_add_lupdate y qt_add_lrelease.
- Utiliza «
qt_add_lupdate» en un objetivo.
Compila un objetivo (por ejemplo, ` app_lupdate`) para actualizar sus archivos .ts. Para actualizar los archivos .ts de todos los objetivos, compila el objetivo ` update_translations`.
Uso de lupdate con qmake
Para generar un archivo de traducción para un único archivo QML:
lupdate main.qml -ts main_en.tsPara crear un archivo de traducción a otro idioma, por ejemplo, al francés, copia main_en.ts como main_fr.ts y traduce las cadenas del archivo TS en francés.
lupdate procesa los archivos QML que figuran en el archivo « .qrc »:
RESOURCES += qml.qrcPara que todos los archivos QML sean procesados por lupdate:
lupdate application.qrc -ts myapp_en.tsPara procesar todos los archivos QML del directorio de trabajo actual (o sus subcarpetas) sin utilizar un archivo « .qrc »:
lupdate . -extensions qml -ts myapp_en.tsPara buscar cadenas traducibles tanto en los archivos fuente QML como en los de C++:
lupdate qml.qrc filevalidator.cpp -ts myapp_en.tsPara generar archivos .ts que se utilizarán para el inglés y el francés sin especificar los idiomas en el archivo del proyecto:
lupdate qml.qrc filevalidator.cpp -ts myapp_en.ts myapp_fr.tsEntrega los archivos .ts al traductor, que utilizará Qt Linguist para leer los archivos e insertar las traducciones.
Archivos en formato XLIFF
El formato de archivo TS es un formato XML sencillo y legible para el usuario que se puede utilizar con sistemas de control de versiones. Además, lupdate puede procesar archivos en formato XLIFF (Localization Interchange File Format) (.xlf).
Nota: Actualmentesolo se admiten las versiones 1.1 y 1.2 de XLIFF.
Puedes abrir y editar archivos XLIFF en Qt Linguist.
© 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.