Participa en una serie de seminarios en línea gratuitos que te ayudarán a expandir tu negocio en Google Play. Regístrate ahora

Asegúrate de que tu app sea compatible con dispositivos de 64 bits

A partir del 1 de agosto de 2019, las apps que publiques en Google Play tendrán que ser compatibles con arquitecturas de 64 bits. Las CPU de 64 bits brindan a los usuarios experiencias más enriquecidas y rápidas. Si agregas una versión de 64 bits a tu app, mejorarás su rendimiento, favorecerás la innovación y podrás ofrecerla para dispositivos que cuenten con hardware de 64 bits únicamente.

Esta guía explica los pasos que puedes realizar para asegurarte de que tu app de 32 bits sea compatible con dispositivos de 64 bits.

Evalúa tu app

Si tu app usa únicamente código escrito en el lenguaje de programación Java o Kotlin, incluidas las bibliotecas y SDK, es compatible con dispositivos de 64 bits. Sin embargo, si usa algún código nativo o no sabes con seguridad si lo hace, tendrás que evaluarla y tomar medidas.

¿Tu app usa código nativo?

Lo primero que debes hacer es verificar si tu app usa algún código nativo. Los siguientes casos indican que sí lo hace:

  • Usa cualquier código (nativo) C/C++.
  • Se vincula con alguna biblioteca nativa de terceros.
  • Fue compilada por terceros que usan bibliotecas nativas.

¿Tu app incluye bibliotecas de 64 bits?

La manera más sencilla de encontrar bibliotecas de 64 bits es analizar la estructura del archivo APK. Las bibliotecas nativas que necesita la app se incluyen durante la etapa de diseño del APK y se almacenan en varias carpetas en función de la ABI. No es necesario que la app sea compatible con todas las arquitecturas de 64 bits, pero deberás incluir la arquitectura de 64 bits correspondiente a cada arquitectura nativa de 32 bits con la que sea compatible.

En el caso de la arquitectura ARM, las bibliotecas de 32 bits se encuentran en la carpeta armeabi-v7a. El equivalente para la arquitectura de 64 bits es arm64-v8a.

En el caso de la arquitectura x86, busca x86 para 32 bits y x86_64 para 64 bits.

Lo primero que debes hacer es asegurarte de que se hayan incluido bibliotecas nativas en estas dos carpetas. En resumen:

Plataforma Carpeta de bibliotecas de 32 bits Carpeta de bibliotecas de 64 bits
ARM lib/armeabi-v7a lib/arm64-v8a
x86 lib/x86 lib/x86_64

Ten en cuenta que tal vez no se incluya exactamente el mismo conjunto de bibliotecas en cada carpeta, lo cual depende de tu app. El objetivo es asegurarse de que tu app se ejecute de manera correcta en un entorno solo de 64 bits.

En un caso típico, un APK o paquete diseñado para arquitecturas de 32 y 64 bits tiene carpetas para las dos ABI, y cada una incluye el conjunto de bibliotecas nativas correspondiente. Si no es compatible con la arquitectura de 64 bits, es posible que solo veas una carpeta para la ABI de 32 bits.

Busca bibliotecas nativas que usen APK Analyzer

APK Analyzer es una herramienta que permite evaluar varios aspectos de un APK compilado. En este caso, lo usaremos para buscar bibliotecas nativas y asegurarnos de que haya bibliotecas de 64 bits.

  1. Abre Android Studio y, luego, ingresa a cualquier proyecto.
  2. En el menú, selecciona Build > Analyze APK…

Analiza los lanzamientos con APK Analyzer

  1. Selecciona el APK que quieras evaluar.
  2. Busca los archivos ".so" en la carpeta lib. Si no encuentras ningún archivo ".so" en tu app, significa que está lista y no es necesario que realices ninguna acción. Si encuentras armeabi-v7a o x86, es porque tienes bibliotecas de 32 bits.

  3. Verifica si tienes archivos ".so" similares en las carpetas arm64-v8a o x86_64.

    Analiza los lanzamientos con APK Analyzer

  4. Si no tienes ninguna biblioteca arm64-v8a ni x86_64, deberás actualizar el proceso de compilación para comenzar a compilar y empaquetar los artefactos en tu APK.

  5. Si ves las dos bibliotecas empaquetadas, puedes avanzar al paso Prueba tu app en un dispositivo de 64 bits.

Descomprime los archivos APK para buscar bibliotecas nativas

La estructura de los archivos APK y ZIP es similar, y estos se pueden extraer de la misma manera. Si lo prefieres, puedes usar la línea de comandos o cualquier otra herramienta de extracción para descomprimir los APK.

Descomprime el archivo APK (es posible que debas renombrarlo como .zip en función de la herramienta de extracción que utilices) y sigue las instrucciones que se indican más arriba para buscar los archivos correspondientes y verificar si tu app es compatible con dispositivos de 64 bits.

Por ejemplo, puedes ejecutar las siguientes acciones desde la línea de comandos:

:: Command Line
    > zipinfo -1 YOUR_APK_FILE.apk | grep \.so$
    lib/armeabi-v7a/libmain.so
    lib/armeabi-v7a/libmono.so
    lib/armeabi-v7a/libunity.so
    lib/arm64-v8a/libmain.so
    lib/arm64-v8a/libmono.so
    lib/arm64-v8a/libunity.so
    

Observa la presencia de las bibliotecas armeabi-v7a y arm64-v8a en este ejemplo, lo cual significa que la app es compatible con arquitecturas de 64 bits.

Compila tu app con bibliotecas de 64 bits

A continuación se incluyen instrucciones para compilar bibliotecas de 64 bits. Sin embargo, debes saber que estas indicaciones solo abarcan la compilación de códigos y bibliotecas que puedes procesar desde el código fuente.

Si usas bibliotecas o SDK externos, sigue los pasos que se indican más arriba para asegurarte de que correspondan a versiones de 64 bits. Si no hay versiones de 64 bits disponibles, comunícate con el propietario del SDK o la biblioteca y ten esto en cuenta cuando planifiques la compatibilidad con dispositivos de 64 bits.

Cómo compilar con Android Studio o Gradle

La mayoría de los proyectos de Android Studio usan Gradle como sistema de compilación subyacente; por lo tanto, esta sección se aplica a ambos casos. Habilitar compilaciones para tu código nativo es tan simple como agregar las carpetas arm64-v8a o x86_64 a la configuración de ndk.abiFilters del archivo "build.gradle" de tu app, según las arquitecturas con las que quieras que sea compatible:

// Your app's build.gradle
    apply plugin: 'com.android.app'

    android {
       compileSdkVersion 27
       defaultConfig {
           appId "com.google.example.64bit"
           minSdkVersion 15
           targetSdkVersion 28
           versionCode 1
           versionName "1.0"
           ndk.abiFilters 'armeabi-v7a','arm64-v8a','x86','x86_64'
    // ...
    

Cómo compilar con CMake

Si tu app se compiló con CMake, puedes adaptarla a las ABI de 64 bits. Para ello, debes pasar la carpeta arm64-v8a al parámetro "-DANDROID_ABI":

:: Command Line
    > cmake -DANDROID_ABI=arm64-v8a … or
    > cmake -DANDROID_ABI=x86_64 …
    

Esta opción no tiene ningún efecto cuando se usa externalNativeBuild. Consulta la sección Cómo compilar con Gradle.

Cómo compilar con ndk-build

Si tu app se compiló con ndk-build, puedes adaptarla a las ABI de 64 bits. Para ello, debes modificar el archivo "app.mk" con la variable APP_ABI:

APP_ABI := armeabi-v7a arm64-v8a x86 x86_64
    

Esta opción no tiene ningún efecto cuando se usa externalNativeBuild. Consulta la sección Cómo compilar con Gradle.

Cómo reducir los efectos del aumento de tamaño con Android App Bundle

Si modificas tu app para que sea compatible con la arquitectura de 64 bits, es posible que aumente el tamaño del APK. Te recomendamos que aproveches el formato Android App Bundle para minimizar el impacto si incluyes códigos nativos de 32 y 64 bits en el mismo APK.

Si comienzas a usar los Android App Bundles en tu app, eso puede representar una mejora para el APK, ya que se reducirá el tamaño actual.

Desarrolladores de juegos

Sabemos que el proceso de migración de los motores de juegos de terceros es intenso y puede tomar mucho tiempo. Por suerte, los tres motores más usados son compatibles con la arquitectura de 64 bits:

  • Unreal desde 2015
  • Cocos2d desde 2015
  • Unity desde 2018

Desarrolladores de Unity

Actualiza a las versiones compatibles

Unity comenzó a admitir arquitecturas de 64 bits en las versiones 2018.2 y 2017.4.16.

Si detectas que tienes una versión de Unity que no es compatible con la arquitectura de 64 bits, determina aquella a la que quieras cambiarte y sigue las guías que ofrece Unity para migrar tu entorno. Para esto, debes asegurarte de que tu app pueda compilar bibliotecas de 64 bits. Unity recomienda que actualices tu app a la versión de LTS más reciente del editor para tener acceso a las funciones y actualizaciones más nuevas.

En la siguiente tabla se detallan las distintas versiones de Unity y lo que debes hacer:

Versión de Unity ¿Es compatible con la arquitectura de 64 bits? Acciones recomendadas

2018.4 (LTS)

✔️

Asegúrate de que la configuración de la compilación genere bibliotecas de 64 bits (actualización pendiente).

2018.3

✔️

Asegúrate de que la configuración de la compilación genere bibliotecas de 64 bits.

2018.2

✔️

Asegúrate de que la configuración de la compilación genere bibliotecas de 64 bits.

2018.1

Ofrece compatibilidad experimental con arquitecturas de 64 bits.

2017.4 (LTS)

✔️

Compatible a partir de la versión 2017.4.16. Asegúrate de que la configuración de la compilación genere bibliotecas de 64 bits.

2017.3

✖️

Actualiza a una versión que sea compatible con arquitecturas de 64 bits.

2017.2

✖️

Actualiza a una versión que sea compatible con arquitecturas de 64 bits.

2017.1

✖️

Actualiza a una versión que sea compatible con arquitecturas de 64 bits.

<=5.6

✖️

Actualiza a una versión que sea compatible con arquitecturas de 64 bits.

Asegúrate de que la configuración de la compilación genere bibliotecas de 64 bits

Si usas una versión de Unity compatible con bibliotecas de Android de 64 bits, puedes adaptar la configuración de la compilación para generar una versión de 64 bits de tu app. También tendrás que usar el código IL2CPP como backend de programación (puedes obtener más información aquí). Para configurar tu proyecto de Unity de manera que sea compatible con arquitecturas de 64 bits, sigue estos pasos:

  1. Accede a Build Settings y verifica que aparezca el símbolo de Unity junto a Android para asegurarte de que la compilación sea para esa plataforma.**
    1. De no ser así, selecciona Android y haz clic en Switch Platform.
  2. Haz clic en Player settings.

    Configuración del reproductor en Unity

  3. Ve a Player Settings Panel > Settings for Android > Other settings > Configuration.

  4. Establece el valor de Scripting Backend en IL2CPP.

  5. Selecciona la casilla de verificación **Target Architecture > ARM64.

    Configuración de arquitecturas de destino en Unity

  6. Procesa la compilación de forma habitual.

Ten en cuenta que, cuando realices este proceso para ARM64, tendrás que compilar todos los elementos para esa plataforma específica. Sigue las indicaciones de Unity para reducir el tamaño del APK y considera aprovechar el formato Android App Bundle para reducir los efectos del aumento de tamaño.

Prueba tu app en hardware de 64 bits

La versión de 64 bits de tu app debe ofrecer la misma calidad y el mismo conjunto de funciones que la de 32 bits. Prueba tu app para asegurarte de que los usuarios que tengan los dispositivos de 64 bits más recientes disfruten de la mejor experiencia.

Para comenzar a probar tu app, necesitarás un dispositivo compatible con arquitecturas de 64 bits. Hay muchos dispositivos populares que cuentan con esta característica, como los smartphones de la línea Pixel de Google.

La manera más sencilla de probar tu APK es instalar la app mediante el uso de adb. En la mayoría de los casos, puedes suministrar --abi como parámetro para indicar las bibliotecas que quieres instalar en el dispositivo. De esta forma, se instalará la app solo con bibliotecas de 64 bits.

:: Command Line
    # A successful install:
    > adb install --abi armeabi-v7a YOUR_APK_FILE.apk
    Success

    # If your APK does not have the 64-bit libraries:
    > adb install --abi arm64-v8a YOUR_APK_FILE.apk
    adb: failed to install YOUR_APK_FILE.apk: Failure [INSTALL_FAILED_NO_MATCHING_ABIS: Failed to extract native libraries, res=-113]

    # If your device does not support 64-bit, an emulator, for example:
    > adb install --abi arm64-v8a YOUR_APK_FILE.apk
    ABI arm64-v8a not supported on this device
    

Una vez que la app se haya instalado correctamente, realiza la prueba como lo haces habitualmente para asegurarte de que tenga la misma calidad que la versión de 32 bits.

Publica tu app

Cuando consideres que tu app está lista, publícala de la manera habitual. Como siempre, sigue las recomendaciones para la implementación de tu app. Te aconsejamos que aproveches los segmentos de prueba cerrada para lanzar tu app entre una cantidad limitada de usuarios y garantizar el mismo nivel de calidad.

Asegúrate de haber probado tu app de manera exhaustiva en dispositivos compatibles con arquitecturas de 64 bits antes de publicarla para un segmento de usuarios más amplio, como cuando realizas el lanzamiento de una actualización importante.