Fusión de splits
Antes conviene leer «AAB, splits y contenedores» · «Tabla de recursos»
1. Qué es y por qué existe
Un split es un APK pequeño que lleva una sola parte de la aplicación. Google Play ya no entrega
un único APK: entrega uno principal, el base.apk, y varios pequeños, uno por tipo de procesador
(la ABI), uno por resolución de pantalla (la densidad) y uno por idioma. El teléfono instala
solo los que necesita y Android los trata como una sola aplicación. Fusionar es juntar esas piezas
en un APK normal. Los términos de este documento tienen su entrada en el
«glosario».
Antes de fusionar, hazte dos preguntas. ¿Tienes adb y un dispositivo o un emulador? Entonces no
fusiones: instala las piezas con adb install-multiple («sección 9 · La alternativa: no fusionar»). ¿Necesitas un solo fichero,
porque tu herramienta de análisis no entiende conjuntos, porque quieres instalar sin ordenador o
porque quieres archivar? Entonces fusiona y sigue las «secciones 2 · Qué exige la fusión: el mapa» a 8.
Ese modelo es excelente para el usuario y un estorbo para casi todo lo demás. Una aplicación
instalada desde Google Play casi nunca es un solo fichero: es un base.apk más los split de la
ABI, la densidad y el idioma del dispositivo. PackageManager (el servicio de Android que instala
las aplicaciones) los monta como una sola aplicación con un solo AssetManager (el que busca los
recursos).
Lo normal es que lleguen en varias piezas: así pasa con 454 de las 658 apps más instaladas que
descargamos de Google Play (un 69 %) y con 319 de las 369 del sorteo (un 86 %). De las 365 carpetas
sacadas con adb, solo 50 traen únicamente base.apk. Ojo: esto describe lo que descargamos, no
lo que Play entregaría a cada dispositivo.
Fusionar es producir un único APK instalable con todo dentro. Hace falta en tres situaciones,
y solo en esas tres:
- Análisis con una herramienta que solo acepta un
APK. La mayor parte del instrumental —MobSF, buena parte de los escáneres comerciales, cualquier pipeline que asuma un fichero— no entiende un conjunto. Y aunque jadx acepte.apks,.apkmy.xapkdirectamente, el resultado sigue siendo un análisis por partes. - Instalación fuera de Play, sin
adb. Quien descarga un.xapky quiere instalarlo desde el propio teléfono no tieneinstall-multiple. - Archivado. Guardar «la versión 8.179.1 de AliExpress» como un solo artefacto y no como una carpeta de 16 ficheros, cuya composición depende del dispositivo que la descargó.
Y conviene decirlo ya, aunque lo desarrolla la «sección 9 · La alternativa: no fusionar»: muchas veces la respuesta correcta es no
fusionar. adb install-multiple y bundletool install-apks llevan el conjunto al dispositivo tal
cual y preservan el comportamiento original. La fusión es una transformación con
pérdida, y este documento es sobre todo el inventario de qué se pierde.
De las trece herramientas de manipulación de APK que compara la «sección 4 de
Comparativa y selección · Las trece herramientas de manipulación de APK», tres fusionan
splits, dos decompilan a Java y ninguna hace las dos cosas. La referencia funcional de la fusión
es APKEditor, sobre ARSCLib. Lo que hemos medido aquí es el material de partida y lo que hay que
comprobar en el resultado; la fusión en sí, en la «sección 11 · Precomprobaciones y receta no reproducida», no la hemos ejecutado.
Un APK de una sola arquitectura no es un split. F-Droid e IzzyOnDroid entregan un .apk por
aplicación, y alrededor de una de cada cuatro apps con código nativo lleva las bibliotecas de una
sola ABI. Ninguno lleva el atributo split, así que no hay nada que fusionar: un APK de una sola
ABI y un base.apk más config.arm64_v8a.apk son cosas distintas. Ejemplos:
sh.fhs.ksre 205 de F-Droid y ru.tech.imageresizershrinker 251 de IzzyOnDroid, los dos solo con
arm64-v8a.
Las tiendas chinas que miramos (360 y Tencent) tampoco entregan splits: las 100 apps que medimos
son un solo APK. Nada de eso se fusiona. Lo que sí llevan muchas es un identificador de canal en
el bloque de firma, y eso importa al volver a firmar («sección 8 · Firma, y por qué no hay alternativa»).
2. Qué exige la fusión: el mapa
El esquema parte del .apkm de AliExpress 8.179.1, que tiene 16 piezas. Son cinco operaciones y
solo dos son difíciles. Copiar res/, lib/ y assets/ es copiar ficheros; lo caro es la tabla de
recursos y el saneado del manifiesto, y lo sutil es la selección.
2.1 Los tres invariantes que se comprueban antes de empezar
Si alguno falla, el conjunto está mal formado y no hay nada que fusionar.
- Mismo
packageen todos los splits. - Mismo
android:versionCodeen todos. - Misma clave de firma en todos.
PackageManagerlos trata como una sola aplicación, y un digest de certificado distinto hace que la sesión de instalación falle conINSTALL_FAILED_INVALID_APK: … signatures are inconsistent.
En la práctica nunca fallan: en el «muestrario» no hay una
sola excepción entre las 773 apps de Play con splits. En el .apkm de Google Keep 5.26.411.03.97,
por ejemplo, el versionCode es 220679628 en el base y en cada uno de sus 26 config splits, con un
único certificado. Ese Keep es la compilación para Wear OS (el sistema de los relojes), no la del
teléfono.
Lo que no comparten, y no es un error:
- El
versionName. Los config splits y los asset packs lo traen vacío, sin excepción. Los módulos, casi siempre no. - El contenido, claro.
- El
minSdkVersion, que casi nunca difiere: solo en TikTok, cuyosplit_df_gemini_nano.apkdeclara 26 frente a 23 del base. Pero más de la mitad de los config splits no lo declaran, y eso tiene un efecto práctico al comprobar las firmas pieza a pieza («sección 8 · Firma, y por qué no hay alternativa»).
2.2 Qué colisiona de verdad: medido
Antes de teorizar sobre colisiones conviene medirlas. Cruzamos todas las rutas de todas las piezas
de seis contenedores del muestrario y comparamos el CRC-32 de cada entrada repetida (lo muestra
unzip -v):
27 piezas · 1.422 rutas distintas · 1 duplicada idéntica · 2 en conflicto real Google Keep 5.26.411.03.97 (.apkm)
11 piezas · 7.107 rutas distintas · 541 duplicadas idénticas · 2 en conflicto real Twitch 31.8.0 BETA (.apkm)
16 piezas · 7.855 rutas distintas · 1 duplicada idéntica · 6 en conflicto real AliExpress 8.179.1 (.apkm)
3 piezas · 4.283 rutas distintas · 1 duplicada idéntica · 6 en conflicto real HealthKart 18.4.2 (.apkm)
3 piezas · 3.282 rutas distintas · 1 duplicada idéntica · 5 en conflicto real Telegram 13.1.0 (.xapk)
5 piezas · 1.682 rutas distintas · 1 duplicada idéntica · 6 en conflicto real Gin Rummy Frenzy (carpeta de adb)
En los seis, la «duplicada idéntica» de una sola entrada es stamp-cert-sha256 (el sello de origen,
«sección 5.4 · Los <meta-data> que dejan bundletool y Play»). Las 541 de Twitch son 540 ficheros de res/ que se repiten en sus seis splits de
densidad, más el sello.
Los conflictos reales son casi siempre los mismos ficheros. Para verlo miramos, en las apps con splits, qué ruta repetida cambia de tamaño entre piezas:
| Ruta en conflicto | Más instaladas de Play (de 454 apps) | Sorteo de Play (de 319 apps) | Cómo se resuelve |
|---|---|---|---|
AndroidManifest.xml |
454 (todas) | 319 (todas) | Se toma el del base y se sanea («§5 · Saneado del manifiesto») |
resources.arsc |
340 (75 %) | 240 (75 %) | Se fusionan las tablas («§4 · Fusión de las tablas de recursos») |
META-INF/MANIFEST.MF, *.SF, *.RSA o *.DSA |
270 (59 %) | 248 (78 %) | Se descartan: hay que volver a firmar («§8 · Firma, y por qué no hay alternativa») |
classes.dex y classes2.dex… |
37 (8 %) | 4 (1 %) | Se renumera («§6 · Renumeración de los DEX») |
| Cualquier otra ruta | 0 | 0 | — |
resources.arsc no llega al 100 % porque solo choca si dos piezas lo traen, y los splits de ABI y
los asset packs no lo traen. La tabla mira qué cambia de tamaño entre piezas, y por eso es una cota
inferior: el contenido exacto (CRC-32) solo lo comprobamos en los seis contenedores de ejemplo, y
en ellos no hay ninguna otra ruta en conflicto. El sello stamp-cert-sha256 se repite idéntico en
todas las piezas: en ninguna de las 773 apps con splits cambia de tamaño.
Si te preguntas cuántos splits llevan firma v1 (los ficheros de META-INF): depende del base. Cuando
declara un minSdkVersion menor de 24, prácticamente todos; con 24 o más, menos de la mitad en las
más instaladas y el 88 % en el sorteo.
Nada de res/, lib/ ni assets/ choca con contenido distinto. Lo confirman los seis
contenedores de ejemplo, comparados con su CRC-32, y, por tamaño, las 773 apps con splits. Lo que
sí se repite, con el mismo contenido, son ficheros de res/ (en más de la mitad de las apps más
instaladas). Se copian una vez y ya está. Solo hay una ruta de lib/ repetida en todo el muestrario, en una pieza del buscador de
Google (lib/armeabi-v7a/libmultiarch_dummy.so, mismo tamaño), y no cambia la regla.
Es un resultado más fuerte de lo que parece y acota el problema: la fusión es difícil en unos pocos ficheros, no en miles. En Twitch son 2 de 7.107 rutas; en AliExpress, 6 de 7.855. Y explica por qué la fusión ingenua de la «sección 10.2 · Recursos que no aparecen» «funciona» hasta que se mira la tabla.
3. Selección de configuración
3.1 El problema
Fusionarlo todo produce un APK universal grande pero correcto; fusionar de menos produce
uno que instala y al que le faltan cosas. Un contenedor trae las piezas que cubren una parte de la
matriz de dispositivos, y cuántas depende del formato: un .apkm de APKMirror suele traer una
docena, y un .xapk o una carpeta sacada con adb, tres o cuatro. Las tres dimensiones son
ortogonales:
| Dimensión | Splits típicos | Qué pasa si sobran | Qué pasa si faltan |
|---|---|---|---|
| ABI | config.arm64_v8a, config.armeabi_v7a, config.x86, config.x86_64 |
Tamaño: se llevan las .so de arquitecturas que el dispositivo no usa |
INSTALL_FAILED_NO_MATCHING_ABIS, o la aplicación instala y muere en System.loadLibrary |
| Densidad | config.ldpi … config.xxxhdpi |
Tamaño | Android hace fallback a otra densidad: los iconos salen borrosos, no falla |
| Idioma | config.es, config.ja, … |
Tamaño | Se cae al idioma por defecto del base. No falla, pero la aplicación deja de estar traducida |
La asimetría es la lección: de las tres, solo la ABI produce un fallo duro. Densidad e idioma degradan en silencio, que es peor de diagnosticar.
3.2 La herramienta oficial que casi nadie usa: split-select
split-select viene en las build-tools del SDK, junto a aapt2 y zipalign. Le das la
descripción de un teléfono y una lista de splits, y te dice cuáles instalaría. Aproxima la
selección que Play hace en el servidor, pero no es lo que Play usa.
Es de 2014, de la época de los splits de Gradle. De cada split mira las configuraciones de su tabla
de recursos y los directorios de lib/, y del manifiesto solo versionCode, minSdkVersion y
multiArch. No lee toc.pb, ni splitTypes, ni configForSplit, ni sabe qué es un módulo de
funcionalidad. Play genera los APK con bundletool, y la selección que lo reproduce es la de «§3.3 · La alternativa: bundletool extract-apks».
Esta sí la hemos ejecutado (31 de octubre de 2026, build-tools 37.0.0), sobre el .apkm de Google
Keep del muestrario, con sus 26 config splits (24 de idioma, armeabi_v7a y xhdpi):
BT=~/Library/Android/sdk/build-tools/37.0.0
set --; for f in keep/split_config.*.apk; do set -- "$@" --split "$f"; done
$BT/split-select --target "es-rES-xhdpi-v34:armeabi-v7a" \
--base keep/base.apk "$@"
Las piezas del .apkm están extraídas en keep/. La salida:
keep/split_config.armeabi_v7a.apk
keep/split_config.es.apk
keep/split_config.xhdpi.apk
Tres de veintiséis. El <config> es un calificador de recurso de aapt extendido con la
arquitectura detrás de dos puntos: resource-qualifiers:extended-qualifiers.
Cambiando el objetivo se ve la lógica —y sus límites—:
--target en-rUS-xxhdpi-v34:arm64-v8a → keep/split_config.armeabi_v7a.apk
--target fr-rFR-mdpi-v30:x86_64 → keep/split_config.fr.apk · keep/split_config.xhdpi.apk
--target eu-rES-hdpi-v34:arm64-v8a → keep/split_config.armeabi_v7a.apk · keep/split_config.xhdpi.apk
- El inglés suele tener split, aunque no siempre. Es el idioma por defecto y vive en el base,
pero casi todas las apps con splits de idioma traen también un
config.en. En Keep, eseconfig.ensolo trae variantes regionales (en-AU,en-CA,en-GB,en-IN,en-XC): por esoen-rUSno selecciona ninguno. Hay apps con muchos idiomas y ninguno de inglés, como FaceApp 14.0.0 o Zombie Tsunami 4.7.4. El euskera tampoco tiene split en Keep, pero por el motivo contrario: no está traducido. Desde la línea de órdenes los dos casos son indistinguibles. Para separarlos, mira qué locales declara cada split (aapt2 dump badginglos lista). - Las densidades las explica el modelo de la herramienta.
split-selectno busca la densidad exacta: busca la más parecida, y cuenta también las imágenes que ya trae el base. Si la mejor opción está en el base, no imprime nada. El base de Keep trae las densidades 120, 160, 240, 320, 480 (xxhdpi), 640 y 65535 (aapt2 dump badging base.apk), yxhdpies su único split de densidad. Por esoxxhdpino selecciona ningún split —gana el base— ymdpiyhdpiseleccionanconfig.xhdpi: las tres líneas de arriba. Los pasos del código de la herramienta están en la fuente 11. - Un objetivo
arm64-v8aseleccionaconfig.armeabi_v7a. No es un error de la selección: el Keep del muestrario solo trae un split de ABI, el de 32 bits, porque APKMirror publica por separado la compilación para reloj (Wear OS, 32 bits,minSdkVersion30). Y no cuentes con que un dispositivo de 64 bits ejecute la biblioteca de 32: los que solo ejecutan 64 bits la rechazan al instalar.
Ese último punto es el más importante de la sección: un contenedor de terceros no es el APK Set
completo, es un recorte. Un .apkm de APKMirror trae casi siempre varias ABI y densidades; un
.xapk de APKPure, casi siempre una de cada; y una carpeta de adb es un recorte hecho por el
dispositivo. Fusionar «todo lo que hay dentro»
no reconstruye lo que Play habría instalado; reconstruye lo que ese sitio decidió empaquetar.
En un dispositivo
arm64-v8ade solo 64 bits esos splits fallan conINSTALL_FAILED_NO_MATCHING_ABIS. Lo probamos en un emulador Android 14, en «Formatos y extensiones → §6.2 · Extraer el base», con los splits de APKCombo que ya no están en el muestrario (mira los límites de la «sección 1 · Qué es y por qué existe»).
No cuentes con split-select --generate para scripts. Debería escribir las reglas de selección en
JSON, pero lo escribe mal formado y termina con un error interno. Los valores del array
salen sin comillas ("args": [es]) y la herramienta aborta con una aserción fatal (key not found)
de su KeyedVector interno, aunque imprime la salida igualmente. Lo verificamos con build-tools
37.0.0 el 12 de agosto y el 31 de octubre de 2026 (con split_config.es.apk de Keep).
3.3 La alternativa: bundletool extract-apks
Sobre un APK Set genuino —con toc.pb, su tabla de contenido— la selección se hace con una
especificación de dispositivo escrita a mano, sin necesidad de dispositivo. El ejemplo usa un
APK Set de prueba generado en local con bundletool 1.18.3, que no está en el muestrario:
cat > dev.json <<'EOF'
{"supportedAbis":["arm64-v8a"],"supportedLocales":["es"],"screenDensity":420,"sdkVersion":34}
EOF
java -jar bundletool.jar extract-apks --apks fixture.apks --output-dir extracted \
--device-spec dev.json
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
Extrae cuatro APK de los que trae el conjunto. Pero solo funciona con toc.pb, y ningún
contenedor del muestrario lo trae. Para un .apkm o un .xapk tendrás que seleccionar con
split-select o a mano.
3.4 La regla práctica
| Objetivo | Qué seleccionar |
|---|---|
| Analizar la aplicación como unidad | Todo. El tamaño da igual y no perder nada sí importa |
| Archivar | Todo, y anotar que el contenedor de origen ya era un recorte («§3.2 · La herramienta oficial que casi nadie usa: split-select») |
| Instalar en un dispositivo concreto | La ABI de ese dispositivo, su densidad y sus idiomas |
| Reducir tamaño | Una ABI, una o dos densidades, los idiomas que hagan falta |
Y una asimetría que conviene tener presente: coger de más solo cuesta bytes; coger de menos cuesta funcionalidad. Ante la duda, todo.
3.5 Qué trae cada contenedor
Un .apkm es un ZIP de APKMirror con base.apk, los split_*.apk, un info.json, un icono y una
firma exterior que no vale para la app (META-INF/MANIFEST.MF, APKMIRRO.SF y APKMIRRO.RSA),
además de APKM_installer.url. El nombre dice qué lleva: 4arch_6dpi_24lang_1feat son cuatro ABI, seis
densidades, 24 idiomas y un módulo.
Un .xapk es un ZIP de APKPure (o de APKCombo) con un manifest.json. La pieza principal se
llama como el paquete y los splits no llevan prefijo (config.arm64_v8a.apk); no hay base.apk.
Ningún contenedor trae toc.pb.
Alguna vez viene un .obb dentro del contenedor (lo hemos visto en dos .apkm, Scary Teacher y
Plants vs. Zombies 2). Para fusionar no cuenta: un .obb no es un APK y queda fuera.
Ejemplos: el .xapk de Telegram 13.1.0 (pieza principal org.telegram.messenger.apk, sin prefijo
split_) y el .apkm de Twitch 31.8.0 BETA (base.apk y split_config.*.apk; el nombre dice
4arch_6dpi). El muestrario se describe en «El muestrario».
3.6 Las carpetas sacadas con adb
Es el material más fiel a lo que Play instala de verdad. Se saca con adb shell pm path <paquete>
seguido de adb pull de cada ruta; ese procedimiento no lo hemos ejecutado aquí. El sistema pone el
prefijo split_ a los splits y deja el base.apk tal cual.
Como salen de un solo dispositivo, solo traen su ABI, su densidad y sus idiomas. En el muestrario lo
típico es arm64-v8a, xxhdpi e inglés, unas cuatro piezas por carpeta. Una carpeta es un recorte
hecho por el dispositivo, no el conjunto completo que Play podría entregar.
Ejemplo: binaltd.haradar, con base.apk, split_config.arm64_v8a.apk,
split_config.xxhdpi.apk y split_config.es.apk (más el inglés).
4. Fusión de las tablas de recursos
Es el paso difícil, y el que hace que la fusión no sea concatenar ZIPs.
4.1 El malentendido que hay que quitarse primero
La formulación habitual —«hay que resolver las colisiones de resource ID entre splits»— es
falsa para el caso mayoritario, y creérsela lleva a implementar el algoritmo equivocado.
Cada recurso tiene un número fijo, por ejemplo 0x7f120004. El base guarda el texto por defecto; el
split de español guarda el mismo número con la traducción. Un config split de idioma no aporta
identificadores nuevos: aporta valores nuevos para identificadores que ya existen en el base.
Lo medimos sobre Google Keep:
$BT/aapt2 dump resources keep/split_config.es.apk | head -12
Binary APK
Package name=com.google.android.keep id=7f
type plurals id=12 entryCount=7
resource 0x7f120002 plurals/public_notification_text
(es) (plurals) size=2
one="Tienes una notificación"
other="%1$d notificaciones nuevas"
(es-rUS) (plurals) size=2
one="Tienes una notificación"
other="%1$d notificaciones nuevas"
resource 0x7f120004 plurals/time_difference_short_days
(es) (plurals) size=3
Mismo paquete com.google.android.keep, mismo package ID 0x7f (el prefijo de todos los
recursos de la app), y los mismos resource ID 0x7f120002 y 0x7f120004 que ya están en el
base, donde su valor es el () por defecto. Lo que el split trae son ConfigValue más para esas
entradas, uno con el calificador es y otro con es-rUS. En el split de idioma de Keep, todos los
identificadores tienen valor por defecto en el base.
En un split de idioma, fusionar no es renumerar nada: es añadir ConfigValue a entradas
existentes. Hay que tocar tres partes de la tabla: la lista de variantes de cada recurso
(ConfigValue), la marca que dice qué recursos cambian según idioma o pantalla (el type spec, el
chunk que declara qué configuraciones hacen variar cada entrada) y la lista común de textos (el
string pool, que tiene que absorber las cadenas nuevas). La estructura de todo eso está en
«Tabla de recursos».
En un split de densidad hay un matiz: casi todas sus imágenes son identificadores que el base declara
pero no rellena. En split_config.xhdpi.apk de Keep, 43 de 44 identificadores no tienen ningún valor
en el base (aapt2 dump resources). La fusión tiene que crear esos valores, y el type spec
tiene que decir que varían por densidad.
4.2 Dónde sí hay dos paquetes
En los módulos de funcionalidad, y el mecanismo por el que Android lo evita es elegante: cada
módulo recibe su propio package ID. Lo medimos en AliExpress 8.179.1:
base.apk → Package name=com.alibaba.aliexpresshd id=7f
split_config.xxhdpi.apk → Package name=com.alibaba.aliexpresshd id=7f
split_ugc.apk → Package name=com.alibaba.aliexpresshd.ugc id=79
split_ugc.config.xxhdpi.apk → Package name=com.alibaba.aliexpresshd.ugc id=79
split_widget.apk → Package name=com.alibaba.aliexpresshd.widget id=78
split_push.apk → Package name=com.alibaba.aliexpresshd.push id=77
split_remoteFeedback.apk → Package name=com.alibaba.aliexpresshd.remoteFeedback id=76
split_remoteAIQa.apk → Package name=com.alibaba.aliexpresshd.remoteAIQa id=75
split_aiFoundation.apk → (ningún paquete: tabla vacía de 40 bytes, §4.3)
split_config.arm64_v8a.apk → (sin resources.arsc)
0x79 frente a 0x7f. Los identificadores del módulo son 0x79...... y no pueden colisionar con
los del base por construcción. El número cambia de una app a otra (hemos visto de 0x4d a
0x8a), pero ningún módulo usa 0x7f y ninguna app repite un ID.
Tampoco todos los módulos tienen tabla propia: menos de la mitad la tienen, y el resto trae la tabla
vacía de 40 bytes o ningún resources.arsc. Los config splits de un módulo con tabla llevan el ID de
su módulo. Y ojo, que hay idiomas repartidos como módulos: WhatsApp 2.26.42.9 trae 17 como módulos
split_i18n_*, no como config.xx.
La consecuencia para la fusión es directa: los recursos de la app llevan el prefijo 0x7f y cada
módulo con tabla recibe otro, así que sus números nunca chocan con los del base. La tabla
resultante tiene que contener un RES_TABLE_PACKAGE_TYPE por paquete (el del base y uno por
módulo con tabla), no fundirlos en uno. Un fusionador que asuma un solo paquete o bien pierde el
módulo o bien tiene que renumerar de verdad. Y renumerar significa reescribir todas las
referencias a esos identificadores, incluidas las que están incrustadas en las instrucciones del
DEX como constantes de 32 bits. Eso es exactamente lo que no se puede hacer sin reescribir el
DEX.
4.3 El caso degenerado: la tabla de 40 bytes
Es una tabla de recursos vacía: cero paquetes y cero textos. Es válida, pero un programa que espere
al menos un paquete falla. No es frecuente (21 piezas en todo el muestrario, módulos y splits de
densidad), pero existe. Por ejemplo, split_aiFoundation.apk de AliExpress:
unzip -p split_aiFoundation.apk resources.arsc | xxd
00000000: 0200 0c00 2800 0000 0000 0000 0100 1c00 ....(...........
00000010: 1c00 0000 0000 0000 0000 0000 0001 0000 ................
00000020: 1c00 0000 0000 0000 ........
El volcado es idéntico byte a byte al de otras versiones del documento (lo comprobamos el 31 de
octubre de 2026). Descodificado: RES_TABLE_TYPE = 0x0002, headerSize = 12, size = 40,
packageCount = 0; seguido de un RES_STRING_POOL_TYPE = 0x0001 de 28 bytes con
stringCount = 0, styleCount = 0, flags = 0x00000100 (UTF8_FLAG) y stringsStart = 28. Doce
más veintiocho, cuarenta.
aapt2 dump resources la lee sin protestar y responde solo Binary APK. Pero rompe cualquier
lector que asuma al menos un paquete: el bucle sobre packageCount no se ejecuta ni una vez, y el
código que dé por hecho «el paquete de la aplicación» lee fuera de rango o desreferencia un nulo. Es
el fixture de caso límite que hay que conservar.
Y hay un caso todavía más extremo: un split puede no tener resources.arsc en absoluto. Pasa
con todos los splits de ABI y todos los asset packs, con la mitad de los módulos y con algún split
de idioma suelto. split_gpdeku.apk de Gin Rummy Frenzy, por ejemplo, tiene cuatro entradas: el
manifiesto, classes.dex, classes2.dex y un stamp-cert-sha256. Ni siquiera lleva META-INF,
así que en esa pieza no hay firma v1.
4.4 El resumen operativo
| Situación | Qué hay que hacer |
|---|---|
| Config split del base (idioma, densidad, ABI) | Añadir sus ConfigValue a las entradas existentes del paquete 0x7f; actualizar el type spec; fundir el string pool |
| Módulo de funcionalidad con paquete propio | Copiar su RES_TABLE_PACKAGE_TYPE entero a la tabla resultante. No renumerar |
| Config split de un módulo de funcionalidad | Lo mismo que la primera fila, pero sobre el paquete del módulo (por ejemplo 0x79) |
| Tabla vacía de 40 bytes | Ignorar el split a efectos de recursos. No es un error |
Sin resources.arsc |
Ídem |
5. Saneado del manifiesto
El manifiesto del resultado sale del base, y hay que quitarle todo lo que declara que forma parte de un conjunto. Si lo dejas, el instalador sigue buscando splits que ya no existen.
5.1 Los atributos, medidos sobre el muestrario
La tabla da, para cada atributo, dónde aparece entre las apps más instaladas de Google Play (cuenta piezas, salvo las 454 bases, una por app con splits).
| Atributo | Resource ID | Dónde aparece | Qué hacer al fusionar |
|---|---|---|---|
split |
— (sin namespace) | En los 7.235 splits; nunca en una base (0 de 454; 0 de 319 en el sorteo) | Quitar |
configForSplit |
— (sin namespace) | Solo en config splits de un módulo o de un asset pack (ABI 109 de 1.026, densidad 29 de 1.522, idioma 104 de 4.412, textura 6 de 6, país 1 de 1) | Quitar |
android:isFeatureSplit |
0x0101055b |
En los 186 módulos y en los 82 asset packs; en ningún config split (0 de 6.967) | Quitar |
android:isSplitRequired |
0x01010591 |
En <manifest>: en ninguna pieza. En <application>, donde no cuenta: 24 piezas |
Quitar |
android:requiredSplitTypes |
0x0101064e |
En 447 de 454 bases (98 %; en el sorteo, 302 de 319) y en 101 de 186 módulos | Quitar |
android:splitTypes |
0x0101064f |
Con valor en 1.021 de 1.026 splits de ABI, 1.513 de 1.522 de densidad y 182 de 186 módulos; con valor vacío en 4.410 de 4.412 de idioma y en 451 de 454 bases | Quitar |
android:hasCode |
0x0101000c |
false en los 6.967 config splits y los 82 asset packs, y en 101 de 186 módulos (30 de ellos traen DEX: TikTok 26, Adobe Reader 3, ShareIt Lite 1); ninguna base lo pone a false |
Del base se conserva tal cual |
android:extractNativeLibs |
0x010104ea |
Puede diferir entre base y splits | Unificar, «§7.2 · extractNativeLibs: el atributo que hay que unificar» |
Los asset packs son un tipo de pieza más. De los módulos con hasCode="false" y DEX, qué hace
Android con ese código no se puede medir de forma estática: lo contamos como límite («sección 1 · Qué es y por qué existe»), no
como regla.
Con android:isSplitRequired (0x01010591, una constante del framework que vimos con
aapt2 dump xmltree en el base.apk de cakepop.games), fíjate en dónde va. El instalador lo
lee en el <manifest>, junto a versionCode (ApkLiteParseUtils.parseApkLite()). En un emulador
Android 14, un APK de prueba con android:isSplitRequired="true" en <application> se instala
solo, sin splits; con el mismo atributo en <manifest>, da
INSTALL_FAILED_MISSING_SPLIT: Missing split for com.ejemplo.prueba. No hemos repetido esa prueba
con el muestrario, y que el atributo no tenga efecto en <application> descansa en ella y no en
AOSP.
En el muestrario nadie lo pone en <manifest>. Lo ponen en <application>, donde no sirve, 24
piezas; por ejemplo, cakepop.games (base), com.kugou.android.lite 11610 del mercado chino y
com.tortillum.signalid 3 de IzzyOnDroid.
5.2 Hay dos mecanismos, y el muestrario solo tiene el moderno
El muestrario solo tiene el mecanismo moderno: el base declara qué tipos necesita y cada split
cuáles aporta. El booleano antiguo, isSplitRequired, solo aparece en <application>, donde no
cuenta. Casi todas las bases con splits declaran requiredSplitTypes, y lo más frecuente es
base__abi,base__density. Solo contamos el espacio de nombres android:; el
dist:requiredSplitTypes no entra en estas cifras.
Haradar base.apk requiredSplitTypes="base__abi,base__density" splitTypes=""
split_config.arm64_v8a.apk splitTypes="base__abi" split="config.arm64_v8a" hasCode=false
split_config.xxhdpi.apk splitTypes="base__density" split="config.xxhdpi" hasCode=false
split_config.es.apk splitTypes="" split="config.es" hasCode=false
Gin Rummy base.apk requiredSplitTypes="base__abi"
split_gpdeku.apk isFeatureSplit=true requiredSplitTypes="gpdeku__abi"
splitTypes="gpdeku__module" split="gpdeku"
split_gpdeku.config.arm64_v8a.apk splitTypes="gpdeku__abi" configForSplit="gpdeku"
split="gpdeku.config.arm64_v8a" hasCode=false
El instalador comprueba que el conjunto es completo antes de aceptarlo. Es la razón número uno por la
que instalar splits sueltos falla con INSTALL_FAILED_MISSING_SPLIT
(«Diagnóstico de fallos → §2 · Instalación: los códigos INSTALL_*»).
Fíjate en configForSplit="gpdeku": el espacio de nombres de splits no es plano.
split_gpdeku.config.arm64_v8a.apk es a la vez config split y parte de un módulo de funcionalidad, y
un fusionador que asuma un solo nivel de config.* sobre un base lo coloca mal o lo descarta. No es
raro: pasa en un 7 % de las apps con splits más instaladas de Play. Los config splits de segundo
nivel son ABI, idioma y densidad en módulos, y textura y país en asset packs; ninguna pieza con
nombre x.config.y deja de llevar configForSplit.
5.3 El resultado correcto, comprobado contra la referencia de Google
La comprobación honesta del saneado es contra lo que produce bundletool --mode=universal, que es
la vía oficial para obtener un instalable único desde un bundle. Sobre el App Bundle de prueba
generado en local (no está en el muestrario):
java -jar bundletool.jar build-apks --bundle=com.ejemplo.fixture.aab \
--output=uni.apks --mode=universal --overwrite
unzip -o uni.apks && $BT/aapt2 dump xmltree universal.apk --file AndroidManifest.xml | head -8
N: android=http://schemas.android.com/apk/res/android (line=2)
E: manifest (line=2)
A: http://schemas.android.com/apk/res/android:versionCode(0x0101021b)=1
A: http://schemas.android.com/apk/res/android:versionName(0x0101021c)="1.0" (Raw: "1.0")
A: http://schemas.android.com/apk/res/android:compileSdkVersion(0x01010572)=36
A: package="com.ejemplo.fixture" (Raw: "com.ejemplo.fixture")
Ni split, ni splitTypes, ni isSplitRequired, ni isFeatureSplit. Y el contenido:
$BT/aapt2 dump badging universal.apk | grep -E "^(locales|native-code|densities)"
locales: '--_--' 'de' 'es' 'fr'
densities: '160' '240' '320' '480'
native-code: 'arm64-v8a' 'armeabi-v7a' 'x86_64'
Todos los idiomas, todas las densidades, todas las ABIs, y el manifiesto limpio. Ese es el objetivo,
y es lo que tienen los APK únicos reales: ninguno declara atributos de split. Un ejemplo es el APK universal de Netflix 9.88.0 de
APKMirror (cuatro ABI, 282.642.078 bytes, versionCode 74729, minSdkVersion 28).
Una nota al margen: el universal.apk de prueba sale sin firmar, y apksigner verify responde
DOES NOT VERIFY / ERROR: Missing META-INF/MANIFEST.MF, el caso del APK sin firmar de la «sección
3.2 de Diagnóstico de fallos · Bloque desaparecido frente a contenido modificado (reproducido)». Es así en la máquina de referencia, que
no tiene ~/.android/debug.keystore; con ese fichero, bundletool lo habría firmado con la clave de
depuración. Ese mismo mensaje sale en un APK firmado cuando no declara minSdkVersion y no lleva
firma v1 («sección 8 · Firma, y por qué no hay alternativa»), así que no prueba por sí solo que no esté firmado.
5.4 Los <meta-data> que dejan bundletool y Play
Además de los atributos, el <application> del base trae entradas <meta-data> que describen el
conjunto de splits. Las medimos en las bases del muestrario y las contrastamos con el código de
bundletool 1.18.3 y con el de ARSCLib, la biblioteca sobre la que trabaja APKEditor. La tabla da,
por clave, quién la escribe y en cuántas bases con splits está.
android:name |
Quién lo escribe y qué dice | Bases con splits que lo llevan | Qué hacer al fusionar |
|---|---|---|---|
com.android.vending.splits |
bundletool, con android:resource apuntando a res/xml/splits0.xml —el primer splitsN.xml libre—: qué split aporta cada idioma |
453 de 454 entre las más instaladas; 319 de 319 en el sorteo | Quitar, y con él la entrada res/xml/splits0.xml de la tabla; o rehacerlo con todos los idiomas en el base, que es lo que bundletool escribe en un APK autónomo |
com.android.vending.splits.required |
bundletool, true en el split maestro del base cuando parte por ABI, densidad o assets. Su código lo dice: «not read by the system», es para Play Core y para verificadores antiguos |
448 de 454; 319 de 319 | Quitar: si se deja, la app fusionada pide splits que ya no existen |
com.android.vending.derived.apk.id |
No aparece en el código de bundletool, así que no lo escribe él; lo llevan las bases y los splits que Play instala |
452 de 454; 319 de 319. En splits: 7.142 de 7.235 piezas (99 %) y 881 de 903 en el sorteo (98 %) | Quitar. ARSCLib lo quita |
com.android.dynamic.apk.fused.modules |
bundletool, en los APK autónomos y en el universal: la lista de módulos fusionados |
.apkm de APKMirror 22 de 386 (6 %); .xapk de APKPure 2 de 67 (3 %); carpetas de adb 3 de 315 (1 %) |
No es obsoleto: hay que actualizarlo con los módulos que contiene el resultado. ARSCLib añade los módulos con dist:fusing include=true que fusiona |
Todas las bases de las carpetas de adb llevan las cinco claves de Play (las cuatro de la tabla y
stamp.source), tal como las deja Play en el teléfono; binaltd.haradar es un ejemplo, y
split_config.es.apk de Keep muestra que un config split también lleva derived.apk.id. Fuera de
Play, solo com.tortillum.signalid 3, de IzzyOnDroid, lo lleva. Separamos los orígenes porque no
son lo mismo: la carpeta de adb es lo que Play instala; el resto lo da un tercero.
ARSCLib quita además com.android.stamp.source y com.android.stamp.type y los <uses-split>.
Según el código de bundletool, el universal.apk lleva com.android.vending.splits y
com.android.dynamic.apk.fused.modules, y no com.android.vending.splits.required; la salida de «§5.3 · El resultado correcto, comprobado contra la referencia de Google»
solo enseña el <manifest>. En los APK únicos reales, vending.splits y fused.modules aparecen
en alrededor de una cuarta parte, y splits.required en ninguno. Esos .apk sueltos son de
APKMirror y APKPure, de procedencia desconocida, así que no son el mismo universo que las carpetas
de adb.
Al fusionar y volver a firmar, el sello de origen deja de corresponder con la firma nueva. El
sello (source stamp) es una marca de Google Play: el fichero stamp-cert-sha256 de cada pieza
(32 bytes) y, en el base, los <meta-data> com.android.stamp.source y com.android.stamp.type.
Casi toda pieza que sale de Play lo lleva, y casi ninguna de fuera. Su valor es igual al certificado
del par de sello del bloque de firma (descrito en
«Bloque de firma de APK»). Ejemplos: la pieza
base.apk del .apkm de Opera 103.1.5234 y com.tortillum.signalid 3 de IzzyOnDroid, fuera de
Play.
6. Renumeración de los DEX
6.1 Cuándo hace falta
Solo cuando más de un split trae código, y eso solo pasa con los módulos de funcionalidad.
Ningún config split ni asset pack trae DEX: declaran android:hasCode="false". Las bases sí, y
más de la mitad de los módulos también. Al final, hay DEX en más de una pieza en un 8 % de las
apps más instaladas de Play. En HealthKart 18.4.2, de sus 3 piezas solo dos tienen código:
10 dex base.apk → classes.dex … classes10.dex
1 dex split_videoconsult.apk → classes.dex
Ahí está la colisión: dos entradas llamadas classes.dex con contenido distinto, que es una de
las seis rutas en conflicto de HealthKart en la «sección 2.2 · Qué colisiona de verdad: medido». Un ZIP admite dos entradas con el
mismo nombre; Android no.
6.2 Qué hay que hacer, y qué no
La operación es renombrar, no recompilar. Los classes*.dex del módulo continúan la numeración
del base sin huecos: split_videoconsult/classes.dex → classes11.dex. Si el módulo trae más de
uno, se siguen numerando en orden. En Gin Rummy Frenzy, por ejemplo, el base tiene 8 y
split_gpdeku.apk tiene 2: classes.dex → classes9.dex y classes2.dex → classes10.dex. En
AliExpress, el base trae 5 y seis módulos traen 1 cada uno, que pasan a classes6.dex …
classes11.dex.
Tres cosas que no hay que hacer:
- No hay que reescribir el
DEX. El nombre de la entrada delZIPno está dentro del fichero —elheader_itemno lo contiene— y las referencias entre clases son por descriptor de tipo, no por fichero. Copiar los bytes y cambiar el nombre de la entrada basta. - No hay que recalcular el
checksumni lasignature. No se ha tocado un byte del contenido. - No hay que fusionar los
DEXen uno. El límite de 65.536 referencias a método por fichero existe justamente para que no haga falta, y fusionarlos exigiría reescribir todas las tablas de índices.
6.3 El detalle semántico que sí importa
El orden de carga es semántico. Si la misma clase está en dos DEX, Android usa la del que carga
primero (classes.dex, luego classes2.dex…). Por eso el DEX del módulo va detrás de los del
base: el módulo no debe poder sustituir clases del base. Colocarlo delante cambia el comportamiento
de la aplicación de forma difícil de diagnosticar.
Y el límite duro: el conjunto de nombres tiene que ser classes.dex, classes2.dex, … sin
huecos. ART abre el siguiente mientras lo encuentre y para en el primer hueco. Si hay un
classes7.dex pero no un classes6.dex, Android deja de buscar y no carga classes7.dex ni los
siguientes, sin un aviso (libdexfile/dex/dex_file_loader.cc:410-427 en android-17.0.0_r1).
7. Bibliotecas nativas y assets
7.1 Las rutas no colisionan, y está medido
La «sección 2.2 · Qué colisiona de verdad: medido» lo cuantifica: ninguna ruta bajo lib/, res/ o assets/ aparece en dos splits
con contenido distinto. Y tiene sentido estructural. Cada split de ABI aporta un directorio
lib/<abi>/ diferente, con una sola ABI, y casi todo split de densidad o idioma aporta ficheros de
res/ que el base no tiene. Las pocas excepciones son splits como los de densidad de
com.lemon.lvoverseas, que repiten unas pocas rutas de res/ del base.
Gin Rummy Frenzy lo enseña bien: split_config.arm64_v8a.apk trae 21 .so de la aplicación y
split_gpdeku.config.arm64_v8a.apk trae una del módulo, todas bajo lib/arm64-v8a/ y ninguna con
el mismo nombre:
split_config.arm64_v8a libil2cpp.so libunity.so libmain.so libpairipcore.so libFirebaseCppApp-12_10_0.so … (21)
split_gpdeku.config.arm64_v8a libgpdeku.so (1)
Lo que sí hay que hacer es deduplicar las rutas idénticas (541 en Twitch 31.8.0). Son el mismo
fichero repetido en varios splits, casi siempre imágenes de res/ de las distintas densidades (res/drawable-hdpi-v4, res/drawable-mdpi-v4, res/drawable-xxhdpi-v4,
res/drawable-xhdpi-v4). Meterlo dos veces produce un ZIP con entradas duplicadas —legal en el
formato, rechazado por Android, y con toda la historia de la vulnerabilidad Master Key detrás
(«Contenedor ZIP → §12 · Nota histórica: Master Key y Janus»).
7.2 extractNativeLibs: el atributo que hay que unificar
Puede diferir entre el base y los splits, y determina si las .so van comprimidas o no. En el
.apkm de Pokémon TCG Pocket 1.7.5, base.apk declara extractNativeLibs="false" y
split_config.arm64_v8a.apk declara true. Pasa en una de cada diez apps con splits y .so.
En el APK fusionado hay un solo manifiesto, así que hay que elegir, y la elección tiene
consecuencias mecánicas:
| Valor elegido | Qué exige del ZIP |
|---|---|
true |
Las .so pueden ir deflate. Se extraen al instalar: ocupa el doble en disco |
false |
Las .so tienen que ir stored, y además alineadas (lista siguiente) |
Con false:
- Las
.sovan sin comprimir (stored). Comprimidas, el instalador rechaza elAPKsiempre. - Cada
.sotiene que empezar en una posición (offset) múltiplo de la página: 4 KiB, o 16 KiB en los dispositivos con páginas de 16 KB. - Para Play, el requisito es de 16 KiB desde
targetSdk35. - En un dispositivo de 16 KB con Android 16 o posterior, una
.soalineada solo a 4 KiB todavía instala: el instalador la extrae. Deja de hacerlo si la app o el sistema desactivan esa compatibilidad —android:pageSizeCompat="disabled"o la propiedadpm.16kb.app_compat.disabled— o si el offset no es múltiplo de 4 KiB.
Lo comprobamos en el muestrario, con la alineación medida en el ZIP (el zipalign -c -P 16 4 de
este documento, no el p_align de los ELF que mide
«Código nativo y ELF»): con false, ninguna pieza de Play
lleva una .so comprimida y ninguna app tiene una .so sin comprimir fuera de múltiplo de 4 KiB.
Fuera de múltiplo de 16 KiB, en cambio, hay entre un 7 % y un 15 % de las apps según la fuente.
Elegir false y dejar las .so comprimidas produce un APK que no llega a instalarse:
INSTALL_FAILED_INVALID_APK: Failed to extract native libraries, res=-2, lo mismo que una .so
desalineada fuera de esos casos (com_android_internal_content_NativeLibraryHelper.cpp:308-342; los
mensajes de logcat, en la «sección 2.5 de Diagnóstico de fallos · Lo que responde adb install, reproducido»). Es
el mismo requisito que la «sección 6.3 de Pipeline de modificación · Lo que hay que preservar a mano, y por qué»,
y la comprobación es zipalign -c -P 16 4.
7.3 Las piezas que no cumplen la alineación de 16 KB
Pocas, pero no es un caso único. Pasan zipalign -c -p 4 y fallan zipalign -c -P 16 4
(-c -p 4 comprueba la alineación de las .so sin comprimir a 4 KiB; -P 16, a 16 KiB) entre el
0,5 % y el 2,5 % de las piezas según la fuente, y el 9 % en el mercado chino.
Casi siempre son splits de ABI o APK únicos alineados a 4 KiB, que era lo correcto cuando se
construyeron. Abundan más en las apps de Play con targetSdk menor de 35, pero la política de 35
no las ha eliminado.
Ejemplos: la pieza split_videoconsult.config.arm64_v8a.apk del .apkm de HealthKart 18.4.2 (el
caso mínimo, de 3 piezas), split_config.armeabi_v7a.apk de Opera 103.1.5234, el
split_config.arm64_v8a.apk de com.dgca.gov.kw (carpeta de adb, targetSdk 35 en el base)
y, fuera de Play, tech.ula de F-Droid, con 8 .so sin comprimir que no llegan ni a 4 KiB
y pasa solo zipalign -c 4. Ese último no es una prueba: zipalign -c 4 solo mira 4 bytes, por eso
la comprobación es -c -p 4.
Al fusionar hay que realinear de todos modos, porque los offsets de destino no son los de origen
(«§8 · Firma, y por qué no hay alternativa»), así que se resuelve solo. Pero conviene saber que el material de partida no siempre cumplía. La
medición, con el (BAD - n) de cada .so, está en la «sección 5.1 de
Alineación y zipalign · Un caso que no cumple».
7.4 assets/
Se copian tal cual y sin índice: no hay tabla que actualizar porque assets/ no está en
resources.arsc. La única regla es la deduplicación de «§7.1 · Las rutas no colisionan, y está medido». Los asset packs de Play Asset
Delivery son un tipo de split más: los de entrega install-time llegan como split_*.apk en las
carpetas de adb y en los .apkm. Aparecen en una de cada nueve apps con splits. Solo llevan
assets/, sin código ni tabla de recursos (hasCode="false", isFeatureSplit="true"), y el nombre
más usado es UnityDataAssetPack.
Ojo con el tamaño. Suelen pesar unos 100 MB, y el mayor que hemos visto, 3.753.688.820 bytes,
se queda a medio giga de los 4.294.967.295 de un ZIP sin ZIP64. Ejemplos: split_UnityDataAssetPack.apk del
.apkm de com.olzhas.carparking.multyplayer 4.9.11 (1,18 GB, Unity),
split_quandui.apk de com.dmluh.lesmqxd (391,5 MB) y el de Unity de
com.winplus.ginrummyfrenzy.android (201,8 MB). Un fusionador tiene que decidir qué hace con
ellos y cuidar el tamaño del ZIP resultante. Los asset packs de otras entregas (on-demand,
fast-follow) viajan aparte, en asset-slices/ dentro de un APK Set, y no los hemos medido.
7.5 Dónde reparte cada marco sus piezas
Una app hecha con un marco multiplataforma reparte sus partes entre las piezas. En Unity, las
bibliotecas libil2cpp.so y libunity.so van en los splits de ABI, y los datos (assets/bin/Data)
en el base, o en un asset pack o un split de textura. En Flutter, libflutter.so y libapp.so van en
los splits de ABI y flutter_assets en el base. En React Native, index.android.bundle va en el
base y libhermes.so en la ABI. Si solo tienes el base, falta el motor; si solo tienes los
splits, faltan los datos. Una fusión tiene que conservar todo.
Los números del muestrario siguen ese patrón en los tres marcos, con pocas excepciones (algún
libhermes.so en el base, o datos de Unity en un asset pack). Un ejemplo de Unity: en com.winplus.ginrummyfrenzy.android, libil2cpp.so y libunity.so
están en split_config.arm64_v8a.apk.
8. Firma, y por qué no hay alternativa
El APK fusionado es un ZIP nuevo: entradas en offsets nuevos, Central Directory nuevo, EOCD
nuevo. Ninguna de las firmas de los splits de origen vale, y no por una limitación de las
herramientas: la firma cubre bytes, los bytes han cambiado, y producir una firma válida para el
contenido nuevo exige la clave privada del autor. El razonamiento completo está en la «sección 7.3 de
Pipeline de modificación · La firma original no se puede conservar, y no es culpa de las herramientas».
Lo que hay que hacer, en este orden y sin excepción:
BT=~/Library/Android/sdk/build-tools/37.0.0
$BT/zipalign -P 16 -f 4 fusionado.apk alineado.apk
$BT/apksigner sign --ks clave.p12 --ks-type PKCS12 --ks-key-alias alias \
--ks-pass env:KSPASS --key-pass env:KEYPASS \
--v2-signing-enabled true --v3-signing-enabled true --out final.apk alineado.apk
$BT/apksigner verify --verbose final.apk
$BT/zipalign -c -P 16 4 final.apk; echo "align exit=$?"
apksigner elige qué tipos de firma poner según la versión mínima de Android que declara la app
(--min-sdk-version; sin esa opción toma el minSdkVersion del manifiesto). No conviene forzarla:
con un 24 fijo, una aplicación de minSdk menor sale sin v1, el verify de la línea siguiente
—que sí usa el del manifiesto— responde DOES NOT VERIFY, y el APK no instala en las API 21 a 23.
Invertir los dos primeros pasos destruye la firma y produce el error Missing META-INF/MANIFEST.MF,
que acusa de un stripping que no hubo. Lo demostramos con salida real en la «sección 4.2 de
Alineación y zipalign · La demostración».
Si compruebas las firmas pieza a pieza, ojo con un falso error. Un split de Play sin
minSdkVersion (los de idioma suelen no llevarlo) y sin firma v1 hace que apksigner verify diga
Missing META-INF/MANIFEST.MF aunque esté bien firmado, porque supone minSdkVersion 1 y exige v1.
Nos pasó con 93 splits de seis apps (cinco de Microsoft Office y Mi Browser), con apksigner de
build-tools 37.0.0 y Java 21.0.10; los 93 verifican si pasas el --min-sdk-version de su base.
Otro caso distinto: algunas piezas del sorteo llevan un firmante v3.2 híbrido (RSA y ML-DSA-65) que
apksigner con Java 21 no sabe leer; con Java 25.0.5 verifican. Descontados esos dos casos, todas
las piezas de cada app comparten certificado. Ejemplos: split_config.en.apk de Microsoft Word 16.0.20611.20014, split_config.arm64_v8a.apk de
Outlook 5.2641.1 (36 de sus 37 piezas no verifican sin la opción) y, en el sorteo,
com.LiiKrass.BrawlBoxSimulator (v3.2 con ML-DSA).
Y la consecuencia para el usuario, que mejor decir antes de que se descubra sola: el APK fusionado
está firmado con otra clave, así que no se instala encima de la aplicación original, no hereda sus
datos, pierde los permisos de nivel signature y deja de recibir actualizaciones de Play.
También cambia el bloque de firma: al volver a firmar se escribe uno nuevo, y si el APK llevaba
un canal de distribución en el viejo, el canal se pierde. Un canal es un identificador de bloque
extra que reconoce el medidor (Walle 0x71777777; VasDolly 0x881155ff). Es cosa del mercado chino,
donde lo lleva casi la mitad de las apps si cuentas también el par 0x71717874 con el texto
channelId=…; fuera de allí es rarísimo. Ejemplos: cn.ninegame.gamemanager
80506001 (Walle) y com.mfw.roadbook 1148 (VasDolly), ambas de la tienda 360, y, el único de Play,
el .apk suelto com.lenovo.anyshare.gps 6.55.28 de APKMirror, con Walle. Lo mismo ocurre con el
sello de la «sección 5.4 · Los <meta-data> que dejan bundletool y Play»: deja de corresponder con la firma nueva. Ambas cosas son consecuencia de
cómo apksigner reescribe el bloque, no una medida (mira los límites de la «sección 1 · Qué es y por qué existe»).
9. La alternativa: no fusionar
Casi siempre es mejor opción.
adb install-multipleestá ejecutado con esta misma forma en «Formatos y extensiones → §6.2 · Extraer el base»:Successcon los splits de Telegram en un emulador Android 14arm64-v8a, el 13 de agosto de 2026, con unAPK Setde Telegram que ya no está en el muestrario. El.xapkde Telegram 13.1.0 que sí está trae tres piezas (org.telegram.messenger.apk,config.arm64_v8a.apkyconfig.xxhdpi.apk) y se instalaría igual:adb install-multiple org.telegram.messenger.apk config.arm64_v8a.apk config.xxhdpi.apk(no ejecutado).install-apksestá ejecutado el 25 de septiembre de 2026, en el mismo emulador y con un APK Set de prueba generado conbundletool1.18.3 (no es parte del muestrario). Sinadben elPATHresponde[BT:1.18.3] Error: Unable to determine the location of ADB.; con--adb ~/Library/Android/sdk/platform-tools/adb, instala («Firma y empaquetado → §7 · Instalar»).
adb install-multiple base.apk config.arm64_v8a.apk config.es.apk config.xxhdpi.apk
java -jar bundletool.jar install-apks --apks app.apks
install-multiple entrega los APK por separado y el sistema los monta como una sola aplicación,
exactamente igual que Play. install-apks hace get-device-spec, extract-apks e
install-multiple en un paso, pero exige toc.pb, así que no sirve para ningún contenedor del
muestrario.
| Situación | Fusionar | No fusionar |
|---|---|---|
Hay dispositivo o emulador y adb |
✔ Preserva el comportamiento original | |
| La herramienta de análisis solo acepta un fichero | ✔ | |
| Instalación desde el propio teléfono, sin PC | ✔ | |
| Archivar un artefacto reproducible | ✔ | |
| La aplicación comprueba su propia estructura de splits | ✔ La fusión la rompe («§10 · Qué se rompe al fusionar, y cómo se detecta») | |
| Hay que modificar y volver a firmar | Solo si además hace falta un único fichero | ✔ Se refirman todos los splits con la misma clave y se instalan con install-multiple, sin perder splitSourceDirs («sección 8 de Pipeline de modificación · Instalar y probar») |
10. Qué se rompe al fusionar, y cómo se detecta
Cinco fallos. Los cuatro primeros son de implementación; el quinto no tiene arreglo.
10.1 NoClassDefFoundError en ejecución
Causa: falta un DEX, o la renumeración dejó un hueco, o el DEX de un módulo de funcionalidad
se colocó delante de los del base y sombreó una clase («§6.3 · El detalle semántico que sí importa»).
Detección, antes de instalar:
unzip -l final.apk | grep -oE "classes[0-9]*\.dex" | sort -V
La lista tiene que ser classes.dex, classes2.dex, … consecutiva y sin huecos, y tiene que
contener tantos ficheros como la suma de los DEX de todos los splits fusionados.
10.2 Recursos que no aparecen
Es el fallo característico de la fusión ingenua, y se reproduce en dos órdenes. El naive.apk es el
base.apk de Google Keep con, encima, lo que traen split_config.es.apk,
split_config.armeabi_v7a.apk y split_config.xhdpi.apk, sin fusionar la tabla. Primero el
base, luego los splits, sin pisar ninguna entrada, y vuelto a comprimir. Fíjate en que el orden
importa: si descomprimes encima con unzip -o, el resources.arsc del último split pisaría el del
base. Lo repetimos el 31 de octubre de 2026:
$BT/aapt2 dump badging naive.apk | grep -E "^(locales|native-code|densities)"
$BT/aapt2 dump resources naive.apk | grep -A1 "resource 0x7f140bec "
locales: '--_--'
densities: '120' '160' '240' '320' '480' '640' '65535'
native-code: 'armeabi-v7a'
resource 0x7f140bec string/abc_action_bar_up_description
() "Navigate up"
locales: '--_--': ni un solo idioma, y de la cadena solo queda su valor por defecto (). Las
.so sí llegaron —copiar ficheros funciona—, pero las traducciones viven en la tabla y la tabla es
la del base: el (es) y el (es-rUS) que traía split_config.es.apk se han perdido.
Efecto colateral: los 44 ficheros de res/ que aportaba split_config.xhdpi.apk están en el
ZIP resultante y ninguna entrada de la tabla apunta a ellos. Y no son solo peso muerto: 43 de
los 44 identificadores de ese split no tienen ningún valor en el base, así que la app fusionada así
pierde esas imágenes. res/-B.png aparece una vez en el ZIP fusionado, cero veces en su
resources.arsc y una vez en el del split original.
La comprobación: aapt2 dump badging sobre el resultado tiene que listar todos los idiomas,
densidades y ABIs que traían los splits de entrada. Si locales sale con solo '--_--', la tabla
no se fusionó.
10.3 Módulos de funcionalidad que se pierden
Causa: el fusionador ignoró los splits con isFeatureSplit=true, o descartó su paquete de
recursos propio («§4.2 · Dónde sí hay dos paquetes»), o no renumeró su DEX («§6 · Renumeración de los DEX»).
Detección: el paquete de cada módulo con tabla (por ejemplo 0x7e en HealthKart) tiene que
estar en la tabla del resultado.
$BT/aapt2 dump resources final.apk | grep "^Package"
Sobre un APK de HealthKart bien fusionado deberían aparecer dos líneas Package:
com.aranoah.healthkart.plus id=7f y com.aranoah.healthkart.plus.videoconsult id=7e. Con AliExpress,
seis (com.alibaba.aliexpresshd 7f y los cinco módulos con tabla: .remoteAIQa 75,
.remoteFeedback 76, .push 77, .widget 78 y .ugc 79). Es lo que esperamos, no una
medición: no hemos ejecutado ninguna fusión.
10.4 Colisiones de identificador
El caso real es el de «§4.2 · Dónde sí hay dos paquetes» y no se resuelve renumerando: si dos paquetes distintos comparten
package ID, o el fusionador lo detecta y aborta, o produce una tabla en la que una de las dos
mitades resuelve a los recursos de la otra. Renumerar exigiría reescribir las constantes de 32 bits
incrustadas en las instrucciones del DEX, que es precisamente lo que la fusión no hace.
Detección: dos Package con el mismo id= en la salida de dump resources. Es un aborto, no
un aviso.
10.5 Aplicaciones que comprueban su propia estructura de splits
El que no tiene arreglo. Una aplicación puede preguntar al sistema qué splits tiene
—ApplicationInfo.splitSourceDirs, splitNames, o la API de Play Feature Delivery
SplitInstallManager— y comportarse distinto si no los encuentra. En un APK fusionado no hay
splits, y la respuesta de splitSourceDirs no es una lista vacía sino nada: queda a null
(PackageImpl.java:2750 en android-17.0.0_r1), y de splitNames la referencia dice «May be null
if no splits are installed». Es la diferencia entre un bucle que no itera y un
NullPointerException.
El síntoma es el de «§10 de Pipeline de modificación · Qué NO se puede modificar de forma realista»: la aplicación instala, arranca y se cierra, o funciona en modo degradado, sin traza útil.
Cuánto importa. PairIP (la comprobación de integridad de Google Play) solo aparece en apps que
se distribuyen en splits, y no es raro: lo lleva un 7 % de las más instaladas de Play y un 27 % del
sorteo. Fuera de Play no lo hemos visto. Ejemplos: el .apkm de com.pazugames.avatarworld 1.226
(con libpairipcore.so) y com.dmluh.lesmqxd (PairIP solo con clases).
En el mercado chino las 100 apps que medimos son APK únicos: no hay nada que fusionar, aunque
cerca de cuatro de cada diez llevan un empaquetador. Una app con PairIP comprueba su integridad, de
modo que cualquier cambio en el APK puede hacerla fallar. No hemos medido cuántas consultan
splitSourceDirs o SplitInstallManager en su DEX, ni cómo reacciona cada protector a una firma
nueva.
Conviene no confundirlo con un antecedente que se le parece pero es otra cosa. La issue #211 de
APKEditor —abierta el 27 de septiembre de 2025 y todavía abierta— recoge alrededor de veinte
aplicaciones fusionadas desde Play que caen con segfault en libpairipcore.so en Android 14 y
15. No es este caso: el mantenedor respondió el mismo día atribuyéndolo al antimanipulación
de PairIP —«any change on the apk could trigger such crash»— y un segundo reportante añade que
tras fusionar y firmar con su propia clave la aplicación funciona, fallando solo al
decompilar y recompilar. Es una comprobación de integridad, no una consulta a
splitSourceDirs. Ver «Anti-análisis y hardening».
Neutralizar esa comprobación está fuera del alcance de esta documentación. Lo que se hace es
detectarlo, informarlo y, si el objetivo era instalar, usar install-multiple («§9 · La alternativa: no fusionar»).
11. Precomprobaciones y receta no reproducida
El .apkm de HealthKart 18.4.2 (3 piezas, 29,5 MB) es el caso difícil porque cruza los problemas a
la vez en solo tres piezas: un módulo con paquete de recursos propio (7e), un classes.dex que
colisiona, un config split de segundo nivel y una pieza que no cumple la alineación de 16 KB. Es
raro juntar los cuatro: entre las más instaladas solo lo hemos visto en HealthKart y en Opera
103.1.5234 (48 piezas). Para un caso con más módulos, AliExpress tiene 5 con tabla propia y 6 con
DEX.
BT=~/Library/Android/sdk/build-tools/37.0.0
MUESTRARIO=<ruta del muestrario>
mkdir healthkart && cd healthkart && unzip -q "$MUESTRARIO"/play/com.aranoah.healthkart.plus_18.4.2-420_2feat_*_apkmirror.com.apkm 'base.apk' 'split_*.apk'
# 0 · invariantes: mismo paquete, mismo versionCode y misma firma en las 3 piezas
for f in *.apk; do $BT/aapt2 dump badging "$f" 2>/dev/null | head -1 \
| grep -oE "name='[^']*' versionCode='[^']*'"; done | sort -u
# → una sola línea: name='com.aranoah.healthkart.plus' versionCode='420'
for f in *.apk; do $BT/apksigner verify --print-certs "$f" 2>/dev/null \
| grep -m1 -o "certificate SHA-256 digest: .*" || echo "sin firma válida: $f"; done \
| sort -u | wc -l # → 1
# un split sin firma, o con la firma rota, no imprime certificado: sin el echo desaparecería
# del recuento y el invariante seguiría dando 1. Un split firmado pero sin minSdkVersion
# también sale como «sin firma válida» si no se pasa --min-sdk-version (sección 8)
# 1 · quién trae código, para saber si hay que renumerar
for f in *.apk; do n=$(unzip -l "$f" | grep -cE " classes[0-9]*\.dex$"); \
[ "$n" -gt 0 ] && echo "$n dex $f"; done
# → 10 dex base.apk · 1 dex split_videoconsult.apk
# 2 · qué paquetes de recursos hay
for f in base.apk split_videoconsult.apk split_videoconsult.config.arm64_v8a.apk; do echo -n "$f -> "; \
$BT/aapt2 dump resources "$f" 2>/dev/null | grep -m1 "^Package" || echo "(sin paquetes)"; done
# → base 7f · videoconsult 7e · config de videoconsult (sin paquetes)
# 3 · qué rutas colisionan de verdad
# cruzar las rutas de todos los splits y comparar el CRC-32 de las repetidas (§2.2)
# → 4.283 rutas · 1 idéntica · 6 en conflicto real
# 4 · alineación del material de partida
for f in *.apk; do $BT/zipalign -c -P 16 4 "$f" >/dev/null 2>&1 || echo "FALLA16 $f"; done
# → FALLA16 split_videoconsult.config.arm64_v8a.apk (y pasa zipalign -c -p 4)
Esos cuatro pasos están ejecutados (31 de octubre de 2026) y su salida es la de «§2.2», «§4.2» y «§6.1»
y la de «§7.3 · Las piezas que no cumplen la alineación de 16 KB». Además, HealthKart tiene el versionCode 420 en las tres piezas, un certificado, 10
DEX en el base y 1 en split_videoconsult.apk, y el paquete 7f y el 7e. La fusión
propiamente dicha —unir tablas, sanear el manifiesto, renumerar— necesitaría APKEditor: según su
README, java -jar APKEditor.jar m -i <aliexpress.apkm> -o aliexpress-fusionado.apk, una orden sin
ejecutar («sección 1 · Qué es y por qué existe», «Lo que no hemos podido comprobar»). Las comprobaciones de «§10.1 · NoClassDefFoundError en ejecución» a «§10.3 · Módulos de funcionalidad que se pierden» son las
que habría que aplicarle al resultado.
11.1 Receta mínima, de principio a fin
- Comprueba que tienes todas las piezas («§2.1 · Los tres invariantes que se comprueban antes de empezar») y que las firmas coinciden.
- Fusiona con una herramienta (APKEditor, «§11 · Precomprobaciones y receta no reproducida»).
- Alinea con
zipalign -P 16 -f 4y firma conapksigner(«§8 · Firma, y por qué no hay alternativa»). - Verifica:
aapt2 dump badgingtiene que listar los idiomas, densidades y ABI de las piezas de entrada («§10.2 · Recursos que no aparecen»), yaapt2 dump resources … | grep ^Packagetiene que mostrar un paquete por módulo con tabla («§10.3 · Módulos de funcionalidad que se pierden»). - Instala en un emulador y mira
logcat.
Los pasos 2 y 5 no los hemos ejecutado en este documento. Cuando se ejecute APKEditor, habrá que aplicarle «§10.1 · NoClassDefFoundError en ejecución» a «§10.3 · Módulos de funcionalidad que se pierden» sobre HealthKart y AliExpress.
Fuentes
Todas las URL se consultaron el 12 de agosto de 2026, salvo que se diga otra fecha.
- About Android App Bundles — https://developer.android.com/guide/app-bundle · el modelo de distribución por splits y la generación del lado de Play («§1 · Qué es y por qué existe»).
- bundletool — https://developer.android.com/tools/bundletool · la sintaxis de
build-apks,--mode=universal,extract-apks,install-apksy el formato de la especificación de dispositivo («§3.3», «§5.3», «§9»). - adb — https://developer.android.com/tools/adb ·
install-multiple(«§9 · La alternativa: no fusionar»), ejecutado en «Formatos y extensiones → §6.2 · Extraer el base». split-selectdebuild-tools37.0.0 — texto de ayuda de la propia herramienta, ejecutado el 12 de agosto de 2026, y las ejecuciones sobre el Keep del muestrario del 31 de octubre de 2026. De aquí sale el formato del<config>extendido (resource-qualifiers:extended-qualifiers) y la lista de arquitecturas admitidas («§3.2 · La herramienta oficial que casi nadie usa: split-select»).- APKEditor — README — https://raw.githubusercontent.com/REAndroid/APKEditor/master/README.md ·
la sintaxis de
mergede «§11 · Precomprobaciones y receta no reproducida», no ejecutada. - AOSP y ART, etiqueta
android-17.0.0_r1— https://android.googlesource.com/platform/frameworks/base/+/refs/tags/android-17.0.0_r1/tools/split-select/Main.cpp y https://android.googlesource.com/platform/art/+/refs/tags/android-17.0.0_r1/libdexfile/dex/dex_file_loader.cc · Consultado el 18 de octubre de 2026. DeMain.cpp:120-237(2014), qué leesplit-selectde cada split («§3.2 · La herramienta oficial que casi nadie usa: split-select»); dedex_file_loader.cc:410-427, que la carga declasses*.dexpara en el primer hueco («§6.3 · El detalle semántico que sí importa»); y decore/java/com/android/internal/pm/parsing/pkg/PackageImpl.java:2750, enframeworks/base, quesplitSourceDirsqueda anullsin splits («§10.5 · Aplicaciones que comprueban su propia estructura de splits»). ApplicationInfo— https://developer.android.com/reference/android/content/pm/ApplicationInfo · Consultado el 18 de octubre de 2026. «May be null if no splits are installed», desplitNamesysplitSourceDirs(«§10.5 · Aplicaciones que comprueban su propia estructura de splits»).- bundletool — la página de la fuente 2, consultada de nuevo el 18 de octubre de 2026: «the underlying tool that Android Studio, the Android Gradle plugin, and Google Play use» («§3.2 · La herramienta oficial que casi nadie usa: split-select»).
- bundletool — código fuente, commit
586a43a(versión 1.18.3, 15 de diciembre de 2025) — https://github.com/google/bundletool/blob/586a43a/src/main/java/com/android/tools/build/bundletool/model/utils/SplitsXmlInjector.java y, bajo el mismosrc/main/java/com/android/tools/build/bundletool/,model/AndroidManifest.java,model/ManifestEditor.java,mergers/ModuleSplitsToShardMerger.java,splitters/AbiNativeLibrariesSplitter.javaycommands/BuildApksManager.java· Consultado el 18 de octubre de 2026. DeSplitsXmlInjector.java:40-48y:146-196,com.android.vending.splitsy sures/xml/splitsN.xml; deAndroidManifest.java:267-276yManifestEditor.java:290-324, las otras dos claves y la cita «not read by the system»; deAbiNativeLibrariesSplitter.java:84(y sus análogos de densidad y assets), cuándo se escribesplits.required; deModuleSplitsToShardMerger.java:170-175yBuildApksManager.java:158-168y:193-212, que el universal es unAPKautónomo confused.modulesysplits(«§5.4 · Los <meta-data> que dejan bundletool y Play»). La búsqueda decom.android.vending.derived.apk.iden todosrc/mainno devuelve nada. - ARSCLib, commit
089ec68del 4 de octubre de 2026, y APKEditor, commit5621fe6del mismo día — https://github.com/REAndroid/ARSCLib/blob/089ec68/src/main/java/com/reandroid/apk/AndroidManifestBlockSplitSanitizer.java · Consultado el 18 de octubre de 2026. DeAndroidManifestBlockSplitSanitizer.java:42-68, los atributos y<meta-data>que quita al fusionar; deapk/ApkModule.java:1234-1253, que añade los módulos fusionados afused.modules; y delREADME.mdde APKEditor, el registro de una fusión de ejemplo que quitasplits.required,splitsconres/xml/splits0.xmlyderived.apk.id(«§5.4 · Los <meta-data> que dejan bundletool y Play»). split-selectylibandroidfw, etiquetaandroid-17.0.0_r1— https://android.googlesource.com/platform/frameworks/base/+/refs/tags/android-17.0.0_r1/tools/split-select/Main.cpp y, bajo el mismoframeworks/base,tools/split-select/Grouper.cpp,tools/split-select/SplitSelector.cppylibs/androidfw/ResourceTypes.cpp. Consultado el 18 de octubre de 2026. DeMain.cpp:214-223,:330y:362sale que las configuraciones del base entran en la selección y que el base no se imprime; deGrouper.cpp:40-44ySplitSelector.cpp:37-57, cómo se agrupan las candidatas y se elige una por grupo; y deResourceTypes.cpp:2876-2901, la preferencia por reducir desde la densidad mayor, que explica por quéxxhdpino selecciona ningún split ymdpiyhdpiseleccionanxhdpi(«§3.2 · La herramienta oficial que casi nadie usa: split-select»).NativeLibraryHelper, etiquetaandroid-17.0.0_r1— https://android.googlesource.com/platform/frameworks/base/+/refs/tags/android-17.0.0_r1/core/jni/com_android_internal_content_NativeLibraryHelper.cpp ycore/java/com/android/internal/content/NativeLibraryHelper.java, en el mismo árbol. Consultado el 18 de octubre de 2026. Decom_android_internal_content_NativeLibraryHelper.cpp:308-342sale que, conextractNativeLibs="false", una.socomprimida se rechaza siempre y unastoredque no está alineada a la página se extrae si está a 4 KiB y la compatibilidad de 16 KB sigue activa; de:546-556, que esa compatibilidad solo existe con páginas de 16 KB y la apaga la propiedadpm.16kb.app_compat.disabled; y deNativeLibraryHelper.java:104-105, que la otra forma de apagarla es elandroid:pageSizeCompat="disabled"del manifiesto («§7.2 · extractNativeLibs: el atributo que hay que unificar»).- Ejecución local de
split-selectsobre splits sintéticos — 18 de octubre de 2026,split-selectyaapt22.20-15087165 debuild-tools37.0.0. Un base con un recurso enxxhdpiy dos splits,config.xhdpiyconfig.es, generados conaapt2 link --split:--target en-rUS-xxhdpi-v34no imprime nada,fr-rFR-mdpi-v30yeu-rES-hdpi-v34imprimenconfig.xhdpi, yes-rES-xhdpi-v34,config.esyconfig.xhdpi(«§3.2 · La herramienta oficial que casi nadie usa: split-select»). Hoy se conserva como reproducción mínima del patrón; la prueba con las piezas del Keep del muestrario es la de «§3.2 · La herramienta oficial que casi nadie usa: split-select». - Cifras del muestrario — descrito en «El muestrario».
Las pruebas hechas a mano (
split-select,naive.apk, volcado de 40 bytes, receta de «§11 · Precomprobaciones y receta no reproducida») se describen en el texto con su orden.