En esta página

Publicación en Google Play

Qt para Android ofrece todo lo necesario para desarrollar, compilar y empaquetar aplicaciones para Android. Esta guía te muestra cómo configurar, compilar y publicar tu aplicación en Google Play Console.

Configuración de tu aplicación

Configura los ajustes de tu aplicación para Android mediante las API de CMake o editando directamente el manifiesto. Las aplicaciones para Android requieren diversos ajustes en el archivo « AndroidManifest.xml » y en los archivos de compilación de Gradle. Qt 6 proporciona prácticas API de CMake para gestionarlos desde tu proyecto.

Establece las propiedades esenciales de la aplicación

Define el nombre del paquete, la versión y los requisitos del SDK de Android de tu aplicación:

set_target_properties(${appname} PROPERTIES
    QT_ANDROID_PACKAGE_SOURCE_DIR "${CMAKE_CURRENT_SOURCE_DIR}/android"
    QT_ANDROID_PACKAGE_NAME "io.qt.calqlatr"
    QT_ANDROID_APP_NAME "Calqlatr"
    QT_ANDROID_TARGET_SDK_VERSION 35
    QT_ANDROID_MIN_SDK_VERSION 28
    QT_ANDROID_VERSION_NAME "1.0"
    QT_ANDROID_VERSION_CODE 10
)

Nota: Comprueba el requisito actual de la versión del SDK de destino de Google Play y configura « QT_ANDROID_TARGET_SDK_VERSION » en consecuencia. Puedes elegir versiones superiores al requisito mínimo.

Configurar los iconos de la aplicación

Establece el icono de tu aplicación y crea los archivos de icono en los directorios correctos:

set_target_properties(${appname} PROPERTIES
    QT_ANDROID_APP_ICON "@drawable/ic_launcher"
)

Coloca los archivos de iconos en:

<QT_ANDROID_PACKAGE_SOURCE_DIR>/res/drawable-<dpi>

Puedes crear archivos de iconos utilizando:

Optimiza el empaquetado de los complementos

Reduce el tamaño de tu aplicación especificando qué complementos incluir. La herramienta androiddeployqt puede incluir complementos que tu aplicación no necesita en tiempo de ejecución:

qt_import_plugins(${appname}
    INCLUDE_BY_TYPE imageformats Qt::QSvgPlugin Qt::QJpegPlugin
    EXCLUDE_BY_TYPE iconengines networkinformation tls platforminputcontexts qmltooling
)

Nota: El comando ` qt_import_plugins ` solo incluye los complementos de las dependencias vinculadas de tu destino.

Compilación de tu aplicación

Compila tu aplicación para su lanzamiento y prepárala para enviarla a Google Play Console.

Configurar la compilación de lanzamiento

Google Play requiere compilaciones de lanzamiento. La información de depuración se puede incluir en archivos independientes, lo cual se recomienda para mejorar los informes de fallos:

  1. Abre tu proyecto en Qt Creator
  2. Selecciona « Projects » en la barra lateral
  3. Elige la configuración de compilación « Release »
qt-cmake -DCMAKE_BUILD_TYPE=Release

Asegúrate de que la opción «debuggable» esté establecida en « false » en tu manifiesto o en la configuración de Gradle.

Habilita la compatibilidad con múltiples ABI

Compila tu aplicación para múltiples arquitecturas de dispositivos con el fin de maximizar la compatibilidad:

  1. Ve a Projects > Build
  2. En los ajustes de configuración de CMake, configura « QT_ANDROID_BUILD_ALL_ABIS » en ON
qt-cmake -DQT_ANDROID_BUILD_ALL_ABIS:BOOL=ON ...

Crear claves de firma

Google Play Console requiere que las versiones de las aplicaciones estén firmadas. Google recomienda utilizar la firma gestionada por Google Play con dos claves:

  • Clave de firma: generada y gestionada por Google al crear la aplicación en Google Play Console
  • Clave de carga: gestionada localmente para firmar los paquetes de la aplicación antes de su carga
  1. Abre Projects > Build
  2. Selecciona Build Android APK
  3. Haz clic en « Create » en Application Signature
  4. Rellena los datos del almacén de claves
  5. Activa Sign package

Consulta «Firmar paquetes de Android » para obtener instrucciones detalladas.

Genera un almacén de claves:
keytool -genkey -keyalg RSA -keystore upload-key.keystore \
    -alias play_apps \
    -storepass <password> -keypass <key-password> \
    -dname "CN=<n>, OU=<unit>, O=<organisation>, L=<city>, ST=<state>, C=<country>"

Habilitar la firma:

qt-cmake -DQT_ANDROID_SIGN_APK:BOOL=ON -DQT_ANDROID_SIGN_AAB:BOOL=ON ...

Configurar las variables de entorno:

export QT_ANDROID_KEYSTORE_PATH=upload-key.keystore
export QT_ANDROID_KEYSTORE_ALIAS=play_apps
export QT_ANDROID_KEYSTORE_STORE_PASS=<password>
export QT_ANDROID_KEYSTORE_KEY_PASS=<key-password>

Generar paquetes de aplicaciones (AAB)

Google Play Console ahora acepta principalmente paquetes de aplicaciones de Android (AAB) en lugar de APK. Los paquetes AAB permiten a Google Play optimizar la entrega de la aplicación para cada dispositivo.

  1. Ve a Projects > Build
  2. Selecciona Build Android APK
  3. En « Advanced Actions », activa Build Android App Bundle
  4. Si lo deseas, activa Open package location after build
  5. Compila tu proyecto

Genera un AAB:

cd build
cmake --build . --target aab

Para un destino específico:

cmake --build . --target appname_make_aab

Tu archivo AAB se guarda en: /<build-path>/android-build-appname/build/outputs/bundle/release/

Publicación en Google Play Console

Después de compilar y firmar tu aplicación, publícala en Google Play Console para su distribución.

Preparación para la subida

Antes de la subida:

  1. Prueba tu aplicación a fondo en diferentes dispositivos y versiones de Android
  2. Prepara materiales promocionales (capturas de pantalla, descripciones, imágenes de las funciones)
  3. Revisa las políticas y directrices de contenido de Google Play

Crea tu aplicación en Google Play Console

  1. Inicia sesión en Google Play Console
  2. Crea una nueva aplicación o selecciona una ya existente
  3. Rellena el cuestionario sobre los detalles de la aplicación y la clasificación de contenido
  4. Configura los ajustes de precios y distribución

Si aún no tienes una cuenta, consulta la guía de configuración de Google Play Console para crear una.

Sube el paquete de tu aplicación

  1. Accede a Release > Production
  2. Crear una nueva versión
  3. Sube tu archivo AAB firmado
  4. Añade las notas de la versión
  5. Revisa y lanza la versión

Recursos

Consideraciones especiales

Compilaciones con un único ABI para proyectos heredados

Para las versiones de Qt que no admiten compilaciones con múltiples ABI (como los proyectos qmake), compila cada arquitectura por separado con códigos de versión diferentes:

ANDROID_VERSION_CODE = <unique_version>

Considera la posibilidad de utilizar un esquema de numeración de versiones como <Platform><ABI><AppVersion>:

  • Plataforma: 1 para Arm, 2 para Intel
  • Arquitectura: 32 para 32 bits, 64 para 64 bits

Ejemplo: la versión 1.0 para arm64-v8a utiliza el código de versión 16410.

Consulta la documentación de Google sobre el control de versiones de aplicaciones para obtener más detalles.

Véase también «Implementación de una aplicación en 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.