Desempaquetado y reempaquetado
Antes conviene leer «Anatomía de un APK»
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 4yzipalign -c 4responden bien (código de salida 0). - Tras
apktool dyapktool bel fichero pesa 822.872 bytes. Las cuatro.sosiguen 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,3290y13455). zipalign -P 16 -f 4lo 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
.xapkde APKPure (la app de multas de la DGT rusa,ru.gibdd_pay.app6.10): código 0, sin avisos. Dejaapktool.ymly ununknown/con los cuatroAPKde dentro (ru.gibdd_pay.app.apk,config.arm64_v8a.apk,config.xxhdpi.apkyconfig.ru.apk),icon.pngymanifest.json. - El
.apkmdecom.callapp.contacts2.150W: código 0. Solo imprime «Copying original files…» y «Copying unknown files…». Dejaapktool.ymlcondoNotCompressy ununknown/conbase.apk,split_config.xhdpi.apk,icon.png,APKM_installer.urleinfo.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.easyshare7.1.1.7 (Google Play, APKMirror):bfalla conresource android:style/Preference.RingtonePreference is private.com.fudme.cambridgepizza, piezabase.apk(sorteo, carpeta deadb):bfalla conresource android:style/TextAppearance.Material.Notification.Reply is private.com.ifeng.newvideo73440 (mercado chino):bfalla confailed to read PNG signature: file does not start with PNG signature.enres/drawable/share_image_bottom.png.com.xingin.xhs9510803 (mercado chino):bfalla conmust not undeclare prefix.enres/layout-en/APKTOOL_RENAMED_0x7f0c10bf.xml.- Brave, universal arm64 (web del autor):
bfalla conattribute android:zygotePreloadNativeLib not found. com.ss.android.ugc.aweme.lite400901 (mercado chino):dfalla conNullPointerException: Cannot invoke "String.isEmpty()". Es el único que no pasa poraapt2.com.taobao.qianniu5882 (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:
- Reconstruye
APKque 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 enaapt2. 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. - No hereda los errores de
aapt2. Los «resource is private» y los conflictos denamespacede la «sección 2.5 · La dependencia de aapt2, que es el origen de casi todos sus fallos» sencillamente no ocurren. - No depende de la versión del SDK instalado. Un JAR y Java 8; nada más.
- 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
mergeobuildhay que encadenarapksignero 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.soen 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
--helpy 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 unZIPconinfo.json,icon.png,APKM_installer.url, losAPK(base.apky lossplit_*.apk) y una firmaMETA-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.whatsapp2.26.42.9, con 35 entradas: 29APK, 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). Llevamanifest.json(en los 72),icon.png(en 58) y losAPKsin prefijo, comoorg.telegram.messenger.apkyconfig.arm64_v8a.apk. La mediana es de 3 piezas (de 2 a 20 en el 80 % central; máximo 22). Ejemplo:Telegram13.1.0 (APKPure).- Carpeta de
adb, la que se saca de un teléfono conadb pull: solobase.apkysplit_*.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, conbase.apky 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
5.1 compile y link
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.
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 laABI, 5.330.067 bytes.split_config.en.apkysplit_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.
- Apktool — repositorio oficial — https://github.com/iBotPeaches/Apktool
Vía
https://api.github.com/repos/iBotPeaches/Apktooly/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. - Apktool — CLI Parameters — https://apktool.org/docs/cli-parameters/
De aquí salen íntegras las tablas de opciones de
decode,buildeinstall-frameworkde las secciones «2.6» y «2.7», con la redacción de cada flag. - 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». - 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/sigy las opciones de la «sección 3.3 · decode: los tipos de salida», y la declaración de independencia deaapt2. - 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 degit/trees/HEAD?recursive=1sobre la ramamain, consultado el 18 de octubre de 2026. - aapt2 — documentación oficial de Android — https://developer.android.com/tools/aapt2
La lista de subcomandos y la tabla completa de subcomandos de
dumpcon sus opciones--no-values,--filey-vde la «sección 5.2 · dump: los subcomandos de inspección». - bundletool — documentación oficial de Android — https://developer.android.com/tools/bundletool
Las opciones de
build-apks,extract-apks,install-apksyget-device-spec, y el formato del fichero de especificación de dispositivo de la «sección 6.4 · extract-apks». - 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.
- 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.termux1022 del muestrario. De aquí salen elapktool.ymlreal de la «sección 2.4 · apktool.yml», con sus siete claves, y los 87 ficheros deunknown/.apktool --versiondevuelve3.0.3. 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 congh api, con sus comentarios. De aquí salen el título, la fecha de apertura, el estado abierto, lo que pide —reinsertar elAPK Sig Block 42original en unAPKmodificado— y la respuesta deiBotPeachesdel 27 de enero de 2025 de la «sección 2.5 · La dependencia de aapt2, que es el origen de casi todos sus fallos».bundletoolyapksignerejecutados localmente — el 25 de septiembre de 2026, conbundletool1.18.3 yapksignerdebuild-tools37.0.0, sobre un.aabmínimo (elfixture.aablocal, que no es del muestrario). Sin--ksy sin~/.android/debug.keystore,build-apksavisa de que no firmará yapksigner verifyrespondeDOES NOT VERIFYsobrebase-master.apk; con undebug.keystorepresente, lo firma y verifica. De aquí sale que elfixture.apksde la «sección 6.3 · build-apks» no se instala («sección 6.5 · get-device-spec e install-apks, contra un dispositivo real»).- Apktool 3.0.3 —
ApkDecoder.javayZipUtils.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 etiquetav3.0.3. De aquí sale cómo se rellena y se aplicadoNotCompressen la «sección 2.4 · apktool.yml»:NO_COMPRESS_EXT_PATTERN,writeApkInfoy el predicado dezipDir. aapt22.20-15087165 ejecutado localmente — el 18 de octubre de 2026,aapt2 dump --helpyaapt2 dump chunkssobre unAPKmínimo generado conaapt2 compileyaapt2 linkcontra elandroid.jardeplatforms/android-36.1. De aquí salen la fila dechunksde la tabla de la «sección 5.2 · dump: los subcomandos de inspección» y su volcado.- 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». apkanalyzerejecutado localmente — el 18 de octubre de 2026,cmdline-tools19.0, sobre elAPKmínimo de la fuente 13 y una copia con unclasses.dexañadido. De aquí salen las salidas dedex packages,apk compareyapk download-sizede la «sección 5.4 · apkanalyzer».- 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 porAndnixSHel 3 de mayo con «The issue is coming from Apktool», el registro con apktool 3.0.1 y el error deaapt2 linkde la «sección 2.5 · La dependencia de aapt2, que es el origen de casi todos sus fallos». - 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 desurendrajat, miembro del proyecto, del 9 de mayo de 2026. 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 congh api, con sus comentarios. La #211 se abrió el 27 de septiembre de 2025 a las 15:51 UTC yREAndroidrespondió 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»).- 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».
- 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».
- 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.jary sus 4.900 estrellas («sección 3.4 · merge: lo que nadie más hace bien»). - 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), mientrasapktool.org/docs/the-basics/introrespondía 200 (recuadro de la «sección 1 · Qué es y por qué existe»). - 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.
- apktool 3.0.3 sobre 117 piezas del muestrario —
dybsin 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». aapt22.20-15087165 ejecutado localmente — el 31 de octubre de 2026 sobrecom.termux1022,org.fossify.math10,com.dywx.larkplayer(web del autor) yPou1.4.139 (APKPure). De aquí salenbadging,xmltree,packagename,configurations,resourcesystringsde la «sección 5.2 · dump: los subcomandos de inspección». Comando:BT=~/Library/Android/sdk/build-tools/37.0.0y$BT/aapt2 dump <subcomando> "$MUESTRARIO/<ruta>". El tamaño del chunk delstring poolglobal (1.369.084 bytes, 31.667 cadenas, 78 estilos) y los flags de los tres pools salen de leer la cabecera deresources.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).- Ejemplo de 16 KB y de
.xapky.apkmcon apktool — el 31 de octubre de 2026, con apktool 3.0.3 yzipaligndebuild-tools37.0.0, sobre una copia deio.github.mority.gloomy2: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.xapky el.apkmde la «sección 2.5 · La dependencia de aapt2, que es el origen de casi todos sus fallos». - Origen de
usesLibraryen apktool 3.0.3 — lectura del bytecode delapktool_3.0.3.jarconjavap -p -c -cp . brut.androlib.res.table.ResTableybrut.androlib.res.ResDecoder(mLibPackageIdsymUsesLibrary), yapktool dsobrecom.termux1022 y sobre la pieza decom.policydm3.22.1 (APKMirror). De aquí salen la fila deusesLibraryde la «sección 2.4 · apktool.yml» y el aviso que la sigue.aapt2 optimize --helpda las opciones--shorten-resource-pathsy--collapse-resource-namesde la «sección 3.5 · refactor y protect».