En esta página

qt_finalize_target

Gestiona varias tareas comunes específicas de la plataforma asociadas a los objetivos Qt.

El comando está definido en el componente Core del paquete Qt6, que puede cargarse de este modo:

find_package(Qt6 REQUIRED COMPONENTS Core)

Este comando se introdujo en Qt 6.2.

Sinopsis

qt_finalize_target(target)

Si los comandos sin versión están desactivados, utilice qt6_finalize_target() en su lugar. Admite el mismo conjunto de argumentos que este comando.

Descripción

Después de crear un objetivo, a veces es necesario realizar otros pasos de procesamiento o finalización. Los pasos a realizar dependen de la plataforma, del tipo de objetivo y de varias propiedades del objetivo. Se espera que estos pasos se realicen dentro del mismo ámbito de directorio en el que se creó target, por lo que este comando también debe invocarse desde ese mismo ámbito de directorio.

Este comando se invoca normalmente como parte de una llamada a qt_add_executable(), qt_add_library() o qt_add_plugin(). El momento en que tiene lugar esa llamada y cuándo un proyecto puede necesitar llamarla explícitamente, se discute en la documentación de esos comandos.

Objetivos ejecutables

Para los objetivos ejecutables, qt_finalize_target() implementa la lógica descrita en las subsecciones siguientes, según sea apropiado para la plataforma y el objetivo proporcionado. Las versiones posteriores de Qt pueden ampliar aún más el procesamiento de finalización.

Todas las plataformas

Se realiza algún procesamiento interno para facilitar la vinculación automática de los plugins de Qt. Esto es especialmente importante si se utiliza un Qt construido estáticamente o una versión de CMake anterior a la 3.21.

Android

  • Generar un archivo de configuración de despliegue para target.
  • Crear un objetivo de compilación para generar un APK.

WASM

Crear ${target}.html (un archivo wasm_shell.html específico del objetivo), qtloader.js, y qtlogo.svg archivos en el CMAKE_CURRENT_BINARY_DIR.

iOS

La finalización intenta proporcionar valores razonables para las siguientes propiedades de destino si aún no están definidas, y su variable CMAKE_... correspondiente tampoco está definida:

  • XCODE_ATTRIBUTE_DEVELOPMENT_TEAM
  • XCODE_ATTRIBUTE_PRODUCT_BUNDLE_IDENTIFIER
  • MACOSX_BUNDLE_GUI_IDENTIFIER

Si es necesario, la variable QT_NO_SET_XCODE_DEVELOPMENT_TEAM_ID se puede utilizar para desactivar la configuración de XCODE_ATTRIBUTE_DEVELOPMENT_TEAM, y la variable QT_NO_SET_XCODE_BUNDLE_IDENTIFIER se puede utilizar para desactivar la configuración de XCODE_ATTRIBUTE_PRODUCT_BUNDLE_IDENTIFIER y MACOSX_BUNDLE_GUI_IDENTIFIER.

Objetivos de biblioteca

A partir de esta versión de Qt, la finalización de los objetivos de biblioteca no realiza ningún procesamiento. Es posible que futuras versiones de Qt añadan el procesamiento de finalización para bibliotecas, por lo que debe asegurarse de que la finalización se sigue invocando de la forma esperada.

Véase también qt_set_finalizer_mode().

© 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.