Qt TaskTree
Qt TaskTree ofrece una forma declarativa de componer y ejecutar flujos de trabajo de tareas asíncronas con un manejo adecuado de los errores y políticas de ejecución.
Nota: Qt TaskTree en la versión 6.12 se encuentra en fase de «Technology Preview», por lo que su API queda excluida de las garantías de compatibilidad de Qt.
Primeros pasos
Qt TaskTree te permite crear jerarquías de tareas complejas con diferentes políticas de ejecución, ejecución paralela o secuencial y una gestión adecuada de los errores.
Conceptos clave:
- Recetas: descripciones declarativas de flujos de trabajo de tareas.
- Grupos: contenedores que definen las políticas de ejecución de las tareas secundarias.
- Almacenamiento: sistema de almacenamiento local por hilo para compartir datos entre tareas.
- Iteradores: compatibilidad con bucles y la ejecución repetitiva de tareas.
Uso del módulo
Para utilizar la API de C++ de un módulo de Qt es necesario vincularla con la biblioteca del módulo, ya sea directamente o a través de otras dependencias. Varias herramientas de compilación cuentan con soporte específico para ello, entre ellas CMake y qmake.
Compilación con CMake
Utiliza el comando « find_package() » para localizar el componente del módulo necesario en el paquete « Qt6 »:
find_package(Qt6 REQUIRED COMPONENTS TaskTree)
target_link_libraries(mytarget PRIVATE Qt6::TaskTree)Para obtener más detalles, consulta la descripción general de «Compilación con CMake ».
Compilación con qmake
Para configurar el módulo para la compilación con qmake, añade el módulo como valor de la variable ` QT ` en el archivo `.pro` del proyecto:
QT += tasktreeAdaptadores de tareas
El módulo incluye varios adaptadores de tareas integrados para operaciones comunes:
- QProcessTask - Ejecuta procesos externos.
- QThreadFunctionTask - Ejecuta funciones en subprocesos independientes.
- QNetworkReplyWrapperTask - Gestiona operaciones de red.
- QTcpSocketWrapperTask - Gestiona operaciones de sockets TCP.
- QBarrierTask - Proporciona primitivas de sincronización.
- QTimeoutTask - Proporciona retrasos basados en temporizadores.
Políticas de flujo de trabajo
Los grupos admiten diferentes políticas de flujo de trabajo para gestionar los resultados de las tareas:
- StopOnError - Detiene la ejecución ante el primer error (por defecto).
- ContinueOnError - Continúa la ejecución a pesar de los errores.
- StopOnSuccess - Se detiene tras la primera tarea completada con éxito.
- ContinueOnSuccess - Continúa a pesar de que haya tareas completadas con éxito.
- StopOnSuccessOrError - Detiene la ejecución tras la primera tarea completada.
- FinishAllAndSuccess - Ejecuta todas las tareas e informa de que se han completado con éxito.
- FinishAllAndError - Ejecuta todas las tareas e informa de un error.
Ejemplos
Referencia
Licencias
El módulo Qt TaskTree está disponible bajo licencias comerciales de The Qt Company. Además, está disponible bajo licencias de software libre: la Licencia Pública General Reducida de GNU, versión 3, o la Licencia Pública General de GNU, versión 2. Consulte Licencias de Qt para obtener más detalles.
© 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.