DocBit Notes Tutoriales

¿Cómo instalar el archivo .aab oficial de Binance en el teléfono usando bundletool?

Los usuarios comunes descargan el APK «universal» desde el sitio web oficial de Binance, el cual se instala simplemente haciendo doble clic en un administrador de archivos. Sin embargo, los investigadores o desarrolladores pueden obtener en ocasiones un archivo .aab (Android App Bundle), que requiere la herramienta bundletool de Google para poder instalarse en el teléfono. Esta nota proporciona el flujo completo. Los usuarios convencionales no necesitan lidiar con esta ruta; basta con descargar el APK directamente desde el Sitio Oficial de Binance o usar la App Oficial de Binance; para la instalación en iPhone, consulta el tutorial de instalación en iOS.

¿Qué es bundletool?

bundletool es una herramienta de línea de comandos de código abierto oficial de Google, con las siguientes funciones principales:

  • Convertir archivos .aab en .apks (un archivo zip que contiene varios APK divididos o split APKs).
  • Generar un subconjunto de APKs correspondientes a las especificaciones de un dispositivo determinado.
  • Instalar directamente los APKs generados en un dispositivo conectado a través de ADB.
  • Mostrar la estructura interna del .aab para su análisis.

Este conjunto de herramientas es el método de verificación estándar para los desarrolladores antes de subir aplicaciones a Google Play. Para la mayoría de los usuarios, esto no suele ser necesario, a menos que:

  • Quieras estudiar la estructura interna de la APP de Binance.
  • Hayas obtenido un archivo .aab distribuido por terceros.
  • Estés escribiendo scripts de pruebas automatizadas.

Preparativos

Necesitas tener lo siguiente preparado en tu computadora:

Software Propósito
Java JDK 11+ Dependencia de bundletool
bundletool jar Herramienta de línea de comandos open-source de Google
Android SDK Platform Tools (incluye ADB) Comunicación con el dispositivo
Archivo .aab Proveniente de Binance o descompilado por ti
Cable USB Conexión con el teléfono Android

bundletool tiene un tamaño de unos 6-8 MB y se puede descargar desde el repositorio de Google (google/bundletool) en GitHub.

Activar la depuración USB en el dispositivo

Habilita las opciones de desarrollador en el teléfono:

  1. Ajustes → Acerca del teléfono → Toca varias veces el «Número de compilación» (7 veces).
  2. Vuelve a Ajustes → Sistema → Opciones de desarrollador.
  3. Habilita la «Depuración por USB».
  4. Conecta el cable a la computadora y, cuando aparezca el cuadro de autorización, toca «Permitir».

La ruta varía ligeramente según la ROM:

ROM Ubicación para tocar varias veces
MIUI «Versión MIUI»
HarmonyOS «Versión de HarmonyOS»
ColorOS «Número de compilación»
One UI «Número de compilación interna»

El dispositivo debe tener esto activado para que ADB pueda reconocerlo.

Resumen del proceso completo de instalación

Instalar un .aab en el teléfono se divide en cuatro pasos generales:

Paso 1 · Comprobar si el dispositivo es reconocido por ADB Ingresa adb devices en la línea de comandos; si la salida muestra el número de serie de tu teléfono, hay conexión.

Paso 2 · Usar bundletool para generar APKs específicos del dispositivo (device-specific) bundletool consultará el modelo, la arquitectura, el idioma y la densidad de pantalla del dispositivo conectado, y con esos parámetros extraerá el conjunto mínimo de splits del .aab, generando un archivo binance.apks.

Paso 3 · Usar bundletool para instalar los APKs en el dispositivo bundletool incluye el subcomando install-apks, que llamará automáticamente a adb install-multiple para instalar todos los splits juntos.

Paso 4 · Abrir Binance en el teléfono Después de la instalación, la experiencia es idéntica a la de instalar el APK universal.

Los comandos específicos implican parámetros de línea de comandos y son extensos; los desarrolladores pueden consultar la documentación oficial de Google.

Diferencia de tamaño: .aab frente a APK universal

Datos reales para la misma versión (v2.100.5):

Formato Tamaño total de descarga Espacio ocupado instalado
.aab (distribuido en Google Play) No se descarga directamente -
APKs específicos generados del .aab 38-45 MB 130-150 MB
APK universal (sitio oficial de Binance) 96 MB 240 MB

La diferencia radica principalmente en que el universal contiene todas las arquitecturas e idiomas, mientras que el paquete específico para el dispositivo solo tiene lo necesario para ese equipo.

Errores comunes con bundletool

Error 1 · Unsupported tools version La versión de Java no coincide con bundletool. El último bundletool requiere JDK 11+, y el antiguo JDK 8 no es compatible. Solución: actualiza el JDK.

Error 2 · No device connected ADB no reconoció el dispositivo. Comprueba si el modo USB es «Transferencia de archivos» y si has concedido la autorización de depuración.

Error 3 · Multiple devices connected Cuando hay varios dispositivos conectados, debes especificar el número de serie usando el parámetro -s.

Error 4 · Manifest version code is lower than installed El dispositivo ya tiene instalada la misma versión o una más nueva; primero debes desinstalar o incrementar el versionCode.

Error 5 · Insufficient storage El almacenamiento del dispositivo está lleno, libera espacio.

Verificación tras la instalación

Después de instalar, puedes realizar algunas verificaciones:

  • Ver si com.binance.dev aparece en adb shell pm list packages.
  • Abrir la APP para comprobar que el número de versión coincide con lo esperado.
  • Comparar la huella digital de la firma para asegurarse de que coincida con la publicada oficialmente.
  • Ejecutar un flujo de orden en el mercado Spot para confirmar que las funciones van bien.

Escenarios aplicables y no aplicables

Rutas adecuadas para usar bundletool:

  • Investigadores de seguridad que estudian la estructura de la APP.
  • QA (Analistas de Calidad) escribiendo pruebas automatizadas de UI.
  • Desarrolladores que necesitan probar el comportamiento de diferentes splits en varias especificaciones de dispositivos.
  • Estudiantes que aprenden sobre el mecanismo de empaquetado de aplicaciones de Android.

Rutas que no necesitan este método:

  • Usuarios comunes que solo quieren usar Binance con normalidad (basta con bajar el APK universal).
  • Usuarios sin experiencia en ADB y línea de comandos.
  • Dispositivos no estándar como tablets, cajas de TV, etc. (el APK universal ofrece mejor compatibilidad).

Alternativas para novatos en la línea de comandos

Si ver términos como ADB y bundletool te da dolor de cabeza, pero aun así tienes un archivo .aab, aquí hay algunas alternativas más amigables:

  • Usar una interfaz gráfica como SAI (Split APKs Installer), donde copias el .aab y la app lo procesa automáticamente.
  • Usar APKEditor Studio para convertir el .aab en un archivo .apkm e instalarlo.
  • Simplemente abandonar el .aab y descargar el APK universal del sitio web oficial de Binance.

La tercera opción es, de lejos, la más sencilla.

Preguntas Frecuentes (FAQ)

P: ¿Por qué Binance lanza un .aab en lugar de un APK? R: En realidad, el sitio web oficial de Binance promociona principalmente el APK universal para usuarios globales (fuera de las tiendas); el .aab es principalmente para la distribución a través de Google Play.

P: ¿Puedo pasar mis split APKs generados a otra persona para que los use? R: Técnicamente sí, pero los splits están vinculados a las especificaciones del dispositivo. Si se instalan en un equipo diferente, podrían ser incompatibles.

P: ¿Puedo actualizar desde la Play Store después de instalar los APKs generados por bundletool? R: Sí. Play Store verifica el versionCode; siempre que la firma coincida, lo reconocerá como "la misma aplicación" y permitirá actualizar.

P: ¿bundletool modifica el contenido del APK? R: No. Solo desempaqueta el .aab en APKs individuales, sin alterar el código de bytes (bytecode).

Lecturas recomendadas