Publicación en Google Play

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

Configuración de la aplicación

Configura los ajustes de tu aplicación Android utilizando las API de CMake o editando directamente el manifiesto. Las aplicaciones Android requieren varios ajustes en los archivos de compilación AndroidManifest.xml y Gradle. Qt 6 proporciona cómodas APIs CMake para gestionarlas desde tu proyecto.

Establecer las propiedades esenciales de la aplicación

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

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
)

Configurar los iconos de la aplicación

Configure el icono de su aplicación y cree los archivos de icono en los directorios correctos:

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

Coloca tus archivos de iconos en:

<QT_ANDROID_PACKAGE_SOURCE_DIR>/res/drawable-<dpi>

Puede crear archivos de iconos utilizando:

• Qt Creator Android Icon Generator
• Android Studio: Image Asset Studio
• Generadores de iconos Android en línea

Optimice el empaquetado de plugins

Reduzca el tamaño de su aplicación especificando qué plugins incluir. La herramienta androiddeployqt puede incluir plugins 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
)

Documentación relacionada

• Configuración del archivo de manifiesto de Qt para Android
• La herramienta androiddeployqt

Construir tu aplicación

Cree su aplicación para el lanzamiento y prepárela para enviarla a Google Play Console.

Configuración de la compilación de lanzamiento

Google Play requiere versiones de lanzamiento. La información de depuración se puede incluir como archivos separados y se recomienda para una mejor notificación de errores:

qt-cmake -DCMAKE_BUILD_TYPE=Release

Asegúrate de que debuggable está configurado como false en tu manifiesto o en la configuración de Gradle.

Habilitar el soporte multi-ABI

Construye tu aplicación para múltiples arquitecturas de dispositivos para maximizar la compatibilidad:

qt-cmake -DQT_ANDROID_BUILD_ALL_ABIS:BOOL=ON ...

Crear claves de firma

Google Play Console requiere versiones de aplicaciones firmadas. Google recomienda utilizar la firma gestionada de Google Play con dos claves:

• Clave de firma: Generada y gestionada por Google cuando creas tu app en Google Play Console.
• Clave de carga: Se gestiona localmente para firmar los paquetes de aplicaciones que se van a subir.

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>"

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

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 aplicaciones para cada dispositivo.

cd build
cmake --build . --target aab

cmake --build . --target appname_make_aab

Documentación relacionada

• Guía de Google Play App Signing
• Preguntas frecuentes sobre Android App Bundle

Publicación en Google Play Console

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

Preparación para la subida

Antes de subirla:

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

Crea tu aplicación en Google Play Console

1. Accede a Google Play Console
2. Crea una nueva aplicación o selecciona una ya existente
3. Completa los detalles de la aplicación y el cuestionario de clasificación de contenidos
4. Configurar los precios y la distribución

Para crear una cuenta si no tienes una, consulta la guía de configuración de Google Play Console.

Sube tu paquete de aplicaciones

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

Recursos

• Creación y configuración de la aplicación
• Guía de publicación de aplicaciones de Google
• Seminarios web de Google Play Console

Consideraciones especiales

Recopilaciones Single-ABI para proyectos heredados

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

ANDROID_VERSION_CODE = <unique_version>

Considere el uso de un esquema 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 versiones de aplicaciones para obtener más información.