En esta página

Implementación de una pantalla de inicio con Qt en Android

Mostramos cómo configurar una pantalla de inicio con Qt para Android.

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

Este es un ejemplo sencillo que muestra una forma de mostrar una pantalla de inicio con Qt. Al iniciar la aplicación, se muestra durante dos segundos la pantalla de inicio de Qt con un logotipo y un color de fondo. A continuación, la pantalla de inicio de Qt se desvanece para mostrar la vista principal de la aplicación. La vista principal consta de una etiqueta sencilla y un botón de cierre.

En este ejemplo, la pantalla de inicio predeterminada de Android (a partir de Android 12) queda oculta.

Este ejemplo forma parte de una serie de dos ejemplos similares que muestran pantallas de inicio. Este utiliza indicadores de AndroidManifest, mientras que el otro utiliza una vista QML.

Uso de la pantalla de inicio de Qt en Android

La pantalla de inicio de Qt para Android se define en el archivo AndroidManifest.xml. Los archivos del proyecto de Android se pueden crear manualmente o mediante el generador de plantillas de Qt Creator. Para crear un archivo de proyecto de Android utilizando el generador de plantillas de Qt Creator:

  1. Abre Projects
  2. Ve a la subsección « Build Steps »
  3. Abrir Build Android APK
  4. Selecciona « Create Templates » en la subsección « Application »
            <meta-data android:name="android.app.splash_screen_drawable"
                android:resource="@drawable/qtsplashscreen"/>
            <meta-data android:name="android.app.splash_screen_sticky"
                android:value="true"/>

En el fragmento de código anterior:

Desde Android 12, Android cuenta con una pantalla de inicio predeterminada. Al iniciar la aplicación, se muestra la pantalla de inicio predeterminada antes de que aparezca la primera vista de la aplicación. Existen instrucciones y una API para modificarla. Consulta Pantallas de inicio de Android.
Por defecto, Android utiliza el icono de la aplicación como pantalla de inicio. En las aplicaciones Qt, esto se puede utilizar tal cual, modificarlo para que sirva como pantalla de inicio de la aplicación o combinarlo con la pantalla de inicio de Qt. 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 efectivamente 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» (cajón 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, lanzamos otra actividad, que cuenta con todas las funciones que requiere nuestra aplicación.

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

Para iniciar la pantalla de inicio de Qt, también debemos sobrescribir la clase ` onCreate ` de Android y utilizar un `Intent` para iniciar la `QtActivity`.

package io.qt.qtsplashscreeninandroid;

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 intent = new Intent(SplashActivity.this, QtActivity.class);
                intent.setFlags(Intent.FLAG_ACTIVITY_NO_ANIMATION);
                startActivity(intent);

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

En este ejemplo, la vista principal contiene solo una vista con un botón de salida.

import QtQuick
import QtQuick.Controls

Window {
    visible: true
    title: qsTr("Qt Splash Screen Example")
    color: "#2CDE85"

    Text {
        id: textLabel
        text: "First View"
        anchors.centerIn: parent
    }
    Button {
        id: closeButton
        anchors.horizontalCenter: parent.horizontalCenter
        anchors.top: textLabel.bottom
        anchors.topMargin: 5
        background: Rectangle {
            color: "#00414A"
            radius: 2
        }
        text: "Close"
        contentItem: Text {
            color: "#FFFFFF"
            text: closeButton.text
            horizontalAlignment: Text.AlignHCenter
            verticalAlignment: Text.AlignVCenter
        }
        onClicked: {
            Qt.callLater(Qt.quit)
        }
    }
}

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.