En esta página

QNativeInterface::QAndroidApplication Struct

Interfaz nativa para una aplicación principal en Android. Más...

Encabezado: #include <QCoreApplication>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core
Desde: Qt 6.2

Funciones públicas

QAndroidApplication()
QAndroidApplication(const QNativeInterface::QAndroidApplication &)
QAndroidApplication(QNativeInterface::QAndroidApplication &&)
QNativeInterface::QAndroidApplication &operator=(QNativeInterface::QAndroidApplication &&)
QNativeInterface::QAndroidApplication &operator=(const QNativeInterface::QAndroidApplication &)

Miembros públicos estáticos

(since 6.2) QJniObject context()
(since 6.2) void hideSplashScreen(int duration = 0)
(since 6.2) bool isActivityContext()
(since 6.2) QFuture<QVariant> runOnAndroidMainThread(const std::function<QVariant ()> &runnable, const QDeadlineTimer timeout = QDeadlineTimer::Forever)
(since 6.2) int sdkVersion()

Descripción detallada

Se accede a través de QCoreApplication::nativeInterface().

Documentación de las funciones miembro

[constexpr noexcept default] QAndroidApplication::QAndroidApplication()

Crea por defecto una instancia de ` QAndroidApplication`.

[delete] QAndroidApplication::QAndroidApplication(const QNativeInterface::QAndroidApplication &)

Crea una instancia de « QAndroidApplication » mediante copia. Esta función se ha eliminado.

[delete] QAndroidApplication::QAndroidApplication(QNativeInterface::QAndroidApplication &&)

Crea una instancia de ` QAndroidApplication`. Esta función se ha eliminado.

[static, since 6.2] QJniObject QAndroidApplication::context()

Devuelve el contexto de Android como un ` QtJniTypes::Context`. El contexto es un ` Activity ` si el objeto de actividad iniciado más recientemente es válido. De lo contrario, el contexto es un ` Service`.

Esta función se introdujo en Qt 6.2.

[static, since 6.2] void QAndroidApplication::hideSplashScreen(int duration = 0)

Oculta la pantalla de inicio utilizando un efecto de desvanecimiento con el valor especificado en ` duration`. Si no se proporciona ` duration ` (el valor por defecto es 0), la pantalla de inicio se oculta inmediatamente después de que se inicie la aplicación.

Esta función se introdujo en Qt 6.2.

[static, since 6.2] bool QAndroidApplication::isActivityContext()

Devuelve ` true ` si ` QAndroidApplication::context()` proporciona un contexto ` Activity `.

Esta función se introdujo en Qt 6.2.

[static, since 6.2] QFuture<QVariant> QAndroidApplication::runOnAndroidMainThread(const std::function<QVariant ()> &runnable, const QDeadlineTimer timeout = QDeadlineTimer::Forever)

Envía la función runnable al hilo de Android. La función se pondrá en cola y se ejecutará en el hilo de la interfaz de usuario de Android. Si la llamada se realiza en el hilo de la interfaz de usuario de Android, runnable se ejecutará inmediatamente. Si la aplicación de Android está en pausa o la actividad principal es nula, runnable se añade a la cola del hilo principal de Android.

Esta llamada devuelve un QFuture<QVariant> que permite realizar llamadas tanto síncronas como asíncronas, y puede gestionar cualquier tipo de retorno. Sin embargo, para obtener un resultado de QFuture::result(), se debe utilizar QVariant::value().

Si la ejecución de runnable tarda más que el periodo de timeout, las llamadas bloqueantes QFuture::waitForFinished() y QFuture::result() finalizan una vez transcurrido timeout. Sin embargo, si runnable ya ha iniciado su ejecución, no se cancelará.

El siguiente ejemplo muestra cómo ejecutar una llamada asíncrona que espera un tipo de retorno:

auto task = QNativeInterface::QAndroidApplication::runOnAndroidMainThread([=]() {
    QJniObject surfaceView;
    if (!surfaceView.isValid())
        qDebug() << "SurfaceView object is not valid yet";

    surfaceView = QJniObject("android/view/SurfaceView",
                             "(Landroid/content/Context;)V",
                             QNativeInterface::QAndroidApplication::context());

    return QVariant::fromValue(surfaceView);
}).then([](QFuture<QVariant> future) {
    auto surfaceView = future.result().value<QJniObject>();
    if (surfaceView.isValid())
        qDebug() << "Retrieved SurfaceView object is valid";
});

El siguiente ejemplo muestra cómo ejecutar una llamada sincrónica con un tipo de retorno «void»:

QNativeInterface::QAndroidApplication::runOnAndroidMainThread([]() {
   QJniObject activity = QNativeInterface::QAndroidApplication::context();
   // Hide system ui elements or go full screen
   activity.callObjectMethod("getWindow", "()Landroid/view/Window;")
           .callObjectMethod("getDecorView", "()Landroid/view/View;")
           .callMethod<void>("setSystemUiVisibility", "(I)V", 0xffffffff);
}).waitForFinished();

Nota: Ten cuidado con el tipo de operaciones que realices en el hilo principal de Android, ya que cualquier operación prolongada puede bloquear la visualización de la interfaz de usuario de la aplicación y el procesamiento de entradas. Si se prevé que la función tenga un tiempo de ejecución prolongado, también es recomendable utilizar un ` QDeadlineTimer ` en tu ` runnable ` para gestionar la ejecución y asegurarte de que no bloquee el hilo de la interfaz de usuario. Por lo general, cualquier operación que dure más de 5 segundos podría bloquear la interfaz de usuario de la aplicación. Para obtener más información, consulta «Mantén tu aplicación receptiva».

Esta función se introdujo en Qt 6.2.

[static, since 6.2] int QAndroidApplication::sdkVersion()

Devuelve la versión del SDK de Android. Esto también se conoce como «nivel de API».

Esta función se introdujo en Qt 6.2.

[delete] QNativeInterface::QAndroidApplication &QAndroidApplication::operator=(QNativeInterface::QAndroidApplication &&)

Asigna « other » a esta instancia de « QAndroidApplication ». Esta función se elimina.

[delete] QNativeInterface::QAndroidApplication &QAndroidApplication::operator=(const QNativeInterface::QAndroidApplication &)

Asigna mediante copia el objeto « other » a esta instancia de « QAndroidApplication ». Esta función se ha eliminado.

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