qt_collect_translation_source_targets
Recopila los objetivos aptos para la traducción.
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.7.
Sinopsis
qt_collect_translation_source_targets(out_var [DIRECTORY path])Si los comandos sin versión están desactivados, utiliza en su lugar qt6_collect_translation_source_targets(). Admite el mismo conjunto de argumentos que este comando.
Descripción
Recopila los objetivos aptos para la traducción en el directorio DIRECTORY especificado y en todos sus subdirectorios. Si no se especifica DIRECTORY, la recopilación de objetivos comienza en CMAKE_CURRENT_SOURCE_DIR.
El comando almacena la lista de elementos de destino en la variable especificada como primer argumento.
Exclusión de objetivos de la traducción
De forma predeterminada, todos los objetivos ejecutables y de biblioteca no importados son aptos para la traducción.
Se pueden excluir objetivos concretos configurando la propiedad del objetivo QT_EXCLUDE_FROM_TRANSLATION.
Los objetivos situados bajo un determinado directorio pueden excluirse estableciendo la propiedad de directorio QT_EXCLUDE_FROM_TRANSLATION.
Cuándo ejecutar este comando
El comando « qt_collect_translation_source_targets » lee las propiedades del directorio «BUILDSYSTEM_TARGETS ». Por lo tanto, solo recopila los objetivos que ya se han creado. Los objetivos que se creen después de haber ejecutado « qt_collect_translation_source_targets » no se recopilan.
Para recopilar todos los objetivos del sistema de compilación, llama a ` qt_collect_translation_source_targets ` al final del ` CMakeLists.txt ` de nivel superior o utiliza ` cmake_language(DEFER CALL) ` para configurar la internacionalización (i18n) al final del ámbito del directorio de nivel superior.
Ejemplos
Utiliza el resultado de ` qt_collect_translation_source_targets ` como entrada para ` qt_add_lupdate`.
add_subdirectory(src) # The actual application is defined here.
# All targets that have been defined up to this point will be in i18n_targets.
qt_collect_translation_source_targets(i18n_targets)
qt_add_lupdate(SOURCE_TARGETS ${i18n_targets})
# No targets from this directory are in i18n_targets.
add_subdirectory(tests) # Unit tests - we don't want to translate those.Con CMake 3.19 y versiones posteriores, puede recopilar los objetivos de código fuente al final del ámbito del directorio. De esta forma, qt_collect_translation_source_targets puede llamarse antes de que se hayan definido todos los objetivos. Sin embargo, debe excluir las pruebas configurando la propiedad de directorio QT_EXCLUDE_FROM_TRANSLATION en ON.
function(set_up_translations)
qt_collect_translation_source_targets(i18n_targets)
qt_add_lupdate(SOURCE_TARGETS ${i18n_targets})
endfunction()
cmake_language(DEFER CALL set_up_translations)
add_subdirectory(src) # The actual application is defined here.
add_subdirectory(tests) # Unit tests - we don't want to translate those.
set_property(DIRECTORY tests PROPERTY QT_EXCLUDE_FROM_TRANSLATION ON)© 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.