qt_finalize_target
Se encarga de diversas tareas comunes específicas de cada plataforma relacionadas con los objetivos de Qt.
El comando está definido en el componente « Core » del paquete « Qt6 », que se puede cargar de la siguiente manera:
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, utiliza en su lugar ` qt6_finalize_target() `. Admite el mismo conjunto de argumentos que este comando.
Descripción
Una vez creado un destino, a veces es necesario realizar pasos adicionales de procesamiento o finalización. Los pasos a seguir dependen de la plataforma, del tipo de destino y de diversas propiedades del mismo. Se espera que estos pasos se realicen dentro del mismo ámbito de directorio en el que se creó el target, por lo que este comando también debe ejecutarse desde ese mismo ámbito de directorio.
Este comando se invoca habitualmente como parte de una llamada a qt_add_executable(), qt_add_library() o qt_add_plugin(). El momento en que se realiza dicha llamada y cuándo un proyecto podría necesitar invocarlo explícitamente se explica en la documentación de dichos comandos.
Objetivos ejecutables
En el caso de los objetivos ejecutables, ` qt_finalize_target() ` implementa la lógica descrita en las subsecciones siguientes, según corresponda a la plataforma y al objetivo proporcionados. Es posible que en futuras versiones de Qt se amplíe aún más el procesamiento de finalización.
Todas las plataformas
Se lleva a cabo cierto procesamiento interno para facilitar la vinculación automática de los complementos de Qt. Esto es especialmente importante si se utiliza un Qt compilado de forma estática o una versión de CMake anterior a la 3.21.
Android
- Genera un archivo de configuración de implementación para
target. - Crea un objetivo de compilación para generar un APK.
WASM
Crea los archivos « ${target}.html » (un archivo « wasm_shell.html » específico del destino), « qtloader.js » y « qtlogo.svg » en el directorio « CMAKE_CURRENT_BINARY_DIR ».
iOS
La finalización intenta proporcionar valores razonables para las siguientes propiedades del objetivo si aún no están configuradas y su correspondiente variable « CMAKE_... » tampoco lo está:
XCODE_ATTRIBUTE_DEVELOPMENT_TEAMXCODE_ATTRIBUTE_PRODUCT_BUNDLE_IDENTIFIERMACOSX_BUNDLE_GUI_IDENTIFIER
Si es necesario, se puede utilizar la variable QT_NO_SET_XCODE_DEVELOPMENT_TEAM_ID para desactivar la configuración de XCODE_ATTRIBUTE_DEVELOPMENT_TEAM, y la variable QT_NO_SET_XCODE_BUNDLE_IDENTIFIER para desactivar la configuración de XCODE_ATTRIBUTE_PRODUCT_BUNDLE_IDENTIFIER y MACOSX_BUNDLE_GUI_IDENTIFIER.
Incorporación de dependencias de bibliotecas compartidas
Una aplicación que dependa de bibliotecas compartidas solo podrá ejecutarse si las bibliotecas compartidas a las que se vincula forman parte de su paquete.
Desde Qt 6.12, el sistema de compilación recopila las bibliotecas compartidas a las que se vincula la aplicación y las añade a la fase de compilación « XCODE_EMBED_FRAMEWORKS » de la aplicación, con la opción « CODE_SIGN_ON_COPY » activada. Se gestionan tanto los paquetes del marco de trabajo como las bibliotecas « dylib » sin marco.
La integración solo se lleva a cabo si se cumplen todas las condiciones siguientes:
- Qt se ha compilado en una configuración de biblioteca compartida.
- Se utiliza el generador de Xcode.
- Qt no se ha compilado con una configuración de depuración y otra de lanzamiento, ya que
XCODE_EMBED_FRAMEWORKScontiene una única ruta por biblioteca y, por lo tanto, no puede describir ambas configuraciones. - El destino es un paquete de aplicación, y no un paquete secundario como una extensión de aplicación. Se espera que los paquetes secundarios utilicen los marcos de trabajo de su aplicación principal.
- La propiedad
XCODE_EMBED_FRAMEWORKSaún no está configurada en el objetivo, lo que se interpreta como una indicación de que el proyecto gestiona la integración por sí mismo.
Para implementar tú mismo las bibliotecas compartidas, configura la propiedad QT_NO_XCODE_EMBED_FRAMEWORKS en el destino de la aplicación.
Para excluir bibliotecas concretas, configura la propiedad QT_NO_XCODE_EMBED_FRAMEWORK_IN_CONSUMERS en dichas bibliotecas.
Destinos de bibliotecas
A partir de esta versión de Qt, la finalización para los objetivos de biblioteca no realiza ningún procesamiento. Es posible que en futuras versiones de Qt se añada un procesamiento de finalización para las bibliotecas, por lo que debes asegurarte de que la finalización siga invocándose 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.