Cafetera
Una aplicación de « Qt Quick » con una interfaz de usuario personalizada basada en estados.

Esta aplicación muestra una forma multiplataforma, adaptada a distintos tamaños de pantalla y responsiva de implementar una interfaz de usuario típica para realizar pedidos de productos.
Ejecución del ejemplo
Puedes ejecutar el ejemplo desde:
- Qt Creator
Abre el modo « Welcome » y selecciona el ejemplo en Examples. Para obtener más información, consulta Qt Creator: Tutorial: Compilar y ejecutar.
- Qt Extension for Visual Studio Code
Ejecute el comando « Qt: Open Qt examples » desde Command Palette y seleccione el ejemplo de la lista. Para obtener más información, consulte Qt Extension for Visual Studio Code: Tutorial: Compilar y ejecutar.
Recorrido por la interfaz de usuario
Esta sección le guía a través del flujo de usuario típico de la aplicación.
Selección de una receta

La aplicación de la cafetera te permite elegir un tipo de café e indica cuántos cafés de ese tipo te quedan para pedir.
Personalización del café

Una vez seleccionada una receta, la aplicación muestra qué proporción contendrá la mezcla de café de:
- café recién hecho
- leche caliente
- espuma de leche
- azúcar
Esto se puede modificar mediante los controles deslizantes.
Visualización del estado de la preparación

Una vez que el usuario ha confirmado que la taza está en la máquina, comienza la preparación.
Cuando se ha iniciado la preparación, la aplicación muestra una animación del proceso de preparación.
El café está listo
Una vez finalizado el proceso de preparación, la aplicación muestra durante unos segundos una taza de café con la mezcla deseada antes de volver a la página de inicio.
Cómo funciona
A continuación explicamos cómo se implementan estas funciones.
Adaptación a los tamaños y la orientación de la pantalla
El objeto raíz de la ventana de la aplicación tiene unos valores iniciales de altura y anchura, que se utilizarán como tamaño de la ventana en plataformas de escritorio. El valor predeterminado « QWindow::AutomaticVisibility » garantiza que la ventana se muestre maximizada o a pantalla completa en las plataformas que lo requieran, como las plataformas móviles.
ApplicationWindow {
visible: true
width: 1000
height: 600
title: qsTr("Coffee")
background: Rectangle {
color: Colors.currentTheme.background
}A partir de ahí, los objetos hijos de ApplicationWindow obtienen el tamaño de ApplicationWindow para determinar sus propios tamaños en consecuencia.
La aplicación utiliza GridLayout en todos los componentes de las páginas de la aplicación para adaptarse fácilmente a los cambios en la orientación de la pantalla.

{La pantalla cambia a modo horizontal cuando la orientación del dispositivo Android es horizontal}

{El modo horizontal es la orientación predeterminada en el escritorio de Windows}
Nota: En la versión de escritorio, el ancho debe ser mayor que la altura.
Navegación por las páginas de la aplicación
La aplicación utiliza el tipo QML ` StackView ` para mostrar las diferentes páginas de la aplicación. El ` StackView ` que gestiona los diferentes componentes de página está implementado en ` ApplicationFlowForm.ui.qml`.
La navegación de una página a la siguiente desencadena un cambio de estado en ` ApplicationFlow.qml `, donde los cambios necesarios en las propiedades son gestionados por el tipo QML ` PropertyChanges `:
states: [
State {
name: "Home"
PropertyChanges {
target: toolbar
backButton.opacity: 0
backButton.enabled: false
themeButton.opacity: 0
themeButton.enabled: false
logo.sourceSize.width: 70
logo.sourceSize.height: 50
}Las animaciones que tienen lugar durante estos cambios de estado se implementan con Transition y PropertyAnimation dentro del componente StackView en ApplicationFLowForm.ui.qml.
Implementación de la página de inicio
La aplicación se inicia mostrando al usuario la página Home como elemento inicial en StackView:
StackView {
id: stack
anchors.top: parent.top
anchors.bottom: parent.bottom
anchors.left: parent.left
anchors.right: parent.right
anchors.topMargin: parent.height / 20
pushEnter: Transition {
PropertyAnimation {
property: "x"
from: stack.width
to: 0
duration: 400
}
}El componente Home se estructura colocando el componente Item como objeto raíz con una máquina de estados y los alias de propiedades adecuados, seguido de GridLayout. Este mismo tipo de estructuración se utilizará en todos los componentes de las páginas de la aplicación.
La página Home muestra una imagen de una taza de café con el logotipo de Qt en la parte superior, «Coffee Machine» como título, un pie de foto con una breve descripción llamativa sobre lo que el usuario puede esperar y un botón getStartedButton.
El usuario puede avanzar pulsando « getStartedButton »; la función del botón « onClicked » se ha implementado en ApplicationFlow.qml:
getStartedbutton.onClicked: {
applicationFlow.state = "Coffee-selection"
applicationFlow.stack.pushItem(applicationFlow.choosingCoffee, {appFlow: applicationFlow})
}Esto provocará el cambio de estado a «Selección de café» en ApplicationFlow.qml y colocará el componente « choosingCoffee » encima del componente Home en StackView.
Implementación de la selección de café
En la página «Selección de café» se muestra ChoosingCoffee.qml; aquí el usuario ve cuatro opciones diferentes de café entre las que elegir. Estas opciones se muestran como CoffeeCards, que se encuentran dentro de GridLayout en ChoosingCoffee.qml:
GridLayout {
id: cards
anchors.horizontalCenter: parent.horizontalCenter
anchors.top: parent.top
rowSpacing: 20
columnSpacing: 20
CoffeeCard {
id: cappuccino
coffeeName: "Cappuccino"
ingredients: "Milk, Espresso, Foam"
time: 2
}
CoffeeCard {
id: latte
coffeeName: "Latte"
ingredients: "Coffee, Foam"
time: 3
}
CoffeeCard {
id: espresso
coffeeName: "Espresso"
ingredients: "Milk, Espresso"
time: 2
}
CoffeeCard {
id: macchiato
coffeeName: "Macchiato"
ingredients: "Milk foam, Espresso"
time: 4
}
}La implementación de la « CoffeeCard » se encuentra en CoffeeCard.qml.
Estas tarjetas pueden mostrarse en forma de cuadrícula o en fila, dependiendo de las propiedades de anchura y altura de pantalla disponibles que siga el objeto raíz « ApplicationWindow » y que transmita a « ChoosingCoffee.qml » y a « GridLayout » a través de la máquina de estados.
CoffeeCards varían en cuanto a sus nombres, tiempos de preparación, ingredientes y el número de tazas disponibles en ese momento.
En esta página, el usuario también puede cambiar el tema de la aplicación por primera vez pulsando el pequeño botón con el icono que parece un sol, situado en la esquina superior derecha de la pantalla. Al pulsar el botón de tema se invoca la función ` themeButton ` en ` ApplicationFlow.qml`:
function themeButton() {
if (Colors.currentTheme == Colors.dark) {
Colors.currentTheme = Colors.light
} else {
Colors.currentTheme = Colors.dark
}
}La función cambia la propiedad « currentTheme » de « Colors.qml » y los colores de toda la aplicación cambian automáticamente mediante los enlaces de propiedades. Todos los colores utilizados en la aplicación se encuentran en « Colors.qml ».
Si se cambia al tema claro, el icono del botón de cambio de tema se transforma en una media luna.
Al pulsar sobre cualquiera de las tarjetas de café se activa un cambio de estado dentro de AbstractButton en CoffeeCard.qml, lo que a su vez activa NumberAnimation a través de Transition:
AbstractButton {
width: parent.width - 2
height: parent.height - 2
anchors.horizontalCenter: parent.horizontalCenter
anchors.verticalCenter: parent.verticalCenter
id: button
hoverEnabled: true
checkable: true
enabled: (root.cupsLeft != 0) ? true : false
transitions: Transition {
NumberAnimation {
properties: "scale"
duration: 50
easing.type: Easing.InOutQuad
}
}Esto reducirá la tarjeta de café seleccionada a un tamaño más pequeño y cambiará el color de los bordes de la tarjeta a verde, lo que indica al usuario que el café ha sido efectivamente seleccionado.
El alias de la propiedad « button » de cada tarjeta de café, onClicked, se vincula a una función ubicada en ApplicationFlow.qml. Cuando el usuario pulsa sobre cualquiera de las tarjetas de café, se invoca la función cuyo nombre se corresponde con la opción de café elegida. La función establecerá el estado de ApplicationFlow.qml en Settings, añadirá un nuevo componente a StackView y configurará las propiedades de los ingredientes en consecuencia.
Implementación de la configuración del café
En esta página, el usuario puede personalizar su opción de café según sus preferencias ajustando los tipos QML personalizados de Slider. Al cambiar el valor de los controles deslizantes, se modificará el nivel de líquido que se ve dentro de la taza de café; esto es posible gracias a que la altura de las imágenes del líquido en Cup.qml está vinculada a los valores de los controles deslizantes correspondientes.
Los valores de los controles deslizantes de la página Settings se almacenan en CoffeeConfig para su uso posterior mediante el tipo QML Synchronizer.
Synchronizer {
sourceObject: settingsForm.coffeeConfig
sourceProperty: "sugarAmount"
targetObject: settingsForm.sugarSlider
targetProperty: "value"
}Al hacer clic en el botón «Inicio», el estado de ApplicationFlow.qml cambia a «Insertar» y la aplicación muestra el Insert.qml.
Implementación de la función «insertar taza»
En esta página se indica al usuario que introduzca su taza en la máquina antes de que pueda comenzar el proceso de preparación.
Al pulsar el botón « Continue » (Insertar taza), la aplicación pasa a la página « Progress ».
Implementación de la preparación del café
La página de progreso muestra una taza de café y una barra de progreso que, cada una a su manera, indican el proceso de preparación en tiempo real.
Una vez llena, la taza de café mostrará exactamente la misma configuración que el usuario seleccionó en la página Settings; esto se garantiza vinculando las variables de la propiedad Cup a los valores correspondientes guardados en ApplicationFlow.qml.
La animación del llenado de la taza de café se lleva a cabo mediante los motores de estado Transition y SmoothedAnimation.
Cup {
id: cup
Layout.alignment: Qt.AlignHCenter | Qt.AlignTop
state: "0"
}La animación de la barra de progreso se implementa mediante Behavior.
Behavior on greenBar.width {
SmoothedAnimation {
easing.type: Easing.Linear
velocity: (progressForm.contentItem.width / progressForm.brewTime) * 1000
}
}Timer se encargará de actualizar el estado de la aplicación una vez finalizada la preparación.
Timer {
id: timer
interval: progressForm.brewTime
running: true
onTriggered: {
progressForm.appFlow.onFinished()
}
}Implementación de «café listo»
La página «Listo» muestra una taza de café llena según la configuración seleccionada por el usuario, junto con el texto «Tu café está listo» y un icono de marca de verificación.
Cuando se muestra esta página, se inicia una función Timer y, una vez alcanzado el intervalo establecido, se redirige al usuario a Home.qml.
Archivos fuente
Pruebas de interfaz gráfica de usuario con Squish
Esta aplicación incluye pruebas de interfaz gráfica de usuario (GUI) con Squish, diseñadas para Qt para Android. Las pruebas se realizan con Squish para Qt, están escritas en Python y se encuentran en el directorio de pruebas de la aplicación.
Al utilizar Squish para Qt en Android, asegúrate de utilizar el hook integrado de Qt y de reenviar el puerto de Squish con adb. Si aparece el error «No se puede cargar la biblioteca» y dlopen falla, desactiva QT_USE_TARGET_ANDROID_BUILD_DIR en la configuración de CMake o elimínalo de Projects->Build Settings->CMake->Current Configuration en Qt Creator.
Si no dispones de una licencia de Squish, puedes obtener una versión de prueba gratuita.
Véase también Todos los ejemplos de Qt.
© 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.