τTau SolutionsHerramientas

Desempaquetado y reempaquetado

Antes conviene leer «Anatomía de un APK»

referencia técnica · Actualizado el 15 de noviembre de 2026

1. Qué es y por qué existe

Un APK es un ZIP, así que cualquier lector de ZIP lo abre, unzip incluido. Abrirlo no es el problema. En el «muestrario» ninguna pieza (un APK) tiene entradas cifradas, nombres repetidos, entradas solapadas ni un método de compresión raro; el medidor recorrió el directorio central de todas. Algunas llevan bytes delante de la primera entrada y se abren igual. Pasa sobre todo en IzzyOnDroid (un 11 % de las piezas) y casi nunca en Google Play. Tres ejemplos, con el primer encabezado local en el byte 132, que zipfile de Python y unzip -l abren sin avisos: com.igg.castleclash 4.5.1 (Google Play, APK de APKMirror), com.hpbr.bosszhipin 1418010 y com.tencent.weread 10167650 (las dos del mercado chino).

Lo que no puedes leer es lo de dentro. AndroidManifest.xml no es XML de texto sino AXML, el XML binario de Android, y el medidor lo leyó así en todas las piezas. resources.arsc es una tabla binaria de recursos y los .xml de res/ están compilados (esto último no lo medimos pieza a pieza). El código está en DEX, el formato del código de Android. Desempaquetar, aquí, es decodificar ese contenido a algo editable. Reempaquetar es el camino inverso. Es la operación central de cualquier modificación, y donde más cosas se rompen.

¿Por qué se rompen? Durante quince años la única forma de reconstruir los recursos ha sido volver a compilarlos con aapt2, la herramienta de Google, que está pensada para construir desde fuentes y no para reconstruir. La decodificación pierde información que aapt2 luego tiene que adivinar. Si adivina mal, el APK sale distinto del original o no sale. La alternativa moderna es no volver a compilar nada: leer los binarios, cambiar lo que haga falta y reescribirlos tal cual. Esa es la línea que separa a apktool de APKEditor, y la que recorre todo el documento. En la práctica, casi todos los fallos de apktool vienen de aapt2: en una submuestra de 117 piezas, seis de los siete fallos fueron de aapt2 al reconstruir («sección 2.8 · Qué esperar de apktool con APK reales»).

2. apktool

La herramienta clásica. Casi todo el ecosistema de interfaces gráficas de Android es un envoltorio suyo.

2.1 Ficha

Dato Valor
Repositorio https://github.com/iBotPeaches/Apktool
Licencia · lenguaje Apache-2.0 · Java
Versión estable 3.0.3, publicada el 20 de julio de 2026
Último push · creado 11 de agosto de 2026 · 19 de marzo de 2012
Tracción 25.265 ★ · 3.980 forks · 77 issues abiertas · no archivado

Está activo y bien mantenido: catorce años de historia, commits del día anterior a la consulta (12 de agosto de 2026, vía la API de GitHub) y una rama 3.x reciente. Tiene 77 issues abiertas frente a las 441 de jadx, señal de que la cola se lleva con disciplina.

Ojo con el salto de 2.x a 3.x: rompió la compatibilidad de flags, y eso arrastró a las interfaces que lo envuelven. APKToolGUI, una de las trece herramientas de la «sección 4 de Comparativa y selección · Las trece herramientas de manipulación de APK», lo anota en su v3.4.0.0, del 4 de junio de 2026: «Fixed invalid flags for Apktool to 3.0.x». APKLab enumera entre sus funciones «Support for Apktool 3.0+ CLI arguments».

2.2 El workflow: d y b

app.apk ──apktool d──▶ app/  ──[editar]──▶ app/ ──apktool b──▶ app/dist/app.apk

Son dos verbos: d/decode pasa de APK a un árbol de ficheros editables y b/build hace el camino inverso. Hay un tercero, if/install-framework, que registra un APK de framework para poder decodificar las apps que dependen de él («sección 2.7 · Ficheros de framework»).

El APK que sale de b no está firmado ni alineado. apktool no firma, por diseño. El ciclo se cierra con las herramientas de «Firma y empaquetado». Saltarse ese paso es el error número uno de quien empieza.

Para 16 KB, además, hay que alinear de nuevo. Desde Android 15 hay teléfonos que cargan la memoria en páginas de 16 KB. Para ellos, una biblioteca nativa (.so) que va sin comprimir dentro del APK tiene que empezar en un múltiplo de 16.384 bytes. apktool b vuelve a escribir el ZIP y no mantiene esas posiciones. El ejemplo es io.github.mority.gloomy 2 (F-Droid; 797.550 bytes), con cuatro .so sin comprimir:

  • En el original empiezan en los bytes 524.288, 540.672, 557.056 y 573.440, todos múltiplos de 16.384. zipalign -c -P 16 4 y zipalign -c 4 responden bien (código de salida 0).
  • Tras apktool d y apktool b el fichero pesa 822.872 bytes. Las cuatro .so siguen sin comprimir y tienen el mismo CRC-32, pero empiezan en 740.280, 747.598, 756.954 y 767.119. Las dos órdenes salen con código 1 (BAD - 3000, 10318, 3290 y 13455).
  • zipalign -P 16 -f 4 lo arregla: la comprobación vuelve a salir con 0.

Es un solo APK: sirve de ejemplo, no de tasa. Los demás no los hemos reconstruido, así que no sabemos cuántos perderían la alineación. Importa porque la mayoría de las apps actuales ya cumple, y reconstruirlas con apktool les haría perder algo que tenían. «Cumple» tiene dos definiciones. La guía de Android pide que todos los segmentos PT_LOAD de la .so tengan p_align de al menos 16.384 y, si las .so no se extraen, que vayan sin comprimir en un múltiplo de 16.384 dentro del ZIP. Entre las apps con .so en lib/arm64-v8a/, eso lo cumplen el 82 % de las de F-Droid y el 86 % de las más instaladas de Google Play. El cargador de Android 17 exige además que no haga falta el modo de compatibilidad, y con ese criterio cumplen el 78 % y el 74 %. El orden correcto es reconstruir, alinear y firmar, con la firma al final (ver «Firma y empaquetado» y «Alineación y zipalign»). Reprodujimos el ejemplo el 31 de octubre de 2026 con apktool 3.0.3 y zipalign de build-tools 37.0.0, sobre una copia (comandos en la fuente 26).

Firmar con otra clave cambia la identidad de la app. Android identifica una app por su paquete y por la clave con que está firmada. Un APK reempaquetado y firmado con tu clave no se instala encima del original: hay que desinstalar este antes, y con él se van sus datos. Android lo rechaza con INSTALL_FAILED_UPDATE_INCOMPATIBLE. Con el muestrario no podemos observarlo, porque no instalamos nada, pero sí se ve la misma idea. De los paquetes que están a la vez en F-Droid e IzzyOnDroid y cuyos ficheros difieren, unos dos de cada tres llevan además otro certificado. Es el caso de app.olauncher 113: el de F-Droid y el de IzzyOnDroid están firmados por claves distintas, así que uno no actualiza al otro. Si la app viene en varias piezas, todas deben llevar la misma clave, y así ocurre en las 454 apps partidas de las más instaladas de Google Play y en las 319 del sorteo.

2.3 Qué produce apktool d

app/
├── AndroidManifest.xml     ← AXML decodificado a XML de texto
├── apktool.yml             ← metadatos para poder reconstruir
├── res/                    ← recursos decodificados: values/, layout/, drawable/…
│   ├── values/strings.xml       (reconstruido desde resources.arsc)
│   ├── values/public.xml        (los resource ID originales, para preservarlos)
│   └── layout/activity_main.xml (AXML decodificado)
├── smali/                  ← classes.dex desensamblado
├── smali_classes2/         ← classes2.dex, y sucesivos con multidex
├── assets/                 ← copiado tal cual
├── lib/                    ← copiado tal cual
├── original/               ← AndroidManifest.xml binario y META-INF originales
└── unknown/                ← todo lo que no encaja en la estructura estándar

Tres directorios merecen comentario. res/values/public.xml guarda la asignación original de resource ID a nombre. Sin él, la recompilación daría identificadores nuevos y el código que referencia un recurso por su número (así lo hace el DEX) apuntaría a otra cosa. Es la pieza frágil de la que depende el round-trip de recursos con aapt2. original/ conserva intactos el AndroidManifest.xml binario y el META-INF/, para el flag --copy-original de b. Y unknown/ recoge las entradas del ZIP que apktool no sabe colocar y las vuelve a meter al reconstruir: un «no entiendo esto, pero no lo pierdo», el mismo principio que se aplica a los chunks desconocidos de resources.arsc.

Casi todas las apps dejan algo en unknown/, así que no te alarmes. Con los patrones de apktool 3.0.3 (una predicción, ver el recuadro de límites de la «sección 1 · Qué es y por qué existe»), le pasa a la base del 97 % de las apps de F-Droid e IzzyOnDroid y del 99 % o más de las de Google Play y el mercado chino. Lo que queda ahí son, casi siempre, metadatos de bibliotecas: META-INF/*.version, kotlin/ o DebugProbesKt.bin en F-Droid, y META-INF/services/ o los play-services-*.properties en Google Play. La lista cambia mucho de una tienda a otra (los play-services-*.properties casi no aparecen en IzzyOnDroid ni en el mercado chino), así que la de F-Droid no vale para Google Play. Que haya cosas en unknown/ no quiere decir que algo se haya roto.

Dos ejemplos. com.termux 1022 (F-Droid) deja 87 ficheros: 47 de META-INF/, 31 de javax/, 7 de kotlin/, DebugProbesKt.bin y 1 de org/. La pieza base.apk del .apkm de com.callapp.contacts 2.150W (APKMirror) deja 68.

2.4 apktool.yml

El fichero de estado que hace posible reconstruir. Sin él, apktool b no sabe qué decisiones tomó el d.

En apktool 3.x el esquema son exactamente nueve campos, los que declara brut.androlib.meta.ApkInfo. No son los mismos que en 2.x, y la diferencia importa porque casi todo lo que circula por foros describe el esquema viejo:

Campo Para qué sirve
version Versión de apktool que hizo el decode
apkFileName Nombre del fichero original
usesFramework Qué frameworks —ids— y con qué tag hacen falta para reconstruir
usesLibrary Paquetes de bibliotecas compartidas de recursos que la tabla resources.arsc pide y que se le dieron a apktool con -l/--lib. Sin esa opción no se escribe. Sustituye al sharedLibrary de 2.x. No son los <uses-library> del manifiesto
sdkInfo minSdkVersion, targetSdkVersion y maxSdkVersion, para repoblarlos en el manifiesto al construir
versionInfo versionCode y versionName, para repoblarlos al construir
resourcesInfo packageId, packageName, sparseEntries, compactEntries, keepRawValues. Absorbe el packageInfo y el sparseResources de 2.x
featureFlags Los elementos <feature-flag> del manifiesto, con su valor. Ninguna pieza del muestrario lleva uno (0 de 15.183)
doNotCompress Qué entradas deben quedar stored y no deflate, por extensión o por ruta (ver abajo)

Una app puede declarar <uses-library> en el manifiesto y no tener nada en usesLibrary: son dos cosas distintas. Lo declaran, en la base, la mitad de las apps de F-Droid y el 95 % de las más instaladas de Google Play, y aun así usesLibrary sale vacío: com.termux 1022 declara dos y su apktool.yml no lo lleva. A usesLibrary lo alimenta el bloque de biblioteca de resources.arsc (RES_TABLE_LIBRARY_TYPE), que es raro: lo tiene la base de un 4 % de las apps más instaladas de Google Play y de casi ninguna de F-Droid. Y hace falta además -l. En el código de apktool 3.0.3, ResTable.resolvePackageGroup solo añade un paquete a la lista si ese bloque lo nombra y se dio un APK de biblioteca con -l/--lib. com.policydm 3.22.1 (APKMirror) tiene ese bloque y, con apktool d sin -l, tampoco escribe usesLibrary (lo reproducimos el 31 de octubre de 2026). Por eso no hay en el muestrario un APK que enseñe los nueve campos juntos sin -l.

Y estos, que sí estaban en 2.x, ya no existen: isFrameworkApk, packageInfo, compressionType, sharedLibrary, sparseResources y unknownFiles. No es que se omitan cuando no hacen falta: no están en el esquema y no pueden emitirse nunca.

El patrón es claro: sdkInfo y versionInfo existen porque la información se pierde en el viaje. aapt2 exige que esos valores se le pasen por parámetro al enlazar, así que apktool los extrae, los guarda y se los devuelve. Es un parche a la asimetría entre decodificar y compilar, y por eso el fichero es crítico: si se corrompe, la reconstrucción produce un APK distinto del original. El campo que más se nota es doNotCompress. Si se pierde, entradas que debían ir sin comprimir (resources.arsc, y las .so cuando extractNativeLibs es false) salen comprimidas, y la aplicación falla al instalar o al cargar sus bibliotecas nativas.

Esa lista existe porque Android espera resources.arsc sin comprimir y alineado a 4 bytes desde targetSdk 30, y las .so sin comprimir y alineadas cuando extractNativeLibs es false. Prácticamente todo el muestrario lo cumple. Con targetSdk 30 o más, resources.arsc solo está fuera de sitio en una app: dudeofx.eval 102 (F-Droid, targetSdk 36), que lo lleva sin comprimir pero en un byte que no es múltiplo de 4. Antes de targetSdk 30 se permitía, y por eso com.chessclock.android 31 (targetSdk 27) no cuenta. Y entre las apps con extractNativeLibs="false" y alguna .so en lib/<abi>/, ninguna tiene una .so comprimida o sin alinear. Ese valor no es raro: lo declaran el 69 % de las apps de F-Droid con .so y el 56 % de las más instaladas de Google Play. Por eso perder doNotCompress al reconstruir sí cambia el resultado: deja de cumplirse algo que hoy cumple casi todo el mundo. Que la app falle al instalar o al cargar sus bibliotecas no lo observamos, porque no instalamos nada.

Y esto es lo que escribe de verdad. Generado con apktool 3.0.3 sobre com.termux 1022 de F-Droid, el 31 de octubre de 2026:

version: 3.0.3
apkFileName: com.termux_1022.apk
usesFramework:
  ids:
  - 1
sdkInfo:
  minSdkVersion: 24
  targetSdkVersion: 28
versionInfo:
  versionCode: 1022
  versionName: 0.119.0-beta.3
resourcesInfo:
  packageId: 127
doNotCompress:
- arsc
- ogg
- png

Siete de los nueve campos: usesLibrary y featureFlags se omiten porque están vacíos. Y unknownFiles no aparece pese a que apktool d dejó 87 ficheros en unknown/, porque en 3.x ese campo ya no existe: el directorio se recoloca al construir recorriéndolo, no leyendo una lista del yml. Si vienes del esquema de 2.x, no busques esa clave. El apkFileName es el nombre del fichero que se le dio a apktool: si lo copias con otro nombre, cambia. Termux 1022 es la misma app que usan otros documentos del sitio, con otra versión (0.119.0-beta.3). Lo único que cambia a la vista son el versionCode y el versionName.

Aquí doNotCompress solo lista extensiones (arsc, ogg, png). Es el caso fácil. Lo habitual es que lleve también rutas: con los patrones de apktool 3.0.3 (otra predicción) lo harían más de ocho de cada diez apps de F-Droid e IzzyOnDroid y el 98 % de las de Google Play y el mercado chino. Y en Google Play son muchas más rutas por app que en F-Droid. Casi todas son perfiles de arranque (.prof, .profm) o metadatos de bibliotecas (.version). Por ejemplo, la pieza base.apk de com.callapp.contacts 2.150W tendría 38 rutas, 36 de ellas de .version.

La regla es esta. Al decodificar, apktool recorre las entradas stored. Si la extensión está entre las que reconoce como naturalmente sin comprimir (dex, arsc, so, png, jpg, ogg, mp3, webp… en NO_COMPRESS_EXT_PATTERN) y la entrada no está vacía, guarda la extensión. Para el resto guarda la ruta completa, y descarta las rutas cuya extensión ya quedó recogida (ApkDecoder.writeApkInfo). Al reconstruir deja stored toda entrada cuya ruta o cuya extensión esté en la lista (ZipUtils.zipDir).

El inventario de campos sale de javap -p brut.androlib.meta.ApkInfo sobre el apktool_3.0.3.jar instalado, más las clases anidadas SdkInfo, VersionInfo, ResourcesInfo y UsesFramework.

2.5 La dependencia de aapt2, que es el origen de casi todos sus fallos

Esta es la sección que explica apktool. apktool b no escribe resources.arsc: escribe XML de texto en un directorio temporal y llama a aapt2 para que los compile y los enlace. La opción --aapt <FILE> permite señalar un binario concreto en lugar del que trae dentro.

De ahí salen tres familias de problemas:

1. aapt2 compila, no reconstruye. Está escrito para transformar fuentes de un proyecto en un APK nuevo. Cuando le pides reproducir un APK existente aplica sus propias reglas: optimiza PNG, normaliza valores, reordena entradas y resuelve referencias a su manera. El resultado funciona parecido, pero es byte a byte distinto: para un editor, es la diferencia entre modificar un fichero y regenerarlo. El APK que sale de b nunca es el mismo fichero. En la submuestra de la «sección 2.8 · Qué esperar de apktool con APK reales», ninguna de las 110 piezas reconstruidas pesa lo mismo que el original; casi todas quedan algo por encima, y alguna llega a pesar más del doble.

2. Lo que apktool no supo decodificar, aapt2 no lo puede recompilar. El error clásico es «resource ... is private». El APK original referencia un recurso del framework marcado como privado. En un binario ya construido eso es legal, pero aapt2 lo rechaza al enlazar, porque su trabajo es impedirlo. También hay fallos con namespaces, atributos desconocidos y frameworks desalineados. Un caso bien documentado es la issue #50 de APKToolGUI, de abril de 2026: un XAPK que con versiones anteriores de la misma app se recompilaba falla con apktool 3.0.1 en aapt2 link («resource android:style/TextAppearance.Material.NumberPicker is private»), y el mantenedor la cerró atribuyéndola a apktool. En la submuestra de la «sección 2.8 · Qué esperar de apktool con APK reales» el recurso privado del framework fue el error de aapt2 más habitual (tres veces). Los otros tres fueron un PNG que no es un PNG, un espacio de nombres XML mal cerrado y un atributo del manifiesto que el framework de apktool aún no conoce (Brave, con targetSdk 37).

3. La versión de aapt2 importa. Las interfaces gráficas que congelan su apktool, y con él su aapt2, se van rompiendo solas con el tiempo sin tocar una línea de código. Es lo que le pasa a APK Editor Studio: su última versión, la v1.7.2 del 19 de enero de 2025, trae apktool 2.11.0, y no ha vuelto a publicar («sección 4.4 de Comparativa y selección · Descargas»).

A veces se cuenta un cuarto problema que no lo es. La issue #3779, «[BUG]Preserve original signature scheme v2, v3, v4 in modded APK», abierta el 23 de enero de 2025 y todavía abierta el 18 de octubre de 2026, pide extraer el APK Signing Block original y volver a insertarlo en el APK modificado. El mantenedor contestó que eso, probablemente, invalida la firma («I would guess that invalidates the signature»). Y así es, por diseño: v2 y v3 firman las entradas del ZIP, su directorio central y el registro de fin de directorio, así que cualquier cambio en el contenido deja sin validez el bloque original («sección 8 de Firma y empaquetado · Qué se rompe si se altera el orden»). No es una carencia de apktool: esa firma no se puede conservar.

Y la firma no es lo único que se pierde. El APK Signing Block (el bloque de firma del APK) también guarda datos de otros, y el APK firmado de nuevo sale sin ellos. Quien reempaqueta no lo nota hasta que una tienda o un análisis los echa en falta. Con la tabla se pueden comparar los orígenes: el sello de Google Play y el frosting están en casi todas las apps de Play, los datos de dependencias destacan en IzzyOnDroid, y los canales de Walle y VasDolly son cosa del mercado chino. Las cifras son de las apps cuya pieza base o única lleva cada par.

Par del bloque F-Droid IzzyOnDroid Play, más instaladas Play, sorteo Mercado chino
Sello de origen (source stamp) de Google Play 0 6 apps 79 % 88 % 0
Frosting de Play (0x2146444e) 0 1 app 76 % 99,7 % 0
Datos de dependencias (0x504b4453), que añade el Android Gradle Plugin 2 % 29 % 7 % 10 % 8 de 100
Canal de Walle o VasDolly 0 0 1 app 0 31 de 100
Alguno de los cuatro 2 % 30 % 89 % 100 % 35 de 100

En el mercado chino, 24 apps llevan canal de Walle y 7 de VasDolly. Ejemplos de la tienda 360: cn.ninegame.gamemanager 80506001 (canal Walle) y com.mfw.roadbook 1148 (canal VasDolly). El detalle de cada identificador está en «El bloque de firma». No hemos reempaquetado ningún APK de Play para comprobar la pérdida con el sello: sale de que apktool y apksigner escriben un bloque nuevo.

Hay otro problema que no sale en ninguna lista porque no lo parece: apktool devuelve código de salida 0 sobre entradas que no entiende. Si le das un .xapk o un .apkm, no protesta, no avisa y no crea smali/. Copia el contenido sin abrir a unknown/ y termina con éxito. Lo medimos con apktool 3.0.3 en dos ejemplos. No son una tasa:

  • Un .xapk de APKPure (la app de multas de la DGT rusa, ru.gibdd_pay.app 6.10): código 0, sin avisos. Deja apktool.yml y un unknown/ con los cuatro APK de dentro (ru.gibdd_pay.app.apk, config.arm64_v8a.apk, config.xxhdpi.apk y config.ru.apk), icon.png y manifest.json.
  • El .apkm de com.callapp.contacts 2.150W: código 0. Solo imprime «Copying original files…» y «Copying unknown files…». Deja apktool.yml con doNotCompress y un unknown/ con base.apk, split_config.xhdpi.apk, icon.png, APKM_installer.url e info.json.

Un .aab no lo pudimos probar: el muestrario no tiene ninguno. Si encadenas apktool d en un guion y compruebas $?, no te enteras de nada.

2.6 -r/--no-res: cuándo salva la papeleta

apktool d -r app.apk -o app/

Con --no-res, apktool no decodifica los recursos: deja resources.arsc y los .xml de res/ en binario y los copia sin tocar al reconstruir, así que aapt2 no interviene. Úsalo cuando solo vayas a tocar código (el caso más común), cuando la decodificación de recursos falle sin arreglo o cuando quieras que los recursos salgan idénticos. Su hermano -s/--no-src hace lo simétrico: no desensambla el DEX, lo copia.

La combinación de los dos es el diagnóstico: si apktool d falla, prueba con -r; si con -r funciona, el problema está en los recursos. Si con -s funciona, está en el código.

Otras opciones que importan del decode (la lista completa está en la fuente 2):

Opción Efecto
-f, --force · -o <DIR> Borra el destino si existe · directorio de salida
--only-manifest Solo el manifiesto. Ojo: --force-manifest, que aún se cita por ahí, no existe en apktool 3.0.3
--keep-broken-res Continúa aunque haya recursos que no se pudieron decodificar
--match-original Los ficheros generados se parecen lo más posible a los originales, a costa de que el resultado ya no se pueda reconstruir («prevents rebuild»)
--no-debug-info baksmali no emite .line, .local ni .param
-a, --all-src Desensambla todos los .dex, incluidos los no estándar
-p <DIR> · -t <TAG> Dónde están los frameworks · cuál usar

-a importa más de lo que parece. Sin él, un .dex que no esté en la raíz con el nombre classes.dex o classesN.dex se copia sin desensamblar y no aparece en smali/. Y no es raro: lo lleva el 39 % de las apps más instaladas de Google Play con algún DEX, frente a casi ninguna de F-Droid e IzzyOnDroid. El caso más repetido es assets/audience_network.dex, de la biblioteca de anuncios Audience Network, de Meta, por ejemplo en com.igg.castleclash 4.5.1 (APKMirror) y, como assets/audience_network/classes.dex, en com.tongitsgo.play (de la web del autor). Con un nombre que no es classesN.dex y en la raíz solo hay 1 de 658 en las más instaladas de Google Play (SafeDKAndroid-m-6.12.7.dex y SafeDKAndroid-s-6.12.7.dex). Donde más pesa es en las apps con empaquetador o protector, porque el código real puede estar en un .dex escondido en assets/: pasa en 3 de las 5 con protector que elegimos a propósito, y en unas cuantas del mercado chino. Por ejemplo, com.lufax.android 8290100 (mercado chino) lleva assets/A3AEECD8.dex, assets/main000/classes.dex y assets/main000/classes2.dex. No hemos ejecutado apktool d -a para comprobar qué hace con ellos.

Y del build:

Opción Efecto
--aapt <FILE> Usa ese binario de aapt2 en lugar del interno
--copy-original Reinyecta el AndroidManifest.xml y el META-INF de original/
--debuggable Añade android:debuggable="true" al manifiesto
--no-crunch No re-optimiza los recursos (evita que aapt2 toque los PNG)
--net-sec-conf · --no-apk · -o <FILE> Network Security Config genérica · no empaqueta · salida

Fíjate en --no-crunch. Sin él, aapt2 recomprime los PNG al reconstruir: cambia bytes que nadie pidió cambiar y el APK engorda o adelgaza sin que puedas preverlo.

2.7 Ficheros de framework

Una aplicación referencia recursos del framework de Android (0x01......) y, en dispositivos de fabricante, de frameworks propios: Samsung, MIUI, HTC. apktool necesita esos APK de framework para resolver los identificadores al decodificar.

apktool if framework-res.apk
apktool if -t miui framework-miui-res.apk
apktool d -t miui app.apk

El -t/--frame-tag permite tener varios juegos de frameworks a la vez, uno por ROM. apktool trae dentro el framework estándar de Android, así que con apps normales de Play no hay que hacer nada. Con apps de sistema sí, y es la causa habitual de que no se decodifiquen.

En la práctica se cumple: en la submuestra de la «sección 2.8 · Qué esperar de apktool con APK reales» (117 piezas) ninguna falló por un framework ausente, y en los apktool.yml revisados usesFramework es ids: [1]. Lo que sí puede pasar es que el framework de dentro esté desfasado. Brave (com.brave.browser, universal arm64, targetSdk 37, de la web del autor) no se reconstruye porque aapt2 no encuentra el atributo android:zygotePreloadNativeLib, que el framework de apktool 3.0.3 no conoce. Esa causa es una lectura del mensaje de error, no una prueba con otro framework. «Normal» tampoco quiere decir «un único paquete de recursos»: la base lleva un ID de paquete distinto de 0x7f en el 4 % de las apps más instaladas de Google Play, y en casi ninguna de los demás grupos. Un ejemplo es la pieza base.apk del .apkm de shareit.lite 3.9.38 (APKMirror), con ID de paquete 125 y 127 y un bloque de biblioteca. El ID 127 del yml es el 0x7f de aapt2: el mismo número en decimal y en hexadecimal. La frase de los frameworks de fabricante (Samsung, MIUI, HTC) se queda sin comprobar, porque el muestrario no trae aplicaciones de sistema.

2.8 Qué esperar de apktool con APK reales

Si desempaquetas y reempaquetas un APK de verdad, ¿funciona? Casi siempre, sí. Pasamos apktool 3.0.3 por 117 apps del muestrario, una pieza base o única por app, las primeras de cada fuente por SHA-256 sin repetir paquete: primero d y, si terminó, b sobre el resultado. Cada orden tuvo 900 segundos y 5.734 MB de memoria Java. «Termina bien» quiere decir que sale con código 0; no instalamos ni ejecutamos nada. Son muestras pequeñas de cada fuente, no una muestra aleatoria, y no se suman ni se extrapolan.

Grupo apktool d termina bien apktool b termina bien tras un d bueno Ciclo completo
F-Droid, 25 piezas 25 de 25 25 de 25 25 de 25
IzzyOnDroid, 15 15 de 15 15 de 15 15 de 15
Google Play, más instaladas, 25 25 de 25 24 de 25 24 de 25
Google Play, sorteo, 20 20 de 20 19 de 20 19 de 20
Mercado chino, 20 19 de 20 17 de 19 17 de 20
Webs de los autores, 7 7 de 7 6 de 7 6 de 7
Protectores (a propósito), 5 5 de 5 4 de 5 4 de 5

Tres lecturas. Primera: casi todo termina. Segunda: los fallos son pocos, y seis de los siete son de aapt2 al reconstruir. Tres son por un recurso privado del framework (una pieza de Google Play más instaladas, una del sorteo y una de protectores), uno por un PNG que no es un PNG, uno por un espacio de nombres mal cerrado y uno, en Brave, por un atributo que el framework de apktool aún no conoce. El séptimo es una excepción de apktool al decodificar. Tercera: lo que sale no es el mismo fichero. Ninguna de las 110 piezas reconstruidas pesa lo mismo que el original. La mayoría queda muy cerca (la mediana es 1,007 veces el original), pero los extremos van de 0,776 a 2,625.

Los fallos, con su pieza y su mensaje:

  • com.vivo.easyshare 7.1.1.7 (Google Play, APKMirror): b falla con resource android:style/Preference.RingtonePreference is private.
  • com.fudme.cambridgepizza, pieza base.apk (sorteo, carpeta de adb): b falla con resource android:style/TextAppearance.Material.Notification.Reply is private.
  • com.ifeng.newvideo 73440 (mercado chino): b falla con failed to read PNG signature: file does not start with PNG signature. en res/drawable/share_image_bottom.png.
  • com.xingin.xhs 9510803 (mercado chino): b falla con must not undeclare prefix. en res/layout-en/APKTOOL_RENAMED_0x7f0c10bf.xml.
  • Brave, universal arm64 (web del autor): b falla con attribute android:zygotePreloadNativeLib not found.
  • com.ss.android.ugc.aweme.lite 400901 (mercado chino): d falla con NullPointerException: Cannot invoke "String.isEmpty()". Es el único que no pasa por aapt2.
  • com.taobao.qianniu 5882 (mercado chino) es el extremo de tamaño: la reconstruida pesa 833.817.917 bytes frente a 317.683.670 del original, 2,625 veces.

No probamos -r ni -s sobre los siete fallos, así que «si con -r funciona, el problema está en los recursos» («sección 2.6 · -r/--no-res: cuándo salva la papeleta») sigue sin medida.

2.9 Apps con protector comercial (y el mercado chino)

Un protector comercial es un programa que envuelve la app para que no se pueda leer: deja a la vista un cargador pequeño y esconde el código real, cifrado, en assets/ o en una biblioteca nativa. apktool d no lo desmonta: desensambla el cargador.

Es, sobre todo, cosa del mercado chino: lo llevan 38 de sus 100 apps, frente al 2 % de las más instaladas de Google Play y ninguna de F-Droid, IzzyOnDroid ni las webs de los autores. La cifra es la de la heurística estática de composición del sitio, que no cuenta PairIP («sección 3.7 · Los puntos ciegos»). Las cinco de protectores las elegimos por tener uno, y no entran en ninguna proporción. En el mercado chino manda Bangcle/SecNeo (21 apps), seguida de lejos por Ijiami (7). Ejemplos de la tienda 360: com.cubic.choosecar 26080316 (Bangcle/SecNeo), com.corp21cn.mail189 185 (Ijiami) y com.jzzs.ParentsHelper 1006033 (Jiagu 360). Las familias se explican en el bloque de «Packers y protectores».

Las apps del mercado chino traen más sorpresas para quien desempaqueta. Casi un tercio lleva un canal de Walle o de VasDolly en el bloque de firma, que se pierde al firmar de nuevo («sección 2.5 · La dependencia de aapt2, que es el origen de casi todos sus fallos»). Algunas llevan un .dex fuera de la raíz, y todas dejan entradas en unknown/, a veces miles.

Apktool no se queja de los protectores: en las cinco piezas de protectores de la submuestra de la «sección 2.8 · Qué esperar de apktool con APK reales», d terminó bien en las cinco y el ciclo completo en cuatro. Lo que no sabemos, porque no ejecutamos ninguna, es si la app reconstruida arranca. Los protectores de hoy esconden el código en vez de romper la herramienta.

2.10 Lo que desempaquetar no te da

No todas las apps tienen su código en el DEX. Las hechas con Flutter, React Native, Unity y otros marcos llevan la lógica fuera: en libapp.so, en assets/index.android.bundle, en libil2cpp.so y global-metadata.dat, o en una carpeta assets/www. En ellas, apktool d solo te da el smali de una envoltura fina, y quien empieza no entiende por qué «no ve el código». Una app «lleva» un marco si tiene una prueba fuerte: una biblioteca de lib/<abi>/, una entrada del ZIP o un paquete entre los 40 más poblados de algún DEX. Llevar un marco no quiere decir que toda la app esté hecha con él (Facebook e Instagram, por ejemplo, llevan React Native en algunas pantallas).

Es más frecuente de lo que parece: en F-Droid le pasa a una de cada seis apps, y en el sorteo de Google Play y en el mercado chino, a más de la mitad. Por marco:

Marco F-Droid IzzyOnDroid Play, más instaladas Play, sorteo Mercado chino
Flutter 11 % 11 % 5 % 18 % 17 de 100
React Native 2 % 1 % 8 % 10 % 25 de 100
Unity 0 0 17 % 23 % 13 de 100

Flutter pesa en F-Droid, Unity en Google Play y React Native en el mercado chino. Ejemplos, uno por marco: ace.software.pocketsense 5022 (F-Droid) es Flutter y lleva libflutter.so, assets/flutter_assets/AssetManifest.bin y libapp.so; Housing 15.2.3 (APKPure) es React Native; y com.JindoBlu.Antistress 11.4.3 (APKMirror) es Unity. En «Código nativo» se cuenta cómo mirar dentro de esas bibliotecas. No hemos abierto ninguna libapp.so ni ningún bundle para este documento.

3. APKEditor

La alternativa moderna, y la referencia funcional de la categoría.

3.1 Ficha

Dato Valor
Repositorio https://github.com/REAndroid/APKEditor
Licencia · lenguaje Apache-2.0 · Java (JAR ejecutable, Java 8+)
Versión estable V1.4.9, publicada el 19 de mayo de 2026
Último push · creado 19 de mayo de 2026 · 9 de diciembre de 2022
Tracción 2.269 ★ · 402 forks · 36 issues abiertas · no archivado

Está activo, con un matiz. Al consultarlo (12 de agosto de 2026, vía la API de GitHub), el último push coincidía con la última release: llevaba casi tres meses sin commits. El 4 de octubre de 2026 volvió a haber push. La cadencia histórica es buena, con cinco versiones en nueve meses, de la V1.4.5 (13 de agosto de 2025) a la V1.4.9; el hueco es reciente. Sus releases suman 537.561 descargas el 18 de octubre de 2026 (454.000 en la evaluación de la «sección 4.4 de Comparativa y selección · Descargas»). Su descripción propia lo resume: «Powerful android apk editor - aapt/aapt2 independent».

3.2 Los seis comandos

Comando Alias Qué hace
decode d Decodifica los recursos binarios a JSON, XML o crudo
build b Reconstruye el binario desde JSON, XML o crudo
merge m Fusiona splits de un directorio o de un XAPK, APKM o APKS
refactor x Renombra los recursos ofuscados a nombres legibles
protect p Ofusca los recursos del APK
info — Vuelca metadatos: manifiesto, permisos, actividades, firmas, locales, xmltree

Es la superficie de línea de órdenes más amplia del ecosistema, y la única apta para CI y automatización de las trece herramientas de la «sección 4.2 de Comparativa y selección · Cuántas tienen modo desatendido de verdad»: las demás son interfaces gráficas, extensiones de editor o consolas de menú.

3.3 decode: los tipos de salida

El flag -t selecciona el modo, y la diferencia importa:

Tipo Qué produce Cuándo usarlo
xml Recursos decodificados a XML de texto, estilo apktool Editar recursos a mano
json Recursos volcados a JSON, con la estructura de la tabla expuesta Automatizar; es el más fiel a la estructura real
raw Los binarios tal cual, sin decodificar Round-trip garantizado; solo se toca lo que se toca
sig Los ficheros de firma Conservar la firma por separado

El modo raw responde de frente al problema de la «sección 2.5 · La dependencia de aapt2, que es el origen de casi todos sus fallos»: si no se decodifica, no hay que recompilar, y nada se pierde por el camino. El modo json expone la tabla de recursos como estructura de datos y no como XML reconstruido. Es una decisión de diseño distinta de la de apktool, y bastante más honesta con el formato.

Otras opciones relevantes: -f fuerza el borrado del destino, -framework indica ficheros de framework, -res-dir configura el nombre del directorio de recursos, -dex-lib internal|jf elige la biblioteca de DEX, -comment-level controla el detalle de los comentarios de baksmali, -load-dex fija cuántos DEX se cargan en memoria a la vez, -no-cache salta la caché y -clean-meta elimina META-INF y firmas.

El README del propio proyecto admite que el valor por defecto de -load-dex 3 sacrifica la corrección de la jerarquía de clases para no agotar la memoria. Tenlo presente al leer su salida de smali. (Esa frase del README no la hemos vuelto a leer.)

Cuánto importa depende de dónde venga la app. Con más de tres DEX en la base, el valor por defecto deja de cargarlos todos a la vez. En F-Droid e IzzyOnDroid casi nunca pasa (un 4 %), pero sí en el 72 % de las más instaladas de Google Play, donde lo normal son seis DEX por app. No hemos probado APKEditor con ellas.

3.4 merge: lo que nadie más hace bien

java -jar APKEditor.jar m -i app.xapk -o app-completo.apk

Acepta un directorio de splits, un .apks, un .xapk o un .apkm, y produce un APK único instalable. Por el camino fusiona las tablas de recursos, sanea los atributos de split del manifiesto y controla extractNativeLibs.

Los atributos que hacen que Android no instale una base suelta son tres. android:requiredSplitTypes (en <manifest>) lista los tipos de split que hacen falta. android:isSplitRequired (en <application>) dice que sin splits la app no funciona. Y la meta-data com.android.vending.splits.required hace lo mismo para Google Play. En las apps partidas de Google Play casi todas las bases llevan requiredSplitTypes y la meta-data de Play; isSplitRequired en <application> es mucho más raro. Los APK sueltos de APKPure con la misma base no llevan ninguno de los tres. Según la documentación de APKEditor, merge los sanea para que el APK resultante se instale solo; no lo hemos comprobado.

Las piezas de una misma app comparten paquete, versionCode y certificado, sin excepción en el muestrario. Lo que merge tiene que reconciliar son las rutas repetidas entre piezas con distinto tamaño descomprimido (una cota inferior, porque no comparamos el CRC). Siempre está el manifiesto; a menudo, resources.arsc (tres de cada cuatro apps partidas) y los ficheros de firma v1 de META-INF/; y, en pocos casos, el código. En res/, lib/, assets/ y otras rutas no hay conflictos. Ojo también con extractNativeLibs: en la base de esas apps vale false algo más de la mitad de las veces y true casi en el resto. La tasa de éxito de merge no la hemos medido, porque no hemos ejecutado APKEditor. Ejemplos de bases con atributos de split: air.conectagames.tute, pieza base.apk (sorteo, carpeta de adb), con requiredSplitTypes="base__abi,base__density" y 5 piezas, y org.fixer.martiallaw, pieza base.apk (sorteo, carpeta de adb), con isSplitRequired en <application> y un asset pack (split_installTime.apk).

Es el estándar de facto de la operación. De las trece herramientas de la «sección 4.1 de Comparativa y selección · Quién fusiona splits y quién decompila a Java», las otras que fusionan lo hacen con APKEditor por dentro («Merge XAPK/APKS/ZIP/APKM using APKEditor.jar», dice el README de APKToolGUI), y AntiSplit-M, una aplicación de Android que fusiona en el propio dispositivo (4.900 ★), se presenta como «a simple GUI implementation of Merge utilities from REAndroid APKEditor» y lleva ARSCLib-1.3.9.jar en app/libs/. El proceso completo, con sus casos difíciles, está en «Fusión de splits».

3.5 refactor y protect

refactor deshace el acortamiento de rutas y nombres de recursos. Cuando se han acortado las rutas de los ficheros de res/ (lo que produce las rutas res/aM.xml de la «sección 5.2 · dump: los subcomandos de inspección»; la orden aapt2 optimize --shorten-resource-paths hace justo eso) o se han plegado los nombres de los recursos (--collapse-resource-names), refactor recupera nombres legibles. Es el único de las trece herramientas de la «sección 4 de Comparativa y selección · Las trece herramientas de manipulación de APK» que lo hace.

Las rutas cortas no son una rareza ni vienen de R8, que no toca los recursos. Las tienen (alguna ruta de res/ sin carpeta de tipo) más de ocho de cada diez apps de F-Droid e IzzyOnDroid, y bastantes menos en Google Play. Incluso entre las apps de F-Droid que no usan R8 son el 72 %, frente al 95 % entre las que sí lo usan. La relación existe, pero no es una causa: las apps que usan R8 suelen compilarse en modo release con las mismas opciones. Los nombres de recurso plegados, en cambio, son raros en todas partes. Quién activa estas opciones en cada app no lo hemos medido, ni tampoco qué reconstruye refactor en cada caso.

protect hace lo contrario: es un ofuscador propio de recursos y DEX, con niveles de 0 a 5 y una opción confuse-zip. Tiene un efecto secundario documentado en su issue #213, abierta el 27 de octubre de 2025 y sin respuesta del mantenedor: los APK pasados por protect los bloquea Google Play Protect aunque el original no lo estuviera.

3.6 Por qué no necesita aapt2, y qué implica

APKEditor lee y escribe resources.arsc y AXML directamente, con su propia biblioteca (ARSCLib, «sección 4 · ARSCLib: la biblioteca de debajo»). No hay compilación intermedia ni XML de texto de por medio salvo que se pida. Cuatro consecuencias:

  1. Reconstruye APK que apktool corrompe. Es el motivo declarado por el que la gente migra. Con apktool, en la submuestra de 117 apps de la «sección 2.8 · Qué esperar de apktool con APK reales», 6 no se reconstruyeron y todas fallaron en aapt2. No hemos puesto a prueba APKEditor con esas mismas apps, así que no sabemos si las habría reconstruido. La issue #228 de APKLab, abierta en marzo de 2026 por un usuario y no por el proyecto, pide integrarlo porque «para muchos APK que fallan al reconstruir con Apktool, APKEditor a menudo funciona sin corromper recursos». Un miembro del proyecto respondió el 9 de mayo de 2026 que lo añadirá, de momento solo para los splits.
  2. No hereda los errores de aapt2. Los «resource is private» y los conflictos de namespace de la «sección 2.5 · La dependencia de aapt2, que es el origen de casi todos sus fallos» sencillamente no ocurren.
  3. No depende de la versión del SDK instalado. Un JAR y Java 8; nada más.
  4. Puede hacer round-trip. Lo que no toca, no cambia, y eso es lo que lo convierte en un editor y no en un regenerador. Es lo que afirma el proyecto; nosotros no lo hemos medido.

3.7 Los puntos ciegos

  • No firma y no alinea. Por diseño: es un motor. Tras merge o build hay que encadenar apksigner o uber-apk-signer a mano, y el flujo no se cierra.
  • No decompila a Java. Solo smali.
  • Issue #211, abierta en septiembre de 2025 y todavía sin resolver: alrededor de veinte aplicaciones fusionadas desde Play caen con segfault en libpairipcore.so en Android 14 y 15. El mantenedor respondió el mismo día y lo atribuye al antimanipulación de PairIP, no al merge («any change on the apk could trigger such crash»), así que el límite real no es de APKEditor: es que la fusión no puede sortear una verificación de integridad. Afecta a las aplicaciones protegidas con PairIP (cuántas hay, más abajo).
  • Issue #213, la de Play Protect de la «sección 3.5 · refactor y protect», esa sí sin respuesta del mantenedor.
  • Bus factor de 1. Mismo autor que ARSCLib, del que depende por completo. Documentación limitada a --help y soporte por Telegram, sin trazabilidad pública.

Lo que más dice del mantenimiento es que las dos siguen abiertas un año después, el 18 de octubre de 2026. El mantenedor contesta (en la #211, en poco más de una hora), pero los fallos difíciles se quedan sin resolver.

Cuántas apps llevan PairIP. PairIP es una protección que Google Play inserta en el APK que entrega: en los ficheros no se ve quién la pidió. Tiene dos formas, con libpairipcore.so (la máquina virtual, la que da el fallo de la issue #211) o solo con las clases com.pairip.*, que comprueban la licencia. Solo aparece en Google Play: en el 7 % de las apps más instaladas y en el 27 % del sorteo. Pero lo que rompe la fusión de la issue #211 es libpairipcore.so, y esa es bastante más rara: 33 de las 658 más instaladas y 2 de las 369 del sorteo. El resto lleva solo las clases de la comprobación de licencia. Una sola foto no basta para decir que sean «cada vez más»: dice cuántas hay hoy. Las tres piezas con PairIP de la submuestra de la «sección 2.8 · Qué esperar de apktool con APK reales» (una con libpairipcore.so y dos solo con clases) completan apktool d y apktool b. No ejecutamos ninguna, y que la issue #211 se repita en dispositivo tampoco lo hemos verificado. Dos ejemplos: la pieza base.apk del .apkm de net.zedge.android 9.40.1 (con libpairipcore.so) y la pieza base.apk de com.xtremecar.dodgecharger (carpeta de adb, solo clases).

PairIP no es la única comprobación de integridad. Una app también puede leer su propia firma o pedir a Google Play una verificación de integridad. Entonces el APK reempaquetado, que lleva otra firma, puede abrirse y cerrarse solo. Las referencias en el DEX a Play Integrity o a SafetyNet (com.google.android.play.core.integrity.*, com.google.android.gms.safetynet.*) son cosa de Google Play: están en el 39 % de las apps más instaladas y casi en ninguna de las demás fuentes. Leer la firma es mucho más corriente (PackageInfo.signatures o signingInfo, Signature.toByteArray, SigningInfo.getApkContentsSigners, hasSigningCertificate): aparece en la gran mayoría de las apps de todas las fuentes. Tener la llamada en el código no prueba que la app se compruebe a sí misma, ni que la llamada sea de la propia app y no de una biblioteca. Cuántas apps de Play se darían por perdidas al reempaquetar no lo podemos decir, porque no ejecutamos ninguna reconstruida.

3.8 Qué contenedores vas a encontrar y qué hace merge con cada uno

merge recibe lo que descargas, y eso tiene tres formas en el «muestrario». El detalle de cada formato está en «AAB, splits y contenedores».

  • .apkm, de APKMirror (388 en el muestrario, todos de Google Play). Es un ZIP con info.json, icon.png, APKM_installer.url, los APK (base.apk y los split_*.apk) y una firma META-INF/APKMIRRO.* que firma el contenedor y no la app; esos cuatro elementos están en los 388. La mediana es de 12 piezas por contenedor (de 3 a 36 en el 80 % central; máximo 125). Ejemplo: com.whatsapp 2.26.42.9, con 35 entradas: 29 APK, de ellos 17 módulos de idioma, y 6 de metadatos y firma.
  • .xapk, casi todos de APKPure (72 en el muestrario: 71 de APKPure y 1 de APKCombo). Lleva manifest.json (en los 72), icon.png (en 58) y los APK sin prefijo, como org.telegram.messenger.apk y config.arm64_v8a.apk. La mediana es de 3 piezas (de 2 a 20 en el 80 % central; máximo 22). Ejemplo: Telegram 13.1.0 (APKPure).
  • Carpeta de adb, la que se saca de un teléfono con adb pull: solo base.apk y split_*.apk, sin metadatos (365 en el muestrario, todas del sorteo de Google Play). La mediana es de 4 piezas (de 1 a 7). Ejemplo: air.conectagames.tute, con base.apk y cuatro splits.

Ninguno de los 460 contenedores (388 .apkm y 72 .xapk) lleva toc.pb: no hay ningún APK Set de bundletool. Cada formato tiene sus casos raros. Dos .apkm traen un .obb en la raíz, como el de com.ea.game.pvz2_row 13.5.1, con main.1063.com.ea.game.pvz2_row.obb. Un .obb es un fichero de datos que no forma parte del APK. Lo esperable es que, al fusionar, el .obb quede fuera y la app lo busque en Android/obb/<paquete>/; no hemos ejecutado merge, así que no lo hemos comprobado.

Algunas apps traen además asset packs (splits sin código, con datos en assets/, que se instalan con la app) y módulos de funcionalidad (una parte de la app que se descarga aparte y sí puede llevar código). Solo los hemos visto en Google Play, y en pocas apps: algún asset pack en el 8 % de las más instaladas y el 5 % del sorteo, y algún módulo en el 7 % y el 1 %. Donde más módulos hay es en los .apkm.

Una advertencia sobre las carpetas: las 365 salen de un único teléfono (arm64_v8a, xxhdpi, idiomas en y es). Lo que dicen sobre qué splits entrega Google Play describe ese teléfono, no a Google Play en general.

4. ARSCLib: la biblioteca de debajo

https://github.com/REAndroid/ARSCLib — Apache-2.0, Java, creado el 14 de noviembre de 2021, último push el 1 de julio de 2026, 402 ★ · 81 forks · 18 issues abiertas. Consultado el 12 de agosto de 2026 vía la API de GitHub. Su descripción: «Android binary resources read/write library».

Es la pieza que resuelve el problema estructural del documento: leer y escribir los formatos binarios de recursos de Android sin aapt2. APKEditor es la línea de órdenes; ARSCLib es el motor, y también el de AntiSplit-M y de varias herramientas más.

Importa por dos cosas. Demuestra que el enfoque funciona, con cinco años en producción. Y su tamaño da la medida de lo complejo que es el problema: solo el paquete com.reandroid.arsc, la parte de tabla de recursos y AXML, son 241 ficheros Java en la rama main. El detalle del formato está en «Tabla de recursos» y «XML binario».

5. aapt2

La herramienta oficial de Google. Está instalada en la máquina de referencia y todo lo de esta sección lo ejecutamos de verdad. Rehicimos los volcados de la «sección 5.2 · dump: los subcomandos de inspección» el 31 de octubre de 2026 con aapt2 2.20-15087165 (build-tools 37.0.0) sobre ficheros del «muestrario», salvo chunks y la «sección 5.4 · apkanalyzer», que usan un APK mínimo hecho para la prueba, no del muestrario.

BT=~/Library/Android/sdk/build-tools/37.0.0
$BT/aapt2 version
Android Asset Packaging Tool (aapt) 2.20-15087165

Los dos verbos que construyen. compile toma un fichero de recurso del proyecto y produce un .flat intermedio; link toma todos los .flat y produce el resources.arsc y el APK.

compilecompilelinklinklinkres/values/strings.xmlvalues_strings.arsc.flatres/layout/main.xmllayout_main.xml.flatAndroidManifest.xmlAPK

La separación existe por velocidad de compilación incremental. Los otros subcomandos son dump, diff, optimize, convert y daemon. Este par no interesa para el análisis: interesa para construir desde fuentes, que es lo que hace Gradle. Lo que sí interesa, y mucho, es dump.

5.2 dump: los subcomandos de inspección

aapt2 dump <subcomando> fichero.apk [opciones], con --no-values, --file <fichero> y -v como opciones transversales.

Subcomando Qué imprime
badging Lo extraído del manifiesto: paquete, versiones, SDK, permisos, actividades, densidades
packagename Solo el nombre de paquete
permissions Los permisos declarados y usados
configurations Todas las configuraciones que hacen variar algún recurso
resources La tabla de recursos completa
chunks La tabla de recursos chunk a chunk: tipo, chunkSize y headerSize de cada uno, string pool con sus flags, paquete, typeSpec, type y cada entrada con su valor
strings El string pool de la tabla de recursos
xmltree Un AXML como árbol
xmlstrings Los strings de un AXML compilado
styleparents Los padres de los estilos
overlayable Los recursos sobreescribibles
apc El contenido de un contenedor .flat de compilación

badging, la primera orden de cualquier análisis. Sobre com.termux 1022 (F-Droid):

BT=~/Library/Android/sdk/build-tools/37.0.0
MUESTRARIO=<carpeta del muestrario>
$BT/aapt2 dump badging $MUESTRARIO/fdroid/com.termux_1022.apk | head -22
package: name='com.termux' versionCode='1022' versionName='0.119.0-beta.3' platformBuildVersionName='11' platformBuildVersionCode='30' compileSdkVersion='30' compileSdkVersionCodename='11'
install-location:'internalOnly'
minSdkVersion:'24'
targetSdkVersion:'28'
uses-permission: name='android.permission.ACCESS_NETWORK_STATE'
…
uses-permission: name='com.android.alarm.permission.SET_ALARM'
application-label:'Termux'

Salida recortada: entre medias van otros quince uses-permission (la app declara diecisiete). Con head -20 la salida acabaría en el permiso 16 y no llegaría a application-label; por eso head -22. Una app de Google Play suele traer además líneas split, uses-feature y native-code; se ven con una carpeta de adb del muestrario.

packagename, y por qué no hay que fiarse del nombre del fichero.

$BT/aapt2 dump packagename $MUESTRARIO/fabricantes/com.dywx.larkplayer/Click_to_install_Larkplayer_officialsite.apk
com.dywx.larkplayer

El nombre del fichero no es una fuente fiable. Este se llama Click_to_install_Larkplayer_officialsite.apk (de la web del autor) y el paquete es com.dywx.larkplayer: el nombre lo puso el autor de la web. Pasa con todos los ficheros de las webs de los autores del muestrario y con todos los de APKPure: Pou_1.4.139_APKPure.apk es me.pou.app. F-Droid, IzzyOnDroid, APKMirror y la tienda 360 sí nombran por paquete, sin excepciones. (Quedan fuera del recuento las 365 carpetas de adb y los 40 ficheros de china/tencent-manual/, porque los nombramos nosotros.) Es la misma lección que dejan las extensiones de los contenedores: la identidad se lee de dentro.

configurations, el inventario de variantes. Sobre org.fossify.math 10 (F-Droid e IzzyOnDroid; 7.047.681 bytes):

$BT/aapt2 dump configurations $MUESTRARIO/fdroid/org.fossify.math_10.apk | head -20

w600dp
h480dp
h720dp
sw600dp
watch
night
large
xlarge
ldrtl
v27
v28
v29
v31
night-v31
v34
v35
port
w360dp-port
w400dp-port

La primera línea vacía es la configuración por defecto. En total hay 170 configuraciones más, que van de las densidades y los tamaños de pantalla a las versiones de Android. Es exactamente lo que hay que saber para decidir qué splits de configuración hacen falta al fusionar.

xmltree, el manifiesto con los identificadores de atributo. Sobre com.termux 1022 (el mismo de badging):

$BT/aapt2 dump xmltree $MUESTRARIO/fdroid/com.termux_1022.apk --file AndroidManifest.xml | head -15
N: android=http://schemas.android.com/apk/res/android (line=2)
  E: manifest (line=2)
    A: http://schemas.android.com/apk/res/android:sharedUserId(0x0101000b)="com.termux" (Raw: "com.termux")
    A: http://schemas.android.com/apk/res/android:versionCode(0x0101021b)=1022
    A: http://schemas.android.com/apk/res/android:versionName(0x0101021c)="0.119.0-beta.3" (Raw: "0.119.0-beta.3")
    A: http://schemas.android.com/apk/res/android:sharedUserLabel(0x01010261)=@0x7f1000d9
    A: http://schemas.android.com/apk/res/android:installLocation(0x010102b7)=1
    A: http://schemas.android.com/apk/res/android:compileSdkVersion(0x01010572)=30
    A: http://schemas.android.com/apk/res/android:compileSdkVersionCodename(0x01010573)="11" (Raw: "11")
    A: package="com.termux" (Raw: "com.termux")
    A: platformBuildVersionCode=30
    A: platformBuildVersionName=11
      E: uses-sdk (line=10)
        A: http://schemas.android.com/apk/res/android:minSdkVersion(0x0101020c)=24
        A: http://schemas.android.com/apk/res/android:targetSdkVersion(0x01010270)=28

Son las 15 primeras líneas. Aquí sharedUserId va primero y package va casi al final. Fíjate en los 0x0101.... entre paréntesis: son los resource ID del framework para cada atributo, y así es como el AXML los guarda de verdad. El nombre legible lo resuelve aapt2 consultando su tabla del framework, y un lector propio tiene que hacer lo mismo; el mecanismo está en «XML binario». Los atributos sin identificador, como package, no pertenecen al espacio de nombres de Android y viajan solo por nombre.

resources, la tabla, y las rutas acortadas. Sobre org.fossify.math 10, el mismo fichero que en configurations:

$BT/aapt2 dump resources $MUESTRARIO/fdroid/org.fossify.math_10.apk | head -12
Binary APK
Package name=org.fossify.math id=7f
  type anim id=01 entryCount=40
    resource 0x7f010002 anim/abc_grow_fade_in_from_bottom
      () (file) res/aM.xml type=XML
    resource 0x7f010003 anim/abc_popup_enter
      () (file) res/k_.xml type=XML
    resource 0x7f010004 anim/abc_popup_exit
      () (file) res/UX.xml type=XML
    resource 0x7f010005 anim/abc_shrink_fade_out_from_bottom
      () (file) res/5T.xml type=XML

Aquí se ve el resource ID con su estructura 0xPPTTEEEE (paquete 7f, tipo 01, entrada) y, sobre todo, el acortamiento de rutas de recursos: el nombre lógico (anim/abc_popup_enter) se conserva, pero el fichero se llama res/k_.xml. En este APK, 754 de las 967 entradas de res/ (78 %) tienen una ruta corta así. No es un caso raro sino lo normal en F-Droid («sección 3.5 · refactor y protect»). Es justo el material sobre el que trabaja refactor de APKEditor.

strings, el tamaño del problema. Sobre el mismo APK, la primera línea de $BT/aapt2 dump strings $MUESTRARIO/fdroid/org.fossify.math_10.apk | head -1 dice:

String pool of 31667 unique UTF-8 non-sorted strings, 31667 entries and 78 styles using 1369084 bytes:

31.667 cadenas y 1.369.084 bytes en una calculadora. Los 1.369.084 bytes son el tamaño del chunk de ese string pool (el 38 % de los 3.572.644 bytes de su resources.arsc). Es mucho: la app típica de F-Droid tiene unas 4.000 cadenas en el string pool global. La línea confirma además tres cosas que un escritor de resources.arsc tiene que reproducir exactamente: codificación UTF-8 (la de todas las apps más instaladas de Google Play), pool no ordenado y 78 estilos asociados. Los estilos son la parte más delicada del round-trip byte-exacto, y no son raros: los lleva el pool global de la mitad de las apps más instaladas de Google Play.

chunks, la tabla tal como está escrita. La ayuda lo describe como «Print the chunk information of the compiled resources.arsc in the APK». Lo ejecutamos el 18 de octubre de 2026 sobre un APK mínimo hecho para la prueba, no del muestrario, construido con aapt2 compile y aapt2 link (dos cadenas en res/values/strings.xml):

$BT/aapt2 dump chunks minima.apk
[ResTable_header] chunkSize: 608 headerSize: 12 Package count: 1
  [RES_STRING_POOL_TYPE] chunkSize: 56 headerSize: 28 strings: 2 styles 0 flags: UTF-8|NON-SORTED
  #0 : Hola
  #1 : Mínima
  [ResTable_package] chunkSize: 540 headerSize: 288 id: 0x7fname: com.ejemplo.minima typeStrings: 288 lastPublicType: 0 keyStrings: 336 lastPublicKey: 0 typeIdOffset: 0
    [RES_STRING_POOL_TYPE] chunkSize: 48 headerSize: 28 strings: 1 styles 0 flags: UTF-16|NON-SORTED
    #0 : string
    [RES_STRING_POOL_TYPE] chunkSize: 56 headerSize: 28 strings: 2 styles 0 flags: UTF-8|NON-SORTED
    #0 : app_name
    #1 : saludo
    [RES_TABLE_TYPE_SPEC_TYPE] chunkSize: 24 headerSize: 16 id: 0x01 types: 1 entry configs: 2
…
    [ResTable_type] chunkSize: 124 headerSize: 84 id: 0x01 name: string flags: 0x00 (DENSE) entryCount: 2 entryStart: 92 config: 
      [ResTable_entry] id: 0x0000 name: app_name keyIndex: 0 size: 8 flags: 0x0000
        [Res_value] size: 8 dataType: 0x03 data: 0x00000001 ("Mínima")
…
[End]

Salida recortada: hemos quitado la máscara de calificadores del typeSpec y la segunda entrada. Es el volcado más cercano al fichero de todos los de dump: tamaños y cabeceras de cada chunk, la codificación de cada string pool (el de tipos sale en UTF-16 y los otros dos en UTF-8) y si el type es denso o disperso. Para comprobar un escritor de resources.arsc, es lo que hay que comparar chunk a chunk con el original; la estructura que imprime está en «Tabla de recursos».

La combinación del ejemplo es la corriente: el string pool global va en UTF-8 y, de los de tipos y claves, solo uno va en UTF-16. Lo cumplen nueve de cada diez apps o más en todas las fuentes. En org.fossify.math 10 y en com.termux 1022, el pool en UTF-16 es el de tipos (20 y 19 cadenas): el global y el de claves están en UTF-8. Que sea el de tipos en todas las apps no lo hemos medido; solo contamos cuántos pools van en cada codificación.

5.3 Por qué reimplementar aapt2 está fuera de alcance para cualquiera

No es cuestión de esfuerzo sino de superficie. aapt2 incluye el crunch de PNG con su formato propio de nine-patch, la pseudolocalización, la generación de feature splits, la compilación de todos los tipos de recurso con sus reglas de validación, los overlays, el modo daemon y la compatibilidad con todo el histórico de niveles de API. Reproducirlo es un trabajo del tamaño del propio aapt2. La vía correcta es no necesitarlo, y eso es lo que hizo ARSCLib.

Lo que sí hay que hacer con aapt2 es usarlo como oráculo: si escribes un resources.arsc y aapt2 dump resources lo lee y devuelve lo mismo que el original, tu escritor funciona.

5.4 apkanalyzer

La otra herramienta oficial de inspección. No viene en build-tools sino en las Command-Line Tools del SDK (android_sdk/cmdline-tools/<versión>/bin/apkanalyzer), y es la línea de órdenes del APK Analyzer de Android Studio. Sintaxis: apkanalyzer [opciones globales] sujeto verbo [opciones] apk [apk2]. Las cinco órdenes que más sirven al analizar:

Orden Qué hace
dex packages El árbol de clases del DEX: paquetes, clases, métodos y campos (P, C, M, F), marcados como definidos, referenciados, conservados o eliminados (d, r, k, x). Acepta --defined-only y --proguard-mappings <fichero>
files list Todos los ficheros del APK
apk download-size Una estimación del tamaño de descarga
manifest print El manifiesto en XML de texto
apk compare Compara los tamaños de dos APK, entrada a entrada. Con --different-only, --files-only y --patch-size

Lo ejecutamos el 18 de octubre de 2026 con cmdline-tools 19.0 sobre el APK mínimo de la «sección 5.2 · dump: los subcomandos de inspección» y una copia a la que añadimos el classes.dex de la «sección 4 de Desensambladores smali · .registers sobre código real»:

A=~/Library/Android/sdk/cmdline-tools/latest/bin/apkanalyzer
$A dex packages minima-dex.apk | head -6
$A apk compare minima.apk minima-dex.apk
P d 2	3	148	<TOTAL>
C d 2	2	140	Saldo
M d 1	1	38	Saldo <init>()
M d 1	1	52	Saldo int retirar(int,boolean)
F d 0	0	10	Saldo int saldo
P r 0	1	8	java
1259	1899	640	/
0	490	490	/classes.dex
608	608	0	/resources.arsc
408	408	0	/AndroidManifest.xml

apk compare da, por entrada, el tamaño en el primer APK, en el segundo y la diferencia: aquí, los 490 bytes que ocupa dentro del ZIP el classes.dex añadido. Compara tamaños, no contenido. apk download-size sobre la copia con DEX devolvió 1348.

6. bundletool

La herramienta oficial para AAB y APK Set. Está disponible en la máquina de referencia, así que también la ejecutamos de verdad. java -jar bundletool.jar version devuelve 1.18.3, publicada el 15 de diciembre de 2025 según la API de GitHub, consultada el 12 de agosto de 2026.

6.1 dump

Inspecciona un AAB sin desempaquetarlo. fixture.aab es un bundle mínimo que generamos a propósito con bundletool build-bundle 1.18.3. No forma parte del «muestrario», que no tiene ningún .aab: el .aab es lo que sube el desarrollador, no lo que llega al teléfono.

java -jar bundletool.jar dump manifest --bundle fixture.aab
<manifest xmlns:android="http://schemas.android.com/apk/res/android" android:compileSdkVersion="36" android:compileSdkVersionCodename="16" android:versionCode="1" android:versionName="1.0" package="com.ejemplo.fixture" platformBuildVersionCode="36" platformBuildVersionName="16">
  <uses-sdk android:minSdkVersion="24" android:targetSdkVersion="36"/>
  <uses-permission android:name="android.permission.INTERNET"/>
  <application android:extractNativeLibs="false" android:icon="@drawable/ic_fixture" android:label="@string/app_name">
    <activity android:exported="true" android:name=".MainActivity">
      …
    </activity>
  </application>
</manifest>

Salida recortada: hemos quitado el intent-filter y las líneas en blanco que bundletool intercala entre cada elemento al convertir desde protobuf. Con --xpath se extrae un valor suelto, que es lo que sirve para scripts: --xpath /manifest/@android:versionCode devuelve 1. Los otros objetivos de dump son resources y config.

6.2 validate

java -jar bundletool.jar validate --bundle fixture.aab
App Bundle information
------------
Feature modules:
	Feature module: base
		File: res/drawable-xxhdpi-v4/ic_fixture.png
		…
		File: lib/arm64-v8a/libtermux.so
		File: lib/x86_64/libtermux.so
		File: dex/classes.dex

Comprueba la estructura del bundle y lista sus módulos. Fíjate en dex/classes.dex: dentro de un AAB el DEX vive bajo dex/, no en la raíz como en un APK.

6.3 build-apks

Convierte el AAB en un APK Set. Este fixture.apks lo generamos en local y sin firmar; tampoco es del muestrario:

java -jar bundletool.jar build-apks \
  --bundle=fixture.aab \
  --output=fixture.apks --overwrite
WARNING: The APKs won't be signed and thus not installable unless you also pass a keystore via the flag --ks. See the command help for more information.

El aviso sale porque la máquina de referencia no tiene ~/.android/debug.keystore. Sin --ks, bundletool firma con la clave de depuración si ese fichero existe («attempts to sign your APKs with a debug key», dice su documentación). Solo si no existe deja los APK sin firmar, y por tanto sin poder instalarse. Para distribuir hay que pasarle --ks, --ks-pass, --ks-key-alias y --key-pass en cualquier caso. Y esto es lo que hay dentro del APK Set resultante:

unzip -l fixture.apks | head -12
Archive:  fixture.apks
  Length      Date    Time    Name
---------  ---------- -----   ----
     3166  01-01-1981 01:01   toc.pb
    25551  01-01-1981 01:01   splits/base-arm64_v8a.apk
    25551  01-01-1981 01:01   splits/base-arm64_v8a_2.apk
    25551  01-01-1981 01:01   splits/base-arm64_v8a_3.apk
    23037  01-01-1981 01:01   splits/base-armeabi_v7a.apk
     1283  01-01-1981 01:01   splits/base-de.apk
…

Tres observaciones que no salen en la documentación. Primera: la marca de tiempo 01-01-1981 01:01 es constante en todas las entradas del ejemplo, porque bundletool normaliza las fechas para que la salida sea reproducible. Pero no sirve como huella de bundletool: la llevan todas las piezas de las apps partidas de Google Play del muestrario, y también casi nueve de cada diez APK sueltos de F-Droid, que no pasan por bundletool. Un ejemplo suelto es com.zinaro.cachecleanerwidget 1 (F-Droid), con las 6 entradas fechadas 1981-01-01 01:01:02. Otro, dentro de un contenedor, es la pieza base.apk del .apkm de com.callapp.contacts 2.150W. El .apkm entero, en cambio, tiene fechas reales.

Segunda: los sufijos _2 y _3 son variantes del mismo split para distintos rangos de nivel de API, que es cómo el APK Set cubre la matriz completa de dispositivos. Tercera: toc.pb en la raíz es la tabla de contenidos en Protocol Buffers que distingue un APK Set genuino de un ZIP plano de splits con la extensión puesta a mano. En el muestrario no hay ningún APK Set: ninguno de los 460 contenedores (388 .apkm y 72 .xapk) lo lleva. Un .apkm se reconoce por info.json y su firma META-INF/APKMIRRO.*; un .xapk, por manifest.json.

6.4 extract-apks

Selecciona del APK Set los splits que corresponden a un dispositivo. No hace falta el dispositivo: basta un fichero de especificación escrito a mano.

cat > pixel.json <<'EOF'
{
  "supportedAbis": ["arm64-v8a"],
  "supportedLocales": ["es", "en"],
  "screenDensity": 420,
  "sdkVersion": 34
}
EOF

java -jar bundletool.jar extract-apks --apks=fixture.apks \
  --output-dir=extracted --device-spec=pixel.json
ls extracted/
The APKs have been extracted in the directory: extracted
base-arm64_v8a_3.apk
base-es_3.apk
base-master_3.apk
base-xxhdpi_3.apk

De las decenas de splits del APK Set han quedado cuatro: el maestro, la ABI, el idioma y la densidad. El sufijo _3 confirma que ha elegido la variante del rango de API que corresponde a sdkVersion 34. Esta es la operación que hay que replicar para fusionar splits, y verla funcionar con un JSON de cuatro campos deja muy claro el modelo mental. Como extra, get-size total --apks=fixture.apks --device-spec=pixel.json devuelve 8381,8381: el tamaño de descarga mínimo y máximo para ese dispositivo. (Es una cifra del fixture local con esa especificación; no la volvimos a medir.)

Eso es lo que hace Google Play de verdad, y el muestrario tiene el resultado. air.conectagames.tute trae cinco APK sacados con adb:

  • base.apk, 51.584.785 bytes.
  • split_config.arm64_v8a.apk, el de la ABI, 5.330.067 bytes.
  • split_config.en.apk y split_config.es.apk, los de idioma, 41.369 y 29.081 bytes.
  • split_config.xxhdpi.apk, el de densidad, 986.838 bytes.

Las 365 carpetas del muestrario salen del mismo teléfono (arm64_v8a, xxhdpi, idiomas en y es): lo que dicen describe ese teléfono, no a Google Play en general.

6.5 get-device-spec e install-apks, contra un dispositivo real

Sin adb en el PATH, bundletool se planta antes de empezar:

java -jar bundletool.jar get-device-spec --output=devspec.json
[BT:1.18.3] Error: Unable to determine the location of ADB. Please set the --adb flag or define ANDROID_HOME or PATH environment variable.

Se resuelve con --adb <ruta>. Lo ejecutamos el 13 de agosto de 2026 contra un emulador Android 14 arm64-v8a:

PT=~/Library/Android/sdk/platform-tools
java -jar bundletool.jar get-device-spec --adb=$PT/adb --output=devspec.json
python3 -m json.tool devspec.json | head -8
{
    "supportedAbis": [ "arm64-v8a" ],
    "supportedLocales": [ "en-US" ],
    "deviceFeatures": [ … 89 entradas … ],
    "glExtensions": [ … 53 entradas … ],
    "screenDensity": 420,
    "sdkVersion": 34
}

Doce campos en total: a los seis de arriba se suman sdkRuntime, ramBytes, buildBrand, buildDevice, socManufacturer y socModel. Los cuatro que deciden qué splits se instalan son supportedAbis, supportedLocales, screenDensity y sdkVersion; el resto solo entra en juego si el bundle declara condiciones por deviceFeatures. Por eso el fichero escrito a mano de cuatro campos de la «sección 6.4 · extract-apks» funciona igual de bien.

Con una salvedad: esos cuatro campos deciden los splits de configuración (ABI, idioma, densidad). Un bundle también reparte módulos de funcionalidad y asset packs, y esos van por otras reglas. Son minoría, pero existen: en el muestrario los llevan menos de una de cada diez apps más instaladas de Google Play («sección 3.8 · Qué contenedores vas a encontrar y qué hace merge con cada uno»). Un asset pack de ejemplo es split_installTime.apk en org.fixer.martiallaw (pieza base.apk, sorteo) y split_assetPackInstallTime.apk en com.gachitech.space_flex (pieza base.apk, sorteo).

Y la instalación completa, de una sola orden, que exige un APK Set firmado: el de la «sección 6.3 · build-apks», generado sin --ks y sin ~/.android/debug.keystore, sale sin firmar (apksigner verify responde DOES NOT VERIFY sobre base-master.apk, fuente 11) y Android no lo instala.

java -jar bundletool.jar install-apks --adb=$PT/adb --apks fixture.apks
$PT/adb shell pm path com.ejemplo.fixture

pm path lista los splits que llegaron al dispositivo. Con un emulador en en-US y un fixture que solo trae splits de idioma de, es y fr, la selección por idioma de la «sección 6.4 · extract-apks» no deja ninguno: lo esperable es el maestro, la ABI y la densidad, con las cadenas del maestro (no hemos podido repetir la instalación con un APK Set firmado; ver el recuadro de límites de la «sección 1 · Qué es y por qué existe»). Ojo, porque un fusionador que asuma «siempre hay un split por dimensión» se equivoca aquí. Y el caso «falta una dimensión» es corriente: de las 365 carpetas del muestrario (todas del sorteo de Google Play), cuatro de cada diez no tienen split de idioma, y una de cada siete es solo el base.apk. Por ejemplo, com.kidzoye.parentalcontrol trae el base, el de ABI y el de densidad, y ninguno de idioma. Reinstalar esa carpeta con adb install-multiple y comprobarla con pm path sería una prueba válida; no la hemos hecho.

7. Qué usar según lo que vayas a hacer después

Quiero… Herramienta Por qué
Solo mirar el manifiesto y los permisos aapt2 dump badging Instantáneo, no desempaqueta nada
Inventariar densidades, idiomas y ABI aapt2 dump configurations Da la lista exacta
Leer un AXML cualquiera aapt2 dump xmltree --file Resuelve los nombres de atributo del framework
Editar código y reempaquetar apktool con -r El smali es su punto fuerte; -r evita los fallos de aapt2
Editar recursos y reempaquetar APKEditor decode -t xml + build Sin aapt2, sin corrupción
Garantizar round-trip byte a byte APKEditor decode -t raw No decodifica, no puede perder
Fusionar splits APKEditor merge Es el estándar de facto
Reconstruir un APK que apktool corrompe APKEditor Es el motivo por el que existe
Convertir un AAB en APK instalables bundletool build-apks Es el único que convierte AAB
Elegir splits para un dispositivo concreto bundletool extract-apks Con --device-spec, sin dispositivo
Decompilar a Java Ninguna de estas «Decompiladores a Java»
Firmar lo que salga de cualquiera de ellas Ninguna de estas «Firma y empaquetado»
Dejar una app lista para 16 KB tras reconstruirla zipalign -P 16 4 y después apksigner apktool b no mantiene la alineación («sección 2.2 · El workflow: d y b»)
Reempaquetar una app protegida con un protector comercial Ninguna de estas Se desempaqueta el cargador, no el código («sección 2.9 · Apps con protector comercial (y el mercado chino)»)

La fila que más importa es la última: ni apktool ni APKEditor ni bundletool cierran el ciclo. Los tres producen un APK que hay que firmar aparte. bundletool, sin --ks, como mucho lo firma con la clave de depuración, que no sirve para distribuir. Y no basta con firmar: hay que alinear (zipalign) y tener claro que firmar con otra clave cambia la identidad de la app («sección 2.2 · El workflow: d y b»).

Fuentes

Todas las URL se consultaron el 12 de agosto de 2026, salvo donde se indica otra fecha.

  1. Apktool — repositorio oficial — https://github.com/iBotPeaches/Apktool Vía https://api.github.com/repos/iBotPeaches/Apktool y /releases/latest. Licencia, versión 3.0.3 del 20 de julio de 2026, push del 11 de agosto de 2026 y recuentos de la ficha 2.1.
  2. Apktool — CLI Parameters — https://apktool.org/docs/cli-parameters/ De aquí salen íntegras las tablas de opciones de decode, build e install-framework de las secciones «2.6» y «2.7», con la redacción de cada flag.
  3. APKEditor — repositorio oficial — https://github.com/REAndroid/APKEditor Vía la API de GitHub y /releases/latest. Licencia, versión V1.4.9 del 19 de mayo de 2026 y recuentos de la «sección 3.1 · Ficha».
  4. APKEditor — README — https://raw.githubusercontent.com/REAndroid/APKEditor/master/README.md Los seis comandos de la «sección 3.2 · Los seis comandos», los tipos de decodificación xml/json/raw/sig y las opciones de la «sección 3.3 · decode: los tipos de salida», y la declaración de independencia de aapt2.
  5. ARSCLib — repositorio oficial — https://github.com/REAndroid/ARSCLib Vía la API de GitHub. Licencia, fecha de creación, push del 1 de julio de 2026 y recuentos de la «sección 4 · ARSCLib: la biblioteca de debajo». Los 241 ficheros Java de src/main/java/com/reandroid/arsc/ salen de git/trees/HEAD?recursive=1 sobre la rama main, consultado el 18 de octubre de 2026.
  6. aapt2 — documentación oficial de Android — https://developer.android.com/tools/aapt2 La lista de subcomandos y la tabla completa de subcomandos de dump con sus opciones --no-values, --file y -v de la «sección 5.2 · dump: los subcomandos de inspección».
  7. bundletool — documentación oficial de Android — https://developer.android.com/tools/bundletool Las opciones de build-apks, extract-apks, install-apks y get-device-spec, y el formato del fichero de especificación de dispositivo de la «sección 6.4 · extract-apks».
  8. bundletool — release 1.18.3 — https://api.github.com/repos/google/bundletool/releases/latest El número de versión y su fecha de publicación, el 15 de diciembre de 2025.
  9. apktool 3.0.3 ejecutado localmente — instalado con Homebrew el 13 de agosto de 2026 y ejecutado el 31 de octubre de 2026 sobre com.termux 1022 del muestrario. De aquí salen el apktool.yml real de la «sección 2.4 · apktool.yml», con sus siete claves, y los 87 ficheros de unknown/. apktool --version devuelve 3.0.3.
  10. iBotPeaches/Apktool, issue #3779 — https://github.com/iBotPeaches/Apktool/issues/3779 Consultada el 13 de agosto de 2026 y de nuevo el 18 de octubre de 2026 con gh api, con sus comentarios. De aquí salen el título, la fecha de apertura, el estado abierto, lo que pide —reinsertar el APK Sig Block 42 original en un APK modificado— y la respuesta de iBotPeaches del 27 de enero de 2025 de la «sección 2.5 · La dependencia de aapt2, que es el origen de casi todos sus fallos».
  11. bundletool y apksigner ejecutados localmente — el 25 de septiembre de 2026, con bundletool 1.18.3 y apksigner de build-tools 37.0.0, sobre un .aab mínimo (el fixture.aab local, que no es del muestrario). Sin --ks y sin ~/.android/debug.keystore, build-apks avisa de que no firmará y apksigner verify responde DOES NOT VERIFY sobre base-master.apk; con un debug.keystore presente, lo firma y verifica. De aquí sale que el fixture.apks de la «sección 6.3 · build-apks» no se instala («sección 6.5 · get-device-spec e install-apks, contra un dispositivo real»).
  12. Apktool 3.0.3 — ApkDecoder.java y ZipUtils.java — https://github.com/iBotPeaches/Apktool/blob/v3.0.3/brut.apktool/apktool-lib/src/main/java/brut/androlib/ApkDecoder.java y https://github.com/iBotPeaches/Apktool/blob/v3.0.3/brut.j.util/src/main/java/brut/util/ZipUtils.java Consultados el 18 de octubre de 2026 sobre el tarball de la etiqueta v3.0.3. De aquí sale cómo se rellena y se aplica doNotCompress en la «sección 2.4 · apktool.yml»: NO_COMPRESS_EXT_PATTERN, writeApkInfo y el predicado de zipDir.
  13. aapt2 2.20-15087165 ejecutado localmente — el 18 de octubre de 2026, aapt2 dump --help y aapt2 dump chunks sobre un APK mínimo generado con aapt2 compile y aapt2 link contra el android.jar de platforms/android-36.1. De aquí salen la fila de chunks de la tabla de la «sección 5.2 · dump: los subcomandos de inspección» y su volcado.
  14. apkanalyzer — documentación oficial de Android — https://developer.android.com/tools/apkanalyzer Consultado el 18 de octubre de 2026 (página actualizada el 5 de marzo de 2026). De aquí salen la ubicación en cmdline-tools, la sintaxis y las descripciones de las cinco órdenes de la «sección 5.4 · apkanalyzer».
  15. apkanalyzer ejecutado localmente — el 18 de octubre de 2026, cmdline-tools 19.0, sobre el APK mínimo de la fuente 13 y una copia con un classes.dex añadido. De aquí salen las salidas de dex packages, apk compare y apk download-size de la «sección 5.4 · apkanalyzer».
  16. APKToolGUI — release v3.4.0.0 e issue #50 — https://github.com/AndnixSH/APKToolGUI/releases/tag/v3.4.0.0 y https://github.com/AndnixSH/APKToolGUI/issues/50 Consultadas el 18 de octubre de 2026 con gh api. De la release, del 4 de junio de 2026, sale el «Fixed invalid flags for Apktool to 3.0.x» de la «sección 2.1 · Ficha»; de la issue, abierta el 5 de abril de 2026 y cerrada por AndnixSH el 3 de mayo con «The issue is coming from Apktool», el registro con apktool 3.0.1 y el error de aapt2 link de la «sección 2.5 · La dependencia de aapt2, que es el origen de casi todos sus fallos».
  17. APKLab — README e issue #228 — https://github.com/APKLab/APKLab#readme y https://github.com/APKLab/APKLab/issues/228 Consultados el 18 de octubre de 2026 con gh api. Del README sale el «Support for Apktool 3.0+ CLI arguments» de la «sección 2.1 · Ficha»; de la issue, abierta el 31 de marzo de 2026 por un usuario, la cita de la «sección 3.6 · Por qué no necesita aapt2, y qué implica» («For many APKs that fail to rebuild after being processed by Apktool, APKEditor often works seamlessly without resource corruption») y la respuesta de surendrajat, miembro del proyecto, del 9 de mayo de 2026.
  18. REAndroid/APKEditor, issues #211 y #213 — https://github.com/REAndroid/APKEditor/issues/211 y https://github.com/REAndroid/APKEditor/issues/213 Consultadas el 18 de octubre de 2026 con gh api, con sus comentarios. La #211 se abrió el 27 de septiembre de 2025 a las 15:51 UTC y REAndroid respondió a las 16:59 atribuyendo el fallo a PairIP; la #213 se abrió el 27 de octubre de 2025 y sus cuatro comentarios son de usuarios. Las dos siguen abiertas (secciones «3.5» y «3.7»).
  19. APKEditor — releases — https://api.github.com/repos/REAndroid/APKEditor/releases Consultado el 18 de octubre de 2026. De aquí salen las fechas de la V1.4.5 a la V1.4.9, la suma de 537.561 descargas de sus ficheros y el push del 4 de octubre de 2026 de la «sección 3.1 · Ficha».
  20. APK Editor Studio — release v1.7.2 — https://github.com/kefir500/apk-editor-studio/releases/tag/v1.7.2 Consultada el 18 de octubre de 2026. De sus notas sale el «Updated default Apktool to 2.11.0» de la «sección 2.5 · La dependencia de aapt2, que es el origen de casi todos sus fallos».
  21. AntiSplit-M — README y árbol del repositorio — https://github.com/AbdurazaaqMohammed/AntiSplit-M Consultados el 18 de octubre de 2026 vía la API de GitHub. De aquí salen su descripción como interfaz de las utilidades de fusión de APKEditor, el app/libs/ARSCLib-1.3.9.jar y sus 4.900 estrellas («sección 3.4 · merge: lo que nadie más hace bien»).
  22. apktool — página de apktool.yml — https://apktool.org/docs/the-basics/apktool-yml Devolvía HTTP 404 el 12 de agosto de 2026 y de nuevo el 18 de octubre de 2026 (curl -L), mientras apktool.org/docs/the-basics/intro respondía 200 (recuadro de la «sección 1 · Qué es y por qué existe»).
  23. Muestrario de octubre de 2026 — descrito en «El muestrario», descargado entre el 19 y el 27 de octubre de 2026. De aquí salen las cifras de las «secciones 1 · Qué es y por qué existe» a 3, 5 y 6.
  24. apktool 3.0.3 sobre 117 piezas del muestrario — d y b sin opciones, 900 s y 5.734 MB de memoria Java por pieza. De aquí sale la «sección 2.8 · Qué esperar de apktool con APK reales».
  25. aapt2 2.20-15087165 ejecutado localmente — el 31 de octubre de 2026 sobre com.termux 1022, org.fossify.math 10, com.dywx.larkplayer (web del autor) y Pou 1.4.139 (APKPure). De aquí salen badging, xmltree, packagename, configurations, resources y strings de la «sección 5.2 · dump: los subcomandos de inspección». Comando: BT=~/Library/Android/sdk/build-tools/37.0.0 y $BT/aapt2 dump <subcomando> "$MUESTRARIO/<ruta>". El tamaño del chunk del string pool global (1.369.084 bytes, 31.667 cadenas, 78 estilos) y los flags de los tres pools salen de leer la cabecera de resources.arsc: python3 -I -c "import zipfile,struct,sys;b=zipfile.ZipFile(sys.argv[1]+'/fdroid/org.fossify.math_10.apk').read('resources.arsc');print(struct.unpack_from('<HHIIIIII',b,12))" "$MUESTRARIO" devuelve (1, 28, 1369084, 31667, 78, 256, 127008, 1367300).
  26. Ejemplo de 16 KB y de .xapk y .apkm con apktool — el 31 de octubre de 2026, con apktool 3.0.3 y zipalign de build-tools 37.0.0, sobre una copia de io.github.mority.gloomy 2: apktool d -f -o d orig.apk; apktool b -o vuelta.apk d; $BT/zipalign -c -P 16 -v 4 orig.apk | grep lib/; $BT/zipalign -c -P 16 -v 4 vuelta.apk | grep lib/; $BT/zipalign -P 16 -f 4 vuelta.apk fix.apk; $BT/zipalign -c -P 16 4 fix.apk; echo $?. Para los contenedores: apktool d -f -o out "$MUESTRARIO/<ruta>"; echo $? sobre el .xapk y el .apkm de la «sección 2.5 · La dependencia de aapt2, que es el origen de casi todos sus fallos».
  27. Origen de usesLibrary en apktool 3.0.3 — lectura del bytecode del apktool_3.0.3.jar con javap -p -c -cp . brut.androlib.res.table.ResTable y brut.androlib.res.ResDecoder (mLibPackageIds y mUsesLibrary), y apktool d sobre com.termux 1022 y sobre la pieza de com.policydm 3.22.1 (APKMirror). De aquí salen la fila de usesLibrary de la «sección 2.4 · apktool.yml» y el aviso que la sigue. aapt2 optimize --help da las opciones --shorten-resource-paths y --collapse-resource-names de la «sección 3.5 · refactor y protect».