Primeros pasos con Qt para Android

El siguiente vídeo es una guía para principiantes sobre el uso de la cadena de herramientas de Qt para Android, incluido el IDE Qt Creator, para empezar a desarrollar aplicaciones Qt para Android.

Para aprender lo básico sobre cómo empezar con Qt para Android, sigue el curso Introducción a Qt para Android en Qt Academy.

El resto de esta página contiene información más detallada.

Para descargar e instalar Qt para Android, siga las instrucciones de la página Introducción a Qt.

Requisitos previos para el desarrollo en Android

Para desarrollar con Qt para Android, necesitarás los siguientes prerrequisitos:

• Kit de desarrollo de Java (JDK)
• Herramientas de línea de comandos de Android que incluye:
  • Android NDK: para construir código C++.
  • Android SDK Platform y Android SDK Build Tools: para construir aplicaciones Android para versiones API específicas.
  • Android SDK Platform Tools: para desplegar y gestionar las dependencias de Android.

La forma más sencilla de gestionar las dependencias es utilizar la configuración de desarrollo de Android integrada en Qt Creator. La primera vez que abra Qt Creator después de instalar Qt para Android, se le preguntará si desea ejecutar el asistente de configuración de Android. Esto también configura OpenSSL para Android.

Usando una localización SDK existente

Si ya tienes un SDK de Android instalado, no necesitas ejecutar este asistente. En su lugar, en Qt Creator vaya a Preferences > Devices > Android y busque sus rutas JDK y SDK existentes. Consulte las rutas comunes del SDK de Android. Para más información, consulte Qt Creator: Configurar el entorno de desarrollo Android.

Instalación manual de los prerrequisitos

Si prefiere instalar manualmente los prerrequisitos siga los siguientes pasos.

Kit de desarrollo de Java (JDK)

El desarrollo de Qt para Android requiere JDK 21 o superior, proporcionado por cualquiera de las siguientes distribuciones compatibles:

• Adoptium
• OpenJDK
• Kit de desarrollo Java SE

Instale su JDK preferido. Si su instalador no establece la variable de entorno JAVA_HOME que apunta a la ubicación del JDK instalado, puede establecerla manualmente. Por ejemplo, en Linux:

sudo apt-get install openjdk-21-jdk
export JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64

O en macOS:

brew install openjdk@21
sudo ln -sfn "$(brew --prefix openjdk@21)/libexec/openjdk.jdk" \
    "/Library/Java/JavaVirtualMachines/openjdk-21.jdk"
export JAVA_HOME="$(/usr/libexec/java_home -v 21)"

Herramientas de línea de comandos del SDK de Android

Descargue la última versión de Android SDK Command Line Tools para su sistema operativo y extráigala en la ruta adecuada, como se indica a continuación.

Rutas del SDK de Android

El SDK de Android se instala normalmente mediante Qt Creator o Android Studio en las siguientes ubicaciones:

• Linux: ~/Android/Sdk/
• macOS: ~/Library/Android/sdk/
• Windows: C:\Users\<USER>\AppData\Local \Android \Sdk \

O utiliza el gestor de paquetes de tu sistema operativo, por ejemplo para macOS:

brew install android-commandlinetools

Paquetes obligatorios del SDK de Android

Asegúrese de instalar el SDK Platform, Platform Tools y Build Tools. Para Qt 6.11, utilice:

sdkmanager "platform-tools" "platforms;android-36" "build-tools;36.0.0"

Android NDK

Qt 6.11 utiliza NDK 27.2.12479018, puedes instalarlo ejecutando:

sdkmanager "ndk;27.2.12479018"

Por ejemplo para macOS:

Emulador

Si desea utilizar el emulador de Android, puede instalarlo ejecutando:

sdkmanager "emulator"

Configuraciones específicas de plataforma

Windows

El controlador USB por defecto en Windows no permite la depuración utilizando la herramienta Android Debug Bridge (ADB). Debe instalar el controlador USB adicional proporcionado por el paquete adicional Android SDK. Instálelo ejecutando lo siguiente:

sdkmanager.bat "extras;google;usb_driver"

Linux

Las siguientes dependencias son necesarias para utilizar herramientas como adb o gdb que pueden ser utilizadas por Qt Creator:

sudo apt-get install libstdc++6 libncurses5

Probar la configuración

Ahora puedes probar tu configuración de desarrollo ejecutando los ejemplos incluidos con la instalación de Qt. Para obtener más información, consulte Mobile Examples.

Para desarrollar una aplicación sencilla desde cero, consulte Qt Creator: Tutorial: Aplicación móvil.