En esta página

Implementación de una pantalla de bienvenida con « Qt Quick » en Android

Mostramos cómo configurar una pantalla de inicio con una vista de Qt Quick en Android.

Pantalla de inicio de Android con el logotipo de Qt Development sobre fondo verde

Este sencillo ejemplo muestra cómo utilizar una vista Qml como pantalla de inicio de Qt. No se utilizan transiciones adicionales. En este ejemplo, se oculta la pantalla de inicio predeterminada, introducida en Android 12. Cuando se inicia la aplicación, la pantalla de inicio se muestra durante dos segundos, tras lo cual se muestra la vista principal sin transición.

Este ejemplo forma parte de una serie de dos ejemplos similares que muestran cómo utilizar la pantalla de inicio. En este se utiliza una vista QML, mientras que en el otro se utilizan los indicadores de AndroidManifest.

Uso de la pantalla de inicio de Qt Quick en Android

Para utilizar una vista QML como pantalla de inicio, hay que definir una vista y añadir algunos elementos específicos de la funcionalidad de la pantalla de inicio.

Window {
    id: splash
    color: "#2CDE85"
    title: qsTr("Splash Window")
    modality: Qt.ApplicationModal
    flags: Qt.SplashScreen
    visible: true

    property int timeoutInterval: 2000
    signal timeout
  • modality: Qt.ApplicationModal Establece la vista como modal.
  • flags: Qt.SplashScreen Oculta la barra de título.
  • property int timeoutInterval: 2000 Establece el tiempo de visibilidad de la vista.
Carga de la vista principal
    Loader {
        id: mainLoader
        source: "Main.qml"

El temporizador llama a la función «exit» al agotarse el tiempo de espera para pasar de la pantalla de inicio a la vista principal. Cualquier posible animación de salida se iniciaría aquí.

    function exit() {
        mainLoader.item.show();
        splash.visible = false
        splash.timeout()
    }

El temporizador deja un tiempo adecuado para que aparezca la pantalla de inicio. Esto se puede utilizar junto con la señal « Loader.loaded()» o, posiblemente, con otra señal procedente de la implementación de la aplicación cuando esta esté lista para mostrarse.

    Timer {
        interval: splash.timeoutInterval;
        running: splash.visible;
        repeat: false
        onTriggered: {
            splash.exit()
        }
    }

Al iniciarse, se muestra la pantalla de inicio predeterminada antes de que aparezca la primera vista de la aplicación. Consulta Pantallas de inicio de Android para obtener instrucciones sobre cómo modificarla.
De forma predeterminada, Android utiliza el icono de la aplicación como pantalla de inicio. En una aplicación de Qt para Android, esto se puede modificar para utilizarlo como pantalla de inicio de la aplicación o se puede combinar con la pantalla de inicio de Qt.

Ocultar la pantalla de inicio nativa de Android

Para mantener una experiencia de usuario coherente al iniciar la aplicación en todas las plataformas, puede ser necesario ocultar la pantalla de inicio de Android. Para ello, define un tema translúcido que oculte de forma efectiva la pantalla de inicio de Android.

<?xml version="1.0" encoding="UTF-8"?>
<resources>
    <style name="splashStartTheme">
        <item name="android:windowNoTitle">true</item>
        <item name="android:windowDisablePreview">true</item>
        <item name="android:windowIsTranslucent">true</item>
    </style>
</resources>

Sin embargo, hay un problema. Los cambios de orientación dejan de funcionar si utilizamos un tema translúcido. Esto se debe a que la vista de Android obtiene su orientación de la vista subyacente, que suele ser un «Application Drawer» (menú de aplicaciones) que no cambia de orientación. Y como el tema no se puede cambiar una vez establecida la vista de la actividad, la aplicación queda bloqueada en una única orientación.
Como solución alternativa, podemos crear una actividad temporal con un tema translúcido para la pantalla de inicio de Android. Tan pronto como sea posible, iniciamos otra actividad, que cuenta con todas las funciones que requiere nuestra aplicación.

        <activity
            android:name=".SplashActivity"
            android:exported="true"
            android:label="QML Splash Screen Example"
            android:theme="@style/splashStartTheme">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

De este modo, no se muestra la pantalla de inicio nativa de Android y lanzamos la QtActivity, que muestra la pantalla de inicio definida en QML. Para lanzar la pantalla de inicio en QML, debemos sobrescribir el método onCreate de la actividad de Android y utilizar un Intent para lanzar la QtActivity.

package io.qt.qmlsplashscreeninandroid;

import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import android.util.Log;
import android.content.Intent;
import android.view.ViewTreeObserver;
import org.qtproject.qt.android.bindings.QtActivity;

public class SplashActivity extends Activity {

    private static final String TAG = "SplashActivity";

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // Set up an OnPreDrawListener to the root view.
        final View content = findViewById(android.R.id.content);
                content.getViewTreeObserver().addOnPreDrawListener(
                        new ViewTreeObserver.OnPreDrawListener() {
            @Override
            public boolean onPreDraw() {
                Intent i = new Intent(SplashActivity.this, QtActivity.class);
                i.setFlags(Intent.FLAG_ACTIVITY_NO_ANIMATION);
                startActivity(i);

                content.getViewTreeObserver().removeOnPreDrawListener(this);
                finish();
                return true;
            }
        });
    }
}

Por último, la pantalla de inicio de QML abre la vista principal, que en este ejemplo contiene solo una única vista con un botón de cierre.

Proyecto de ejemplo en code.qt.io

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