Uso del compilador « Qt SCXML » (qscxmlc)
La herramienta « qscxmlc » lee un archivo .scxml y genera archivos fuente y de cabecera en C++, que contienen una clase que implementa una máquina de estados tal y como se define en SCXML.
Uso
La herramienta « qscxmlc » se ejecuta automáticamente si el proyecto está enlazado con la biblioteca « scxml » en el archivo de proyecto, y se especifica el archivo « .scxml » que se va a utilizar mediante las directivas de compilación especiales « STATECHARTS » o «qt_add_statecharts».
Al utilizar CMake:
find_package(Qt6 REQUIRED COMPONENTS Scxml)
target_link_libraries(mytarget PRIVATE Qt6::Scxml)qt_add_statecharts(mytarget
MyStatemachine.scxml
)Al utilizar qmake:
QT += scxmlSTATECHARTS = MyStatemachine.scxmlCon las definiciones anteriores, « qmake » o « cmake » invoca « qscxmlc » para generar «MyStatemachine.h» y «MyStatemachine.cpp», y los añade adecuadamente al proyecto como cabeceras y archivos fuente.
Por defecto, el nombre de la clase generada que implementa la máquina de estados se corresponde con el atributo «name» del elemento raíz de <scxml>.
La herramienta qscxmlc también se puede invocar manualmente y los archivos de cabecera y fuente resultantes se pueden utilizar como archivos fuente normales en un proyecto. Al utilizar estos archivos fuente como parte de un proyecto cmake, hay que desactivar además el moc automático en el archivo CMakeLists.txt, tal y como se ilustra en este ejemplo:
set_source_files_properties(statemachine.h PROPERTIES SKIP_AUTOMOC TRUE)Si se omite esto, aparecerán errores de símbolos duplicados durante la compilación.
Opciones de línea de comandos
La herramienta qscxmlc admite las siguientes opciones de línea de comandos:
| Opción | Descripción |
|---|---|
--namespace <namespace> | Coloca las clases generadas en el espacio de nombres especificado. |
-o <base/out/name> | El nombre base de los archivos de salida. Puede incluir una ruta. Si no se especifica ninguno, se utiliza el nombre base del archivo de entrada. |
--header <header/out> | El nombre del archivo de cabecera de salida. Si no se especifica ninguno, se añade .h al nombre base. |
--impl <cpp/out> | El nombre del archivo de cabecera de salida. Si no se especifica ninguno, se añade .cpp al nombre base. |
--classname <StateMachineClassName> | El nombre de la clase de la máquina de estados generada. Si no se especifica ninguno, se toma el valor del atributo «name» de la etiqueta <scxml>. Si tampoco se especifica dicho atributo, se toma el nombre base (sin la ruta) del nombre del archivo de entrada. |
--statemethods | Genera métodos de acceso y de señal adicionales para los estados. De este modo, puedes conectarte a los cambios de estado con el sencillo QObject::connect() y llamar directamente a un método para averiguar si un estado está activo en ese momento. |
Los archivos de proyecto qmake y CMake admiten las siguientes opciones:
| Opción | Descripción |
|---|---|
QSCXMLC_DIR|OUTPUT_DIRECTORY <directory> | QSCXMLC_DIR (qmake) o OUTPUT_DIRECTORY (cmake) especifica el directorio para los archivos de salida. OUTPUT_DIR (cmake) ha quedado obsoleto. |
QSCXMLC_NAMESPACE|NAMESPACE <namespace> | QSCXMLC_NAMESPACE (qmake) o NAMESPACE (cmake) especifica el espacio de nombres para las clases generadas. |
QSCXMLC_ARGUMENTS|OPTIONS <options> | QSCXMLC_ARGUMENTS (qmake) o OPTIONS (cmake) permite especificar opciones adicionales para el compilador « qscxmlc ». QSCXMLC_ARGUMENTS con cmake ha quedado obsoleto. |
© 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.