En esta página

Qt Quick para Android

Qt Quick Descripción general de Android

La base de este enfoque consiste en ofrecer las API de Qt Qml de forma integrada, de modo que la aplicación siga siendo una aplicación de Android relativamente típica. Este enfoque ofrece un enfoque más estándar centrado en Android a costa de aprovechar la naturaleza multiplataforma de una aplicación Qt. Es el más adecuado para añadir características deseables de Qt a una aplicación de Android ya existente.

  • Android crea el contenido de Qt y lo controla.
  • Para el desarrollo se utiliza Android Studio con el complemento «Qt Tools for Android Studio ».
  • Para el contenido de Qt, se utilizan Qt Creator o Qt Design Studio.
  • Los lenguajes principales son Java y Kotlin, y se utiliza QML para partes específicas, como el contenido 3D.
  • Puedes utilizar cualquier API de Android que desees, pero puedes recurrir a JNI si quieres tener un mayor control sobre la comunicación entre tu código Java y QML. Consulta QJniObject y QJniEnvironment.

En qué se diferencia esto de Qt para Android

La diferencia más notable entre estos enfoques es la estructura del proyecto. Las aplicaciones de Qt para Android son proyectos CMake que se pueden compilar para Android u otras plataformas, mientras que un proyecto Qt Quick para Android es un proyecto de Android que incluye contenido QML y solo se puede compilar para Android.

Comparación de los flujos de trabajo de Qt para Android y Qt Quick para Android

El objetivo principal del enfoque de Qt para Android es que Qt se encargue de la mayor parte del trabajo relacionado con la arquitectura y el código repetitivo de la aplicación, para que tú puedas centrarte en el contenido. Ofrece un enfoque multiplataforma completo y fiable.

  • Qt crea y controla la aplicación para Android.
  • Qt Creator, Qt Design Studio, o bien se puede utilizar Visual Studio.
  • Los lenguajes principales son C++ y QML.
  • Los aspectos específicos de Android están más ocultos; Qt se encarga de ellos internamente.
  • Para utilizar las API de Android que aún no están disponibles como API de Qt, debes utilizar JNI. Consulta QJniObject y QJniEnvironment.

Consulte «Cómo funciona Qt para Android» para obtener más detalles sobre la arquitectura de Qt para Android.

Cómo funciona « Qt Quick » para Android

Qt Quick para Android te ofrece las API de Android que te permiten insertar contenido QML como un elemento «View» de Android en tu proyecto.

Diagrama de arquitectura que muestra Qt Quick integrado en una aplicación de Android

API

Estas son las API públicas de Java y Kotlin que utilizarás en una aplicación de Android para integrar QML.

Clases de Java

Interfaces

Nota: Consulte la variable CMake QT_ANDROID_GENERATE_JAVA_QTQUICKVIEW_CONTENTS para obtener más información sobre la generación de código Java de los componentes QML.

Ejemplos de la API

Qt Quick, para las API de Android, requiere cambios en main()

El archivo main.cpp de una aplicación típica de Qt Quick tiene este aspecto:

#include <QGuiApplication>
#include <QQmlApplicationEngine>

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);

    QQmlApplicationEngine engine;
    QObject::connect(
        &engine,
        &QQmlApplicationEngine::objectCreationFailed,
        &app,
        []() { QCoreApplication::exit(-1); },
        Qt::QueuedConnection);
    engine.loadFromModule("MyQtQuickProject", "Main");

    return app.exec();
}

En main() no es necesario crear un motor QML ni cargar ningún archivo QML que luego vayan a gestionar las API de vista de Qt Quick. Todo lo que necesitamos está en main():

#include <QGuiApplication>

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);

    return app.exec();
}

Ejecución de los ejemplos de Qt Quick para Android

Qt Quick Los ejemplos de la API para Android son proyectos de Android Studio

Los ejemplos de la API « Qt Quick » para Android se proporcionan como proyectos de Android Studio. Las carpetas de los proyectos se encuentran en la ruta de instalación de Qt.

Por ejemplo, en la ruta de instalación predeterminada de Windows, se encuentran aquí:

C:\Qt\Examples\Qt-<patch-release-number>\platforms\android\<example-name>

Estos proyectos ya están configurados para utilizar una versión del complemento Gradle de Qt compatible con esta versión de Qt.

Herramientas

Qt proporciona el complemento Qt Gradle y el complemento Qt Tools for Android Studio para facilitar el desarrollo. Puedes utilizar el complemento Gradle de forma independiente de un IDE como parte de tu cadena de herramientas de compilación. Qt Tools for Android Studio utiliza el complemento para compilar tus proyectos en Android Studio.

Próximos pasos

Los siguientes temas adicionales se aplican a « Qt Quick » para Android:

Android Fragments with Qt Quick for Android

Tutorial sobre el uso de las vistas de « Qt Quick » en fragmentos de Android.

© 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.