Fusión de splits

Antes conviene leer «AAB, splits y contenedores» · «Tabla de recursos»

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

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, .apkm y .xapk directamente, el resultado sigue siendo un análisis por partes.
  • Instalación fuera de Play, sin adb. Quien descarga un .xapk y quiere instalarlo desde el propio teléfono no tiene install-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

1 APK16 piezas1 SELECCIONAR («§3 · Selección de configuración»)baseconfig.*ugcwidget…¿cuáles?manifest← saneado («§5 · Saneado del manifiesto»)arsc← tablasfusionadas («§4 · Fusión de las tablas de recursos»)classes*← DEXrenumerados(«§6 · Renumeración de los DEX»)res/← copiado («§7 · Bibliotecas nativas y assets»)lib/← copiado («§7 · Bibliotecas nativas y assets»)assets/← copiado («§7 · Bibliotecas nativas y assets»)alinear · FIRMAR(«§8 · Firma, y por qué no hay alternativa»)

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.

  1. Mismo package en todos los splits.
  2. Mismo android:versionCode en todos.
  3. Misma clave de firma en todos. PackageManager los trata como una sola aplicación, y un digest de certificado distinto hace que la sesión de instalación falle con INSTALL_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, cuyo split_df_gemini_nano.apk declara 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, ese config.en solo trae variantes regionales (en-AU, en-CA, en-GB, en-IN, en-XC): por eso en-rUS no 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 badging los lista).
  • Las densidades las explica el modelo de la herramienta. split-select no 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), y xhdpi es su único split de densidad. Por eso xxhdpi no selecciona ningún split —gana el base— y mdpi y hdpi seleccionan config.xhdpi: las tres líneas de arriba. Los pasos del código de la herramienta están en la fuente 11.
  • Un objetivo arm64-v8a selecciona config.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, minSdkVersion 30). 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-v8a de solo 64 bits esos splits fallan con INSTALL_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 del ZIP no está dentro del fichero —el header_item no 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 checksum ni la signature. No se ha tocado un byte del contenido.
  • No hay que fusionar los DEX en 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:

  1. Las .so van sin comprimir (stored). Comprimidas, el instalador rechaza el APK siempre.
  2. Cada .so tiene 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.
  3. Para Play, el requisito es de 16 KiB desde targetSdk 35.
  4. En un dispositivo de 16 KB con Android 16 o posterior, una .so alineada 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 propiedad pm.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-multiple está ejecutado con esta misma forma en «Formatos y extensiones → §6.2 · Extraer el base»: Success con los splits de Telegram en un emulador Android 14 arm64-v8a, el 13 de agosto de 2026, con un APK Set de Telegram que ya no está en el muestrario. El .xapk de Telegram 13.1.0 que sí está trae tres piezas (org.telegram.messenger.apk, config.arm64_v8a.apk y config.xxhdpi.apk) y se instalaría igual: adb install-multiple org.telegram.messenger.apk config.arm64_v8a.apk config.xxhdpi.apk (no ejecutado). install-apks está ejecutado el 25 de septiembre de 2026, en el mismo emulador y con un APK Set de prueba generado con bundletool 1.18.3 (no es parte del muestrario). Sin adb en el PATH responde [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

  1. Comprueba que tienes todas las piezas («§2.1 · Los tres invariantes que se comprueban antes de empezar») y que las firmas coinciden.
  2. Fusiona con una herramienta (APKEditor, «§11 · Precomprobaciones y receta no reproducida»).
  3. Alinea con zipalign -P 16 -f 4 y firma con apksigner («§8 · Firma, y por qué no hay alternativa»).
  4. Verifica: aapt2 dump badging tiene que listar los idiomas, densidades y ABI de las piezas de entrada («§10.2 · Recursos que no aparecen»), y aapt2 dump resources … | grep ^Package tiene que mostrar un paquete por módulo con tabla («§10.3 · Módulos de funcionalidad que se pierden»).
  5. 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.

  1. 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»).
  2. bundletool — https://developer.android.com/tools/bundletool · la sintaxis de build-apks, --mode=universal, extract-apks, install-apks y el formato de la especificación de dispositivo («§3.3», «§5.3», «§9»).
  3. adb — https://developer.android.com/tools/adb · install-multiple («§9 · La alternativa: no fusionar»), ejecutado en «Formatos y extensiones → §6.2 · Extraer el base».
  4. split-select de build-tools 37.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»).
  5. APKEditor — README — https://raw.githubusercontent.com/REAndroid/APKEditor/master/README.md · la sintaxis de merge de «§11 · Precomprobaciones y receta no reproducida», no ejecutada.
  6. 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. De Main.cpp:120-237 (2014), qué lee split-select de cada split («§3.2 · La herramienta oficial que casi nadie usa: split-select»); de dex_file_loader.cc:410-427, que la carga de classes*.dex para en el primer hueco («§6.3 · El detalle semántico que sí importa»); y de core/java/com/android/internal/pm/parsing/pkg/PackageImpl.java:2750, en frameworks/base, que splitSourceDirs queda a null sin splits («§10.5 · Aplicaciones que comprueban su propia estructura de splits»).
  7. 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», de splitNames y splitSourceDirs («§10.5 · Aplicaciones que comprueban su propia estructura de splits»).
  8. 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»).
  9. 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 mismo src/main/java/com/android/tools/build/bundletool/, model/AndroidManifest.java, model/ManifestEditor.java, mergers/ModuleSplitsToShardMerger.java, splitters/AbiNativeLibrariesSplitter.java y commands/BuildApksManager.java · Consultado el 18 de octubre de 2026. De SplitsXmlInjector.java:40-48 y :146-196, com.android.vending.splits y su res/xml/splitsN.xml; de AndroidManifest.java:267-276 y ManifestEditor.java:290-324, las otras dos claves y la cita «not read by the system»; de AbiNativeLibrariesSplitter.java:84 (y sus análogos de densidad y assets), cuándo se escribe splits.required; de ModuleSplitsToShardMerger.java:170-175 y BuildApksManager.java:158-168 y :193-212, que el universal es un APK autónomo con fused.modules y splits («§5.4 · Los <meta-data> que dejan bundletool y Play»). La búsqueda de com.android.vending.derived.apk.id en todo src/main no devuelve nada.
  10. ARSCLib, commit 089ec68 del 4 de octubre de 2026, y APKEditor, commit 5621fe6 del 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. De AndroidManifestBlockSplitSanitizer.java:42-68, los atributos y <meta-data> que quita al fusionar; de apk/ApkModule.java:1234-1253, que añade los módulos fusionados a fused.modules; y del README.md de APKEditor, el registro de una fusión de ejemplo que quita splits.required, splits con res/xml/splits0.xml y derived.apk.id («§5.4 · Los <meta-data> que dejan bundletool y Play»).
  11. split-select y libandroidfw, 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, bajo el mismo frameworks/base, tools/split-select/Grouper.cpp, tools/split-select/SplitSelector.cpp y libs/androidfw/ResourceTypes.cpp. Consultado el 18 de octubre de 2026. De Main.cpp:214-223, :330 y :362 sale que las configuraciones del base entran en la selección y que el base no se imprime; de Grouper.cpp:40-44 y SplitSelector.cpp:37-57, cómo se agrupan las candidatas y se elige una por grupo; y de ResourceTypes.cpp:2876-2901, la preferencia por reducir desde la densidad mayor, que explica por qué xxhdpi no selecciona ningún split y mdpi y hdpi seleccionan xhdpi («§3.2 · La herramienta oficial que casi nadie usa: split-select»).
  12. NativeLibraryHelper, etiqueta android-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 y core/java/com/android/internal/content/NativeLibraryHelper.java, en el mismo árbol. Consultado el 18 de octubre de 2026. De com_android_internal_content_NativeLibraryHelper.cpp:308-342 sale que, con extractNativeLibs="false", una .so comprimida se rechaza siempre y una stored que 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 propiedad pm.16kb.app_compat.disabled; y de NativeLibraryHelper.java:104-105, que la otra forma de apagarla es el android:pageSizeCompat="disabled" del manifiesto («§7.2 · extractNativeLibs: el atributo que hay que unificar»).
  13. Ejecución local de split-select sobre splits sintéticos — 18 de octubre de 2026, split-select y aapt2 2.20-15087165 de build-tools 37.0.0. Un base con un recurso en xxhdpi y dos splits, config.xhdpi y config.es, generados con aapt2 link --split: --target en-rUS-xxhdpi-v34 no imprime nada, fr-rFR-mdpi-v30 y eu-rES-hdpi-v34 imprimen config.xhdpi, y es-rES-xhdpi-v34, config.es y config.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».
  14. 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.