Localización de aplicaciones
Los pasos para localizar aplicaciones incluyen la creación de aplicaciones traducibles, su preparación para la traducción, la traducción de las cadenas y la creación de archivos de traducción en tiempo de ejecución para la aplicación publicada.
Qt Quick Las aplicaciones de Qt C++ utilizan el mismo sistema de localización subyacente: lupdate, lrelease, así como los archivos de código fuente de traducción (TS) y los archivos QM que generan. Se utilizan las mismas herramientas tanto para el código QML como para el de C++, tal y como se describe en el manual «Qt Linguist ».
Incluso puedes tener cadenas de la interfaz de usuario en archivos fuente QML y C++ dentro de la misma aplicación. El sistema creará un único archivo de traducción combinado y se podrá acceder a las cadenas tanto desde el código QML como desde el código C++.
Para localizar aplicaciones internacionalizadas:
- Especificar fuentes de traducción en los archivos de proyecto de Qt
- Implementar las traducciones
- Utilizar las traducciones de los módulos de Qt
Especificar fuentes de traducción en archivos de proyecto Qt
Para que lupdate y lrelease puedan generar archivos TS y QM, actualice el archivo de proyecto de la aplicación para especificar los archivos de origen que contienen el texto que se va a traducir.
Utilice los códigos ISO de idioma y país en el nombre del archivo TS para determinar el idioma que se cargará en tiempo de ejecución. Para obtener más información, consulte «Habilitar la traducción».
La herramienta lupdate extrae las cadenas de la interfaz de usuario de su aplicación. Por defecto, espera que todo el código fuente esté codificado en UTF-8. Para obtener más información, consulte «Codificación».
Uso de CMake
Para disponer de los comandos CMake de Qt para la internacionalización, carga el paquete « Qt6LinguistTools ».
cmake_minimum_required(VERSION 3.16)
project(myproject)
find_package(Qt6 COMPONENTS Core LinguistTools)Declara los idiomas compatibles con el argumento I18N_TRANSLATED_LANGUAGES de la función qt_standard_project_setup().
# Declare that the project will have a German and a French translation.
qt_standard_project_setup(I18N_TRANSLATED_LANGUAGES de fr)Se da por hecho que el código fuente contiene cadenas traducibles en inglés. Puedes ajustar el idioma de las cadenas del código fuente mediante el parámetro « qt_standard_project_setup » I18N_SOURCE_LANGUAGE.
Llama al comando qt_add_translations() en el objetivo que se supone que debe cargar los archivos .qm en tiempo de ejecución.
qt_add_translations(myapplication)Si aún no existen, esto creará los archivos myproject_de.ts y myproject_fr.ts. Consulte «Determinación automática de rutas de archivos .ts» para saber cómo se construyen esos nombres de archivo.
Este comando también crea myproject_en.ts, que es el archivo de traducción exclusivo para plurales. Consulte «Gestión de formas plurales » para obtener más detalles. La generación del archivo exclusivo para plurales se puede desactivar con el argumento NO_GENERATE_PLURALS_TS_FILE.
Todos los archivos fuente de todos los objetivos del proyecto se consideran entradas para la generación de los archivos .ts. Consulte la documentación de referencia de qt_add_translations() para obtener más información sobre cómo se recopilan los objetivos del proyecto y cómo excluir objetivos y archivos fuente individuales.
Uso de qmake
Al utilizar qmake, configura una instrucción condicional para ocultar al compilador el código fuente QML que incluyas en las entradas « SOURCES » o « HEADERS » del archivo .pro.
La variable SOURCES está pensada para archivos fuente de C++. Si incluyes allí archivos fuente de QML o JavaScript, el compilador intentará compilarlos como si fueran archivos de C++. Como solución alternativa, puedes utilizar una instrucción condicional lupdate_only{...} para que la herramienta lupdate detecte los archivos .qml, pero el compilador de C++ los ignore.
Por ejemplo, el siguiente fragmento de archivo .pro especifica dos archivos .qml en la aplicación.
lupdate_only{
SOURCES = main.qml \
MainPage.qml
}También puedes especificar los archivos fuente .qml mediante un comodín. La búsqueda no es recursiva, por lo que debes especificar cada directorio que contenga archivos fuente con cadenas de interfaz de usuario:
lupdate_only{
SOURCES = *.qml \
*.js \
content/*.qml \
content/*.js
}
Implementar traducciones
La forma más sencilla de implementar los archivos « .qm » es incrustarlos en los recursos de Qt. El comando de CMake `qt_add_translations()` se encarga automáticamente de ello. Se puede acceder a los archivos « .qm » bajo el prefijo de recursos « ":/i18n" ».
# Automatically embed generated .qm files.
qt_add_translations(myapplication)Como alternativa, los archivos ` .qm ` se pueden implementar en un directorio del sistema de archivos. Esto resulta recomendable para aplicaciones de mayor tamaño que no desean mantener todas las traducciones disponibles en memoria. Pasa el argumento QM_FILES_OUTPUT_VARIABLE a qt_add_translations(). El comando almacena la lista de archivos .qm generados en la variable especificada. Utiliza los comandos de instalación habituales de CMake con los nombres de archivo de esa lista.
# Do not embed generated .qm files.
qt_add_translations(myapplication
QM_FILES_OUTPUT_VARIABLE qm_files
)
# Install generated .qm files.
install(FILES ${qm_files} DESTINATION translations)Coloca los archivos ` .qm ` necesarios para la aplicación en una ubicación donde el código del cargador que utiliza ` QTranslator ` pueda encontrarlos. Normalmente, se especifica una ruta relativa a ` QCoreApplication::applicationDirPath`().
Además de los archivos QM de la aplicación, es necesario implementar los archivos QM de los módulos de Qt que se utilicen en la aplicación, a menos que ya estén instalados en el sistema.
Los archivos QM están divididos por módulos y existe un archivo denominado «metacatálogo» que incluye los archivos QM de todos los módulos. Sin embargo, solo es necesario implementar los archivos QM de los módulos que se utilicen en la aplicación.
Puede utilizar la herramienta « lconvert » en el paso de implementación para concatenar los archivos QM necesarios en un único archivo que coincida con el metacatálogo. Por ejemplo, para crear un archivo de traducción al alemán para una aplicación que utiliza el Qt Core, Qt GUI, y Qt Quick , ejecute:
lconvert -o installation_folder/qt_de.qm qtbase_de.qm qtdeclarative_de.qmUtilizar las traducciones de los módulos de Qt
Los módulos de Qt contienen varios miles de cadenas que también deben traducirse a los idiomas de destino. Encontrarás varios archivos TS en el repositorio qttranslations. Antes de empezar a traducir Qt, lee la página de la wiki «Traducir Qt a otros idiomas».
Localización de las traducciones de Qt
Puedes utilizar ` QLibraryInfo::path()` para localizar las traducciones de los módulos de Qt que utiliza tu aplicación. Puedes solicitar la ruta a las traducciones en tiempo de ejecución pasando ` QLibraryInfo::TranslationsPath ` a esta función.
Catálogos disponibles
Los catálogos de traducción de Qt se encuentran en el repositorio qttranslations.
Advertencia: Las traduccionesde Qt son aportadas por la comunidad de Qt y se proporcionan sin garantía alguna. Las traducciones pueden estar incompletas, desactualizadas o ser totalmente incorrectas, llegando incluso a ser maliciosas. Se recomienda que compruebes cualquier traducción que distribuyas.
En Qt 4, hay un único archivo « .qm » grande y monolítico por cada configuración regional. Por ejemplo, el archivo qt_de.qm contiene la traducción al alemán de todas las bibliotecas.
El metacatálogo qt_ contiene las traducciones de Qt que aún existen y que se incluían en el catálogo qt_ de Qt 4. Se creó para facilitar la migración de aplicaciones de Qt 4 a Qt 5. El metacatálogo depende de traducciones que podrían no estar disponibles, ya que pertenecen a módulos innecesarios u obsoletos, lo que podría provocar que la carga de las traducciones fallara. Si utilizas en tu aplicación módulos que son nuevos en Qt 5 o versiones posteriores, debes especificar los nombres de los catálogos de dichos módulos, incluso si utilizas el metacatálogo.
La siguiente tabla enumera los catálogos de traducción disponibles para los módulos y herramientas de Qt.
| Módulo o herramienta de Qt | Catálogo |
|---|---|
| Qt Bluetooth | qtconnectivity |
| Qt Concurrent | qtbase |
| Qt Core | qtbase |
| Qt D-Bus | qtbase |
| Qt Widgets Designer | designer |
| Qt GUI | qtbase |
| Qt Help | qt_help |
| Qt Linguist | linguist |
| Qt Location | qtlocation |
| Qt Multimedia | qtmultimedia |
| Qt Network | qtbase |
| Qt NFC | qtconnectivity |
| Qt Print Support | qtbase |
| Qt Qml | qtdeclarative |
| Qt Quick | qtdeclarative |
| Qt Quick Controles | qtdeclarative |
| Qt Quick Widgets | qtdeclarative |
| Qt Serial Port | qtserialport |
| Qt SQL | qtbase |
| Qt Widgets | qtbase |
| Qt WebSockets | qtwebsockets |
| Qt WebEngine | qtwebengine |
Ejemplo: Módulos esenciales de Qt
Por ejemplo, para localizar traducciones de módulos esenciales de Qt, como Qt Core, Qt GUI, Qt Network y Qt Widgets, añade el siguiente código a la función ` main() `:
QTranslator qtTranslator;
if (qtTranslator.load(QLocale::system(), u"qtbase"_s, u"_"_s,
QLibraryInfo::path(QLibraryInfo::TranslationsPath))) {
app.installTranslator(&qtTranslator);
}© 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.