qt_standard_project_setup
Configurar los valores predeterminados de todo el proyecto según una estructura estándar.
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.3.
Sinopsis
qt_standard_project_setup(
[REQUIRES <version>]
[SUPPORTS_UP_TO <version>]
[I18N_TRANSLATED_LANGUAGES <language...>]
[I18N_SOURCE_LANGUAGE <language>]
)Si los comandos sin versión están desactivados, utiliza en su lugar qt6_standard_project_setup(). Admite el mismo conjunto de argumentos que este comando.
Descripción
Este comando simplifica la tarea de configurar una aplicación típica de Qt. Normalmente se invoca inmediatamente después de la primera llamada a ` find_package(Qt6) `, por lo general en el archivo ` CMakeLists.txt ` de nivel superior y antes de que se haya definido ningún objetivo. Si se invoca más tarde, no se aplica a los objetivos definidos anteriormente, lo que puede dar lugar a resultados confusos. Realiza las siguientes acciones:
- Las variables estándar de CMake `
CMAKE_AUTOMOC` y `CMAKE_AUTOUIC` se establecen en «true» si aún no están definidas. Esto habilita de forma predeterminada todas las funciones de autogen relacionadas con Qt para los objetivos creados posteriormente en el ámbito del directorio actual y en los subdirectorios. - Se incluye automáticamente el módulo GNUInstallDirs de CMake. Esto define los valores por defecto adecuados para variables como
CMAKE_INSTALL_BINDIR,CMAKE_INSTALL_LIBDIR, etc. - Cuando se compila para Windows, si la variable `
CMAKE_RUNTIME_OUTPUT_DIRECTORY` aún no está definida, se establecerá en `${CMAKE_CURRENT_BINARY_DIR}`. - Cuando se compila para plataformas distintas de Apple o Windows,
CMAKE_INSTALL_RPATHse ampliará tal y como se describe a continuación. - La propiedad USE_FOLDERS de CMake se establece en
ON, y QT_TARGETS_FOLDER se establece enQtInternalTargets. Los entornos de desarrollo integrados (IDE) que admiten carpetas mostrarán los objetivos internos de Qt en esta carpeta.
Desde Qt 6.5, es posible modificar el comportamiento predeterminado de la API de CMake de Qt activando los cambios de comportamiento de las versiones más recientes de Qt a través de las políticas de Qt CMake. Esto es similar al concepto de política propio de CMake (compárese con cmake_policy). Si se especifica REQUIRES, todas las políticas introducidas en las versiones de Qt hasta REQUIRES, ambas incluidas, se establecen automáticamente en NEW, y el uso de una versión anterior de Qt dará lugar a un error. Por ejemplo, al especificar REQUIRES 6.8 se activan las políticas desde QTP0001 hasta QTP0005. Si además se especifica SUPPORTS_UP_TO, también se activan las políticas hasta esa versión, pero sin que sea necesario que esté presente esa versión concreta de Qt.
Las políticas disponibles son las siguientes:
«':/qt/qml/'» es el prefijo de recursos predeterminado para los módulos QML | |
Las propiedades de destino que especifican rutas propias de Android pueden contener expresiones generadoras. | |
Ten en cuenta el valor de BUILD_SHARED_LIBS al crear bibliotecas Qt. | |
Los directorios adicionales con archivos QML en un módulo QML necesitan archivos qmldir adicionales | |
Permitir que las palabras clave de dependencia de `qt_add_qml_module()` acepten objetivos de CMake | |
Habilita PRIVATE_CODE como valor por defecto para la generación de código fuente del protocolo Wayland. | |
Encierra entre comillas y aplica caracteres de escape a los valores de los argumentos reenviados en los scripts de implementación generados. | |
Reenvía los argumentos de los scripts de implementación sin reevaluarlos. |
Consulta qt_policy() para obtener más detalles sobre cómo configurar manualmente políticas individuales.
En plataformas que admiten « RPATH » (excepto las plataformas de Apple), este comando añade dos valores a la variable « CMAKE_INSTALL_RPATH ». Se añade « $ORIGIN » para que las bibliotecas encuentren otras bibliotecas de las que dependen en el mismo directorio que ellas mismas. También se añade « $ORIGIN/<reldir> », donde « <reldir> » es la ruta relativa desde « CMAKE_INSTALL_BINDIR » a « CMAKE_INSTALL_LIBDIR ». Esto permite que los ejecutables instalados en « CMAKE_INSTALL_BINDIR » encuentren cualquier biblioteca de la que puedan depender instalada en « CMAKE_INSTALL_LIBDIR ». Se eliminan los duplicados de CMAKE_INSTALL_RPATH. En la práctica, estos dos valores garantizan que los ejecutables y las bibliotecas encuentren sus dependencias en tiempo de enlace, siempre que los proyectos los instalen en las ubicaciones predeterminadas que utiliza el comando install(TARGETS) cuando no se especifica explícitamente ningún destino.
Para desactivar la compatibilidad con carpetas para los IDE, establezca USE_FOLDERS en OFF antes o después de llamar a qt_standard_project_setup.
El comando qt_standard_project_setup() puede desactivarse de forma efectiva estableciendo la variable QT_NO_STANDARD_PROJECT_SETUP en «true».
Internacionalización
Desde Qt 6.7, es posible especificar los idiomas que se utilizan para la internacionalización del proyecto con el argumento ` I18N_TRANSLATED_LANGUAGES `. Consulte ` QT_I18N_TRANSLATED_LANGUAGES ` para obtener más detalles.
Utiliza I18N_SOURCE_LANGUAGE para especificar el idioma en el que están escritas las cadenas traducibles. Por defecto, se utiliza en. Consulta QT_I18N_SOURCE_LANGUAGE para obtener más detalles.
Ejemplo
cmake_minimum_required(VERSION 3.16...3.22)
project(MyThings)
find_package(Qt6 REQUIRED COMPONENTS Core)
qt_standard_project_setup()
qt_add_executable(MyApp main.cpp)
install(TARGETS MyApp
BUNDLE DESTINATION .
RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
)
qt_generate_deploy_app_script(
TARGET MyApp
OUTPUT_SCRIPT deploy_script
NO_UNSUPPORTED_PLATFORM_ERROR
)
install(SCRIPT ${deploy_script})Véase también qt_generate_deploy_app_script(), qt_policy() y qt_add_translations().
© 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.