El contenedor ZIP de un APK
Antes conviene leer «Anatomía de un APK»
1. Qué es y por qué existe
Un APK es un ZIP. No «se parece a», no «usa una variante de»: es un archivo ZIP normal y
unzip lo abre. En el muestrario no hubo ninguna excepción. Todas las piezas (cada pieza es un
APK, suelto o sacado de un contenedor) y todos los contenedores se pudieron recorrer enteros,
también los de apps protegidas del mercado chino.
Lo que cambia de un APK a otro es lo que hay dentro, no el formato. Un ZIP se convierte en APK
por convención: AndroidManifest.xml en formato «AXML», el código en
classes*.dex, la tabla de recursos en resources.arsc, y el resto repartido entre res/,
assets/, lib/<abi>/ y META-INF/.
Esa lista describe un APK entero: la pieza base o la única. El manifiesto y resources.arsc
están siempre, y classes*.dex casi siempre (solo falta en org.rayg.streaktracker 12, de
F-Droid). META-INF/ falta en unas pocas, las que solo llevan firma v2 o superior, como la base
de com.brave.browser 1.97.59. lib/ depende mucho de la fuente: la llevan algo más de la mitad
de las apps de F-Droid, menos de un tercio de las más instaladas de Google Play y todas las del
mercado chino.
Un split (un APK parcial que Google Play entrega junto a la base, ver
«AAB, splits y contenedores») es otra cosa: cada uno lleva solo
una parte. Todos traen manifiesto, pero classes*.dex solo aparece en el 2 % de las piezas de
Google Play. Las entradas de directorio (nombre acabado en «/») son una rareza: 2 piezas en todo
el muestrario.
Como control con otra herramienta, unzip -tqq (UnZip 6.00) devolvió 0, sin error, en cuatro
ficheros elegidos por raros:
com.dsi.ant.service.socket4.18.00: empieza con una cabecera local sin nombre de 132 bytes («sección 11 · Lectura tolerante frente a lectura estricta»).- El
.xapkde Sweet Selfie 5.7.1776: pese al nombre, escribe el ZIP como APKCombo («sección 7.3 · Qué aparece de verdad en el muestrario»). com.qihoo.browser10010726, protegida con Jiagu 360.com.tencent.tmgp.yongyong.mrzh744, del mercado chino: 4.076.962.064 bytes, la pieza más grande.
Que sea un ZIP no es un detalle de empaquetado: es una decisión de diseño que se paga en cada
capa por encima. El ZIP tiene un índice al final —el Central Directory— y una copia parcial de
ese índice delante de cada fichero —el Local File Header—. Esa duplicación permite
descomprimir en streaming, y es también el origen de las dos vulnerabilidades más conocidas de
Android («sección 12 · Nota histórica: Master Key y Janus»). El ZIP permite además guardar entradas sin comprimir. Gracias a eso, el
sistema puede mapear resources.arsc y los .so directamente en memoria en vez de copiarlos a
RAM; de ahí las reglas de alineación de la «sección 10 · Reglas propias de Android».
Este documento es el fundamento del resto de esta documentación: cualquier herramienta que toque un APK empieza por abrir su ZIP, y casi todos los fallos de «Diagnóstico de fallos» se explican en esta capa.
Endianness: todas las estructuras del ZIP son little-endian. Todos los offsets de las tablas de este documento son relativos al inicio de la estructura descrita.
Cómo leer este documento. Si solo quieres saber qué hay dentro de un APK, lee las secciones «1», «2» y «13.1». Si vas a escribir un lector de ZIP, lee de la 3 a la 8 y la 11. Si analizas APK retocados, lee la 11 y la 12.
Un recorrido completo. Un ZIP se lee de atrás hacia delante. Estos son los saltos en
com.termux_1022.apk (114.920.926 bytes, de F-Droid):
EOCD (offset 114.920.904)
└─ dice: el índice está en 114.872.320 y tiene 745 entradas
Central Directory (offset 114.872.320, 48.584 bytes)
└─ la entrada de resources.arsc dice: mi cabecera local está en 113.977.743
Local File Header (offset 113.977.743)
└─ 30 bytes + nombre (14) + extra (1) → los datos empiezan en 113.977.788
Las recetas de la «sección 13 · Recetas» repiten este recorrido con comandos.
2. Layout global
Un ZIP se lee de atrás hacia delante. El único punto de entrada fiable es el EOCD, que
está al final; de ahí se salta al Central Directory, y de cada entrada del
Central Directory se salta al Local File Header correspondiente.
offset 0
┌────────────────────────────────────────────────────────────┐
│ Local File Header (entrada 1) │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ datos de la entrada 1 (stored o deflate) │ │
│ └────────────────────────────────────────────────────────┘ │
│ [data descriptor (entrada 1)] ← solo si bit 3 │
├────────────────────────────────────────────────────────────┤
│ Local File Header (entrada 2) + datos + [data descriptor] │
├────────────────────────────────────────────────────────────┤
│ … │
├════════════════════════════════════════════════════════════┤
│ APK Signing Block ← no es ZIP: hueco propio de Android │
├────────────────────────────────────────────────────────────┤
│ Central Directory (una entrada por fichero, en orden) │
├────────────────────────────────────────────────────────────┤
│ [Zip64 EOCD record] [Zip64 EOCD locator] ← si zip64 │
├────────────────────────────────────────────────────────────┤
│ End Of Central Directory + [comentario] │
└────────────────────────────────────────────────────────────┘
fin de fichero
Las estructuras zip64 y el APK Signing Block no conviven en un APK que Android verifique
con v2 o superior: si hay Zip64 EOCD locator, ApkSigningBlockUtils.findSignature lanza
«ZIP64 APK not supported» y no llega a buscar el bloque. Zip64 es la ampliación del formato para
ficheros o índices de más de 4 GiB.
En el muestrario nadie lo usa: ninguna pieza ni ningún contenedor lleva Zip64 EOCD locator.
Ni siquiera la pieza más grande, com.tencent.tmgp.yongyong.mrzh 744 (mercado chino), que con
4.076.962.064 bytes roza el límite de 4 GiB (el 94,9 % de 4.294.967.296) y sigue siendo un ZIP normal. Hay un
uso a medias: jp.kakao.piccoma 8.6.0 (Google Play) lleva el registro 0x0001 en 65 cabeceras
locales, pero en ninguna del Central Directory y sin locator, así que la comprobación de
ApkSigningBlockUtils no salta. Que Android rechace un APK con locator viene del código de AOSP;
no lo hemos probado.
El APK Signing Block no forma parte de la especificación ZIP. Es un bloque que Android
inserta entre el último dato y el Central Directory, aprovechando que ningún lector de
ZIP mira ahí: el EOCD apunta al Central Directory por offset absoluto, así que el hueco
intermedio se ignora. La especificación de la firma v2 lo describe así:
«Contents of ZIP entries (from offset 0 until the start of APK signing block) / APK signing block / ZIP Central Directory / ZIP End of Central Directory»
Medido sobre el «muestrario», el hueco es eso:
| APK | Fin de datos | Offset del Central Directory |
Hueco |
|---|---|---|---|
com.termux_1022.apk |
114.865.050 | 114.872.320 | 7.270 |
org.fdroid.fdroid_2000052.apk |
12.484.844 | 12.492.800 | 7.956 |
org.fossify.camera_11.apk |
10.144.084 | 10.148.180 | 4.096 |
com.dsi.ant.service.socket_4.18.00-41800_minAPI7(nodpi)_apkmirror.com.apk |
121.622 | 125.899 | 4.277 |
Fíjate en la columna «Hueco»: es el espacio entre el último dato y el Central Directory. Cómo
sale en cada una de las cuatro:
- Termux 1022 (F-Droid): 7.270 bytes, que son el bloque (4.096) más el relleno (3.174).
- F-Droid 2.0.2 (
org.fdroid.fdroid_2000052, 12.569.951 bytes): 7.956, que son 4.096 más 3.860. - Fossify Camera 11 (F-Droid): 4.096, solo el bloque y nada de relleno.
com.dsi.ant.service.socket(Google Play, vía APKMirror): 4.277, todo bloque; no es múltiplo de 4.096 y no lleva relleno.
En las cuatro, los 16 bytes que preceden al Central Directory son la cadena APK Sig Block 42.
La llevan casi todas las apps; las que no, solo tienen firma v1, como
pro.rudloff.lineageos_updater_shortcut 2.
El hueco no siempre es solo el bloque. Delante puede haber hasta 4.095 bytes a cero de relleno,
para que el bloque empiece en un múltiplo de 4.096 («sección 8 de
APK Signing Block · El bloque de relleno»). En com.termux_1022.apk el bloque
mide 4.096 bytes y los 3.174 restantes son ese relleno («sección 9 de
APK Signing Block · El volcador»); en org.fdroid.fdroid_2000052.apk,
4.096 y 3.860. Los dos rellenos los hemos leído del fichero y son todo ceros. Que haya relleno
depende de quién firma, no del formato, y el tamaño del bloque también varía. Por eso el
bloque se localiza hacia atrás desde el Central Directory, con el tamaño que guarda al
final, y no desde el fin de los datos. Ver «APK Signing Block».
El tope de 4.095 bytes sale de los offsets (ninguna pieza con 4.096 o más), no de leer los ceros de cada app; es uno de los límites del recuadro de la «sección 1 · Qué es y por qué existe».
2.1 Cómo es un APK típico
¿Es mucho tener 745 entradas, como com.termux_1022.apk? Depende de dónde se descargue. Esta es
la pieza base o única de cada app, con la mediana por fuente (la «sección 3.5 de
Anatomía de un APK · Lo normal: el inventario sobre muchos APK» da 3.186 en Google Play y 8.937 en
el mercado chino, porque cuenta las entradas de otra manera):
| Fuente | Tamaño (bytes) | Entradas | Bytes comprimidos que van sin comprimir (stored) |
|---|---|---|---|
| F-Droid | 6.543.435,5 | 660 (p10 96; p90 1.478) | 36 % |
| IzzyOnDroid | 6.543.639,5 | 763 | 35 % |
| Google Play (más instaladas) | 76.437.189 | 3.197,5 (p10 885; p90 8.742) | 88 % |
| Google Play (sorteo) | 32.695.031 | 1.033 | 91 % |
| Mercado chino | 184.534.695 | 9.390,5 | 26 % |
La diferencia entre fuentes es enorme. Un APK típico de F-Droid ronda las 660 entradas y 6,5 MB; uno de las más instaladas de Google Play, unas 3.200 entradas y 76 MB; uno del mercado chino, más de 9.000. Termux, con 745, es un APK de F-Droid normal (el p90 es el valor bajo el que cae el 90 %). Fíjate también en la última columna: en Google Play casi nueve de cada diez bytes van sin comprimir, y en F-Droid, un tercio. Las cifras de Google Play son de la pieza base o única, no de la descarga completa, que incluye los splits.
3. Firmas mágicas
| Estructura | Firma | Bytes en el fichero |
|---|---|---|
Local File Header |
0x04034b50 |
50 4B 03 04 |
Central Directory (entrada) |
0x02014b50 |
50 4B 01 02 |
End Of Central Directory |
0x06054b50 |
50 4B 05 06 |
data descriptor (opcional) |
0x08074b50 |
50 4B 07 08 |
Zip64 EOCD record |
0x06064b50 |
50 4B 06 06 |
Zip64 EOCD locator |
0x07064b50 |
50 4B 06 07 |
Los dos primeros bytes son siempre PK.
Ojo con el uso de estas firmas como criterio de búsqueda: 50 4B 03 04 puede aparecer por
casualidad dentro de datos comprimidos. Solo el Central Directory dice dónde empieza de
verdad cada entrada.
Un caso real: com.termux_1022.apk tiene 745 entradas, pero esa secuencia sale 916 veces en el
fichero. Quien busque firmas en vez de leer el índice se equivoca 171 veces en ese APK (no las
hemos clasificado una a una). En org.fdroid.fdroid_2000052.apk, en cambio, coinciden: 973 y
973. Son dos casos, no una proporción, y por eso una sola prueba no basta. Se cuentan con
python3 -I -c "import sys;b=open(sys.argv[1],'rb').read();print(b.count(b'PK\x03\x04'))" <pieza>.
4. Local File Header
Precede a los datos de cada entrada. Tamaño fijo de 30 bytes (0x1E) más el nombre y el
extra field.
| Campo | Offset | Tamaño | Tipo | Significado |
|---|---|---|---|---|
local file header signature |
0x00 | 4 | uint32_t |
0x04034b50 |
version needed to extract |
0x04 | 2 | uint16_t |
Versión mínima del lector, en décimas: 20 = 2.0 |
general purpose bit flag |
0x06 | 2 | uint16_t |
Bits de control. El bit 3 y el bit 11 son los que importan aquí («sección 7 · data descriptor y el bit 3») |
compression method |
0x08 | 2 | uint16_t |
0 = stored, 8 = deflate («sección 9 · Métodos de compresión») |
last mod file time |
0x0A | 2 | uint16_t |
Hora en formato MS-DOS: hhhhhmmm mmmsssss, segundos en pasos de 2 |
last mod file date |
0x0C | 2 | uint16_t |
Fecha en formato MS-DOS: yyyyyyym mmmddddd, año desde 1980 |
crc-32 |
0x0E | 4 | uint32_t |
CRC-32 de los datos sin comprimir. Cero si el bit 3 está puesto |
compressed size |
0x12 | 4 | uint32_t |
Tamaño comprimido. Cero si bit 3. 0xFFFFFFFF si zip64 |
uncompressed size |
0x16 | 4 | uint32_t |
Tamaño original. Cero si bit 3. 0xFFFFFFFF si zip64 |
file name length |
0x1A | 2 | uint16_t |
Longitud en bytes del nombre |
extra field length |
0x1C | 2 | uint16_t |
Longitud en bytes del extra field |
file name |
0x1E | var | char[] |
Ruta con / como separador, sin / inicial. Codificación: CP437 salvo que el bit 11 esté puesto, y entonces UTF-8 (APPNOTE, apéndice D). libziparchive no mira el bit 11: exige siempre UTF-8 sin NUL, y si un nombre no lo cumple no abre el ZIP («sección 3 de Qué rechaza cada lector · libziparchive: el ZIP») |
extra field |
— | var | — | Cadena de registros id+size («sección 8 · Extra fields») |
Los datos de la entrada empiezan justo después:
offset_datos = offset_LFH + 30 + file_name_length + extra_field_length
Esa fórmula es la que gobierna toda la alineación de Android: el único grado de libertad para
mover el inicio de los datos es extra_field_length.
Nombres de entrada raros. Los nombres peligrosos no aparecen: ninguna pieza lleva .. (el
ataque llamado Zip Slip, que escribe fuera de la carpeta al extraer), caracteres de control ni
componentes de más de 255 bytes. Sí hay rarezas inofensivas: un nombre con / inicial en
com.planes.android 39 (F-Droid), otro con contrabarra en sadLogic.HomeCentral 20
(IzzyOnDroid) y unas pocas decenas de nombres no ASCII, como META-INF/services/ۦۘ۠.ۦۖۨ en
com.applisto.appcloner.premium 4.0.0 (Google Play).
Lo que de verdad pisa ficheros es otra cosa. Dos entradas cuyos nombres solo se distinguen por
mayúsculas, como res/2F.xml y res/2f.xml, se pisan al descomprimir en macOS o Windows. Y no
es raro: lo tienen dos de cada tres apps de F-Droid, aunque solo el 4 % de las piezas de Google
Play. Que vengan del acortado de nombres de recursos es una hipótesis («sección 11 · Lectura tolerante frente a lectura estricta» y
«Tabla de recursos»).
El bit 0 del general purpose bit flag. Dice «esta entrada está cifrada». Se usa a veces como
truco para que unzip o jadx pidan una contraseña aunque no haya nada cifrado (el «falso
cifrado»). En el muestrario no lo lleva ninguna entrada, ni siquiera en las apps protegidas ni en
el mercado chino.
Ejemplo real. Primeros 32 bytes de com.termux_1022.apk:
00000000: 504b 0304 0000 0000 0800 2108 2102 dca9 PK........!.!...
00000010: c923 3300 0000 3700 0000 3900 0000 4d45 .#3...7...9...ME
Firma 50 4b 03 04; version needed = 0; flags = 0x0000; method = 0x0008 (deflate);
time = 0x0821; date = 0x0221; crc-32 = 0x23C9A9DC; compressed size = 51;
uncompressed size = 55; file name length = 57; extra field length = 0. Es la primera
entrada, META-INF/com/android/build/gradle/app-metadata.properties.
El version needed en 0 no es un descuido de este APK. Lo llevan 742 de las 745 entradas de su
Central Directory; las otras 3 llevan 20, tantas como las que usan el bit 11 (nombre en UTF-8).
org.fdroid.fdroid_2000052.apk sigue el mismo patrón. Son dos casos de una muestra de 6 piezas,
no una proporción. Que el Gradle Plugin deje version needed en 0 es una lectura de estos datos;
no hemos mirado su código.
0x0221 decodifica a 1981-01-01 y 0x0821 a 01:01:02. No es la fecha de compilación: es
la constante que el Android Gradle Plugin escribe en todas las entradas para que la salida
sea reproducible (esto viene de AOSP, no de los datos). La llevan todas las entradas en casi
nueve de cada diez apps de F-Droid y de Google Play, y solo en el 12 % del mercado chino. Entre
las apps hechas con el Gradle Plugin 4.1 o posterior (las que llevan app-metadata.properties)
pasa del 99 %. La fecha de la cabecera local coincide siempre con la del Central Directory.
Cuando falta el 1981, otra herramienta ha reescrito el ZIP. La tabla siguiente dice qué herramienta suele ser, y la «sección 7.3 · Qué aparece de verdad en el muestrario» cuenta qué hace con el bit 3.
Qué dice cada fecha. Lee la columna de la izquierda como lo que se ve en las entradas y la de la derecha como lo habitual en el muestrario:
| La fecha de las entradas es… | Lo habitual es que… |
|---|---|
1981-01-01 01:01:02 en todas |
las construyó el Android Gradle Plugin (88 % de las apps de F-Droid) |
1980-01-01 00:00:00 |
las reescribió apksigner (9 apps de F-Droid con firma v1 de apksigner; otras 3 sin v1) |
2009-01-01 00:00:00 |
las firmó SignApk, la herramienta de la plataforma (51 de las 57 apps de Google Play con una sola fecha distinta, y 1 de IzzyOnDroid) |
A cero (1980-00-00 00:00:00) |
las escribió un empaquetador que no pone fecha: los 71 .xapk de APKPure |
| Reales y distintas | un reempaquetado, o un contenedor de tienda (los 388 .apkm de APKMirror) |
Fuera de la primera fila, todos los casos son minoritarios, salvo en el mercado chino, donde las fechas reales y distintas son lo más común. Las dos primeras filas son lecturas de los recuentos por herramienta de la firma v1, no una regla comprobada en el código, y no sabemos por qué hay fechas a cero en F-Droid ni en IzzyOnDroid.
Ejemplos:
com.yixia.videoeditor6792500 (mercado chino): 1.338 de 1.340 entradas con 1981 y el resto con 1980-01-01.pro.rudloff.lineageos_updater_shortcut2 (F-Droid): fechas de 1980-01-01 00:00:00 a 2020-05-20 10:46:10.Emoji keyboard - Themes, Fonts11.1.2 (Google Play, vía APKPure): todas las fechas a cero.- El
.xapkde APKPure «Штрафы ГИБДД: проверка с фото» 6.10: fechas a cero. com.cctv.caijing2026081400 (una de las cinco apps protegidas, solo como ejemplo): de 1981-01-01 a 2026-08-13.
5. Entrada del Central Directory
Una por fichero, todas contiguas. Tamaño fijo de 46 bytes (0x2E) más nombre, extra field y
comentario.
| Campo | Offset | Tamaño | Tipo | Significado |
|---|---|---|---|---|
central file header signature |
0x00 | 4 | uint32_t |
0x02014b50 |
version made by |
0x04 | 2 | uint16_t |
Byte alto: sistema de origen (0 = FAT, 3 = Unix). Byte bajo: versión |
version needed to extract |
0x06 | 2 | uint16_t |
Igual que en el LFH |
general purpose bit flag |
0x08 | 2 | uint16_t |
Debe coincidir con el LFH. En el muestrario el bit 3 coincide en las 15.183 piezas (más abajo) |
compression method |
0x0A | 2 | uint16_t |
0 o 8 |
last mod file time |
0x0C | 2 | uint16_t |
Formato MS-DOS |
last mod file date |
0x0E | 2 | uint16_t |
Formato MS-DOS |
crc-32 |
0x10 | 4 | uint32_t |
Siempre relleno, aunque el LFH lo lleve a cero |
compressed size |
0x14 | 4 | uint32_t |
0xFFFFFFFF si el valor real está en el extra field zip64 |
uncompressed size |
0x18 | 4 | uint32_t |
Igual |
file name length |
0x1C | 2 | uint16_t |
|
extra field length |
0x1E | 2 | uint16_t |
Independiente del extra field length del LFH |
file comment length |
0x20 | 2 | uint16_t |
Casi siempre 0 en un APK |
disk number start |
0x22 | 2 | uint16_t |
0 en archivos de un solo volumen |
internal file attributes |
0x24 | 2 | uint16_t |
Bit 0: fichero de texto. Irrelevante en Android |
external file attributes |
0x26 | 4 | uint32_t |
Permisos Unix en los 16 bits altos cuando version made by dice Unix |
relative offset of local header |
0x2A | 4 | uint32_t |
Offset absoluto del LFH. 0xFFFFFFFF si zip64 |
file name |
0x2E | var | char[] |
|
extra field |
— | var | — | |
file comment |
— | var | char[] |
Qué hemos medido en estos campos. Los flags de la cabecera local y los del Central Directory
deben coincidir, y en el muestrario el bit 3 y la fecha coinciden siempre, también en los
contenedores. Lo que sí cambia entre las dos copias es la longitud del extra field («sección 8.1 · El extra field como relleno de alineación»).
Los únicos valores de flags que aparecen son 0x0000 (con mucho, el más común), 0x0800
(UTF-8), 0x0808, 0x0002, 0x0802 y 0x0008. Los bits 1 y 2 (0x0002) son opciones del
deflate, como «máxima compresión»: no cambian nada al leer. Solo comparamos el bit 3 (y las
fechas) entre las dos copias; los demás bits, no.
El campo version made by no se queda en «FAT» y «Unix». Su byte bajo también sale con 0x14
(versión 2.0), y 0x0000 equivale a «FAT, versión 0». En com.termux_1022.apk hay 641 entradas
con 0x0000, 89 con 0x0014 y 15 con 0x0300. Es una pieza de una muestra de 6, sin cifra para
todo el muestrario.
El crc-32 del Central Directory va siempre relleno, aunque la cabecera local lo tenga a cero por
el bit 3. En las seis piezas que miramos, de todas las fuentes, ninguna entrada con datos lo lleva
a cero. Es una muestra descriptiva, no una proporción; los comandos de la «sección 13.6 · Cómo repetir las medidas» permiten
repetirla.
El comentario de entrada (file comment length) casi siempre es 0: en esas seis piezas, ninguna
entrada llevaba comentario. Los contenedores sí lo usan a veces: los .xapk de APKPure ponen
«ApkPure.com» en buena parte de sus entradas. Los .apkm de APKMirror no llevan ninguno.
El Central Directory es la autoridad. Un lector correcto enumera este índice y nunca
recorre los Local File Header secuencialmente. Las razones prácticas están en la «sección 11 · Lectura tolerante frente a lectura estricta»
y las históricas en la 12.
6. EOCD y cómo se localiza
| Campo | Offset | Tamaño | Tipo | Significado |
|---|---|---|---|---|
end of central dir signature |
0x00 | 4 | uint32_t |
0x06054b50 |
number of this disk |
0x04 | 2 | uint16_t |
0 |
number of the disk with the start of the central directory |
0x06 | 2 | uint16_t |
0 |
total number of entries in the central directory on this disk |
0x08 | 2 | uint16_t |
0xFFFF si zip64 |
total number of entries in the central directory |
0x0A | 2 | uint16_t |
0xFFFF si zip64 |
size of the central directory |
0x0C | 4 | uint32_t |
En bytes. 0xFFFFFFFF si zip64 |
offset of start of central directory |
0x10 | 4 | uint32_t |
Absoluto desde el inicio del fichero. 0xFFFFFFFF si zip64 |
.ZIP file comment length |
0x14 | 2 | uint16_t |
0 a 65.535 |
.ZIP file comment |
0x16 | var | char[] |
Basta con que uno de los cuatro campos marcados «si zip64» valga el máximo para que
libziparchive busque el Zip64 EOCD locator justo delante del EOCD; y lo busca también si
.ZIP file comment length vale 0xFFFF (zip_archive.cc, líneas 328-337). Si no encuentra la
firma del locator, rechaza el archivo con «Zip64 eocd locator signature not found» (línea 233),
así que un ZIP sin zip64 con un comentario de 65.535 bytes justos no se abre.
6.1 El algoritmo de búsqueda
El EOCD es la última estructura del fichero salvo que haya comentario. Como el
comentario va detrás y su longitud solo se conoce leyendo el propio EOCD, no hay forma de
saltar directamente: hay que buscar la firma 0x06054b50 hacia atrás desde el final. El
comentario puede medir hasta 65.535 bytes, así que la ventana máxima es 65.535 + 22 = 65.557
bytes. Es lo que hace libziparchive, el lector de ZIP de AOSP, en
FindCentralDirectoryInfo() —«Scan backward for the EOCD magic. In an archive without a
trailing comment, we'll find it on the first try»— con
static const uint32_t kMaxCommentLen = 65535;.
6.2 Por qué el comentario complica la búsqueda
Tres problemas, en orden de gravedad:
- La firma puede aparecer dentro del comentario. Nada impide que un comentario contenga
los bytes
50 4B 05 06, y un lector que se quede con la primera coincidencia desde el final aterriza en unEOCDfalso. La defensa es validar queoffset_del_EOCD + 22 + comment_length == tamaño_del_fichero; cómo la aplica cada lector está en la tabla que sigue a esta lista. - La firma puede aparecer dentro de los datos de la última entrada, si el comentario es corto y la entrada termina cerca del final.
- Es un vector de ambigüedad deliberada. Dos lectores con criterios distintos —el primero
desde el final frente al último válido— eligen
EOCDdistintos, y por tantoCentral Directorydistintos, sobre el mismo fichero. Es la misma clase de divergencia que la «sección 12 · Nota histórica: Master Key y Janus».
| Lector | Qué firma toma | Qué comprueba |
|---|---|---|
libziparchive |
La primera desde el final | La igualdad; si no cuadra, devuelve kInvalidFile sin seguir buscando |
La verificación de firma (android.util.apk.ZipUtils y ApkSigningBlockUtils) |
La primera desde el final cuya longitud de comentario cuadre: sigue buscando hasta dar con ella | La igualdad y, después, que el Central Directory acabe justo donde empieza el EOCD: «ZIP Central Directory is not immediately followed by End of Central Directory» («sección 4 de Qué rechaza cada lector · El verificador de firmas») |
zipinfo (UnZip 6.0) |
La primera desde el final | La igualdad no: del comentario solo avisa, con -v, si se sale del fichero («The zipfile comment is truncated»), y no mira los bytes que haya detrás. Su «Expected end-cent-dir record offset» es el offset del Central Directory más su tamaño (process.c, líneas 1564-1565); que coincida con el «Actual» quiere decir que el EOCD empieza donde el propio EOCD dice que acaba el Central Directory, la misma condición que exige la verificación de firma |
En la práctica, casi ningún APK lleva comentario en el EOCD: solo 4 piezas en todo el
muestrario, y ningún contenedor. Son estas:
com.topjohnwu.magisk30700 (F-Droid) ycom.topjohnwu.magisk31000 (IzzyOnDroid): el instalador Magisk guarda ahí su versión (version=30.7,versionCode=30700,stubVersion=40, 46 bytes). No cuenta como canal de distribución.GO Launcher - Themes&Wallpapers7.31 (Google Play, vía APKPure): comentario de 10 bytes que acaba en!ZXK!, una marca de canal.com.tencent.tmgp.yongyong.mrzh744 (mercado chino): comentario de 20 bytes conchannelId=2002.
No es una garantía de que no haya comentario: la especificación lo permite y un APK con comentario se instala igual (esto último es una afirmación del documento que el muestrario no mide).
6.3 El EOCD de un APK real
Últimos 22 bytes de com.termux_1022.apk:
06d98dc8: 504b 0506 0000 0000 e902 e902 c8bd 0000 PK..............
06d98dd8: 00d0 d806 0000 ......
Firma; disco 0; disco del Central Directory 0; e9 02 = 745 entradas en este disco y 745 en
total; c8 bd 00 00 = 48.584 bytes de Central Directory; 00 d0 d8 06 = 0x06D8D000 =
114.872.320 de offset; comentario de longitud 0. Ese offset es múltiplo de 4.096 porque el
APK Signing Block va precedido de relleno que lo alinea. No pasa siempre, y el patrón es
limpio: con relleno, el offset es múltiplo de 4.096 casi siempre; sin relleno, solo por
casualidad. Un contraejemplo es org.fossify.camera_11.apk: sin relleno, su Central Directory
está en 10.148.180, que deja resto 2.388 al dividir entre 4.096.
Las pocas excepciones con relleno son 5 apps del mercado chino, y las cinco llevan un par de canal
(3 Walle, 1 0x12344321, 1 0x7a786b21) añadido después de firmar («sección 6.4 · Canales de distribución»). Una es
com.weipaitang.wpt 801, con un par Walle 0x71777777.
6.4 Canales de distribución
Las tiendas chinas marcan cada copia de un APK con su canal de distribución sin tocar la firma. Lo
hacen de tres maneras: un par propio dentro del APK Signing Block (un par es un identificador con
su valor; los de Walle y VasDolly son los más usados), un fichero vacío en META-INF/ o un
comentario en el EOCD («sección 6.2 · Por qué el comentario complica la búsqueda»). Es una costumbre china: casi la mitad de las apps de
ese mercado lleva alguna marca (49 de 100), y fuera de él apenas hay. Las más frecuentes son Walle
(0x71777777), channelId= (0x71717874) y VasDolly (0x881155ff); también aparecen
0x7a786b21, 0x99666666 y ficheros como META-INF/config_channel.txt o
META-INF/channel__360. Como el par se añade después de firmar, explica que el
Central Directory no caiga en un múltiplo de 4.096 en algunas apps con relleno («sección 6.3 · El EOCD de un APK real»). Los pares se describen en «APK Signing Block».
Ejemplos, todos del mercado chino:
cn.ninegame.gamemanager80506001: Walle.com.mfw.roadbook1148: VasDolly.com.tencent.tgclub2026081227:channelId=1030.com.tencent.tmgp.yongyong.mrzh744:channelId=2002en el comentario delEOCD.
7. data descriptor y el bit 3
7.1 Qué es
Cuando un escritor genera un ZIP en streaming —sin poder volver atrás a corregir la
cabecera— no conoce el CRC ni los tamaños al escribir el Local File Header. La
especificación lo resuelve poniendo el bit 3 del general purpose bit flag y escribiendo
un data descriptor detrás de los datos:
«If this bit is set, the fields crc-32, compressed size and uncompressed size are set to zero in the local header. The correct values are put in the data descriptor immediately following the compressed data.»
| Campo | Offset | Tamaño | Tipo | Significado |
|---|---|---|---|---|
data descriptor signature |
0x00 | 4 | uint32_t |
0x08074b50. Opcional según la spec |
crc-32 |
0x04 | 4 | uint32_t |
|
compressed size |
0x08 | 4 (8 si zip64) | uint32_t / uint64_t |
|
uncompressed size |
0x0C (0x10 si zip64) | 4 (8 si zip64) | uint32_t / uint64_t |
Los offsets de la tabla presuponen la firma opcional 50 4B 07 08, que, según APPNOTE 4.3.9.3,
no forma parte del registro: el valor «has commonly been adopted as a signature value». Sin ella,
el crc-32 va en 0x00, compressed size en 0x04 y uncompressed size en 0x08 (0x0C si
zip64).
7.2 Por qué rompe lectores
La firma del data descriptor es opcional. Sin ella, la estructura son 12 bytes sin
marca distintiva, y para saber dónde acaban los datos de una entrada hay que descomprimir el
stream deflate entero y contar. Un lector que quiera avanzar secuencialmente por los
Local File Header sin descomprimir no puede hacerlo. De ahí la regla: leer siempre por
el Central Directory, que sí tiene los tamaños. Cuando el bit 3 del LFH y el del
Central Directory no coinciden, libziparchive emite el aviso "gpb flag mismatch at bit 3"
(ALOGW, sin rechazar la entrada) y sigue con el bit del LFH: «always use the version from
the LFH».
7.3 Qué aparece de verdad en el muestrario
El reparto depende de quién escribe el ZIP. En la tabla, lee la segunda columna como «cuántos tienen el bit 3» y fíjate en que cada fila tiene su propio denominador:
| Universo | Con data descriptor (bit 3) |
|---|---|
| 6.220 APK sueltos | 527 con alguna entrada con el bit 3; ninguno con todas. Por fuente, apps con alguna entrada: F-Droid 410 de 4.766 (9 %), IzzyOnDroid 11 de 1.402 (1 %), Google Play 67 APK sueltos con el bit (10 % de las 658 apps más instaladas), mercado chino 37 de 100 |
388 .apkm (APKMirror) |
9.228 de 9.618 entradas: todas salvo APKM_installer.url y, en 2, icon.png |
71 .xapk (APKPure) |
todas: 561 de 561 entradas |
1 .xapk (APKCombo) |
todas: 20 de 20 entradas |
APK dentro de .apkm, .xapk y carpetas de adb |
1 de 8.963 piezas (0 de 7.288 en .apkm, 0 de 450 en .xapk, 1 de 1.225 en carpetas de adb) |
.apks, ZIP de SAI, .aab |
no hay en el muestrario |
Ojo con el 10 % de Google Play: es sobre las 658 apps, que incluyen .apkm y .xapk cuyos APK
interiores no tienen bit 3; entre los APK sueltos es un tercio. Las piezas que Google Play entrega
a un teléfono (las carpetas de adb) no lo llevan nunca.
Los empaquetadores del Android Gradle Plugin desde la 2.2 («sección 8.1 · El extra field como relleno de alineación») no ponen el bit 3.
apkzlib, y en la 2.2 el mismo código dentro de builder, compone los flags de cada entrada
nueva solo con el bit 11 y se niega a escribir una entrada con data descriptor —en la 3.0,
además, quita los que traiga un ZIP al abrirlo para escribir en él—. zipflinger escribe
siempre 0 en los flags del LFH y del Central Directory.
Entonces, ¿de dónde sale el bit 3 en los APK sueltos? Casi siempre, de la firma v1, que
reescribió el ZIP. La herramienta que firmó en v1 (la del campo Created-By del .SF) cambia
según la fuente: jarsigner en el 97 % de los casos de F-Droid, SignApk en la mayoría de los de
Google Play y apksigner en la mayoría de los del mercado chino. Es una correlación entre dos
recuentos: no hemos abierto el código de jarsigner para confirmar que escriba en streaming, y
los doce de F-Droid con apksigner no los hemos mirado uno a uno.
En el mercado chino, además, el bit 3 acompaña al empaquetador (el protector que envuelve el código): según APKiD 3.1.0, está en 28 de las 40 apps con empaquetador frente a 8 de las 58 sin él. En las demás fuentes casi no coinciden. La «sección 11.1 · Qué dejan los protectores en el ZIP» lo detalla.
Los contenedores sí se generan en streaming, y las tres tiendas ponen el bit en todas sus entradas o casi. No es cosa de APKCombo, como se podría pensar. Lo que las distingue es otra cosa: si rellenan o no la cabecera local («sección 7.4 · El ZIP exterior de .apkm y .xapk»). Ejemplos:
pro.rudloff.lineageos_updater_shortcut2 (F-Droid): bit 3 y firma v1 dejarsigner.com.corp21cn.mail189185 (mercado chino): bit 3, firma v1 dejarsignery protector Ijiami.おサイフケータイ Webプラグイン(連携用)3.2.0 (Google Play, vía APKPure): bit 3 con firma v1 deapksigner.
Y ahí aparece la desviación interesante. Mira el Local File Header de la primera entrada del
.xapk de Sweet Selfie (Sweet Selfie: AI Camera Editor 5.7.1776). El nombre dice APKPure, pero
el ZIP está escrito como lo hace APKCombo:
00000000: 504b 0304 0a00 0808 0000 b561 1c5d a5f4 PK.........a.]..
00000010: 0ac1 9a5b 3f04 9a5b 3f04 1500 0000 636f ...[?..[?.....co
flags = 0x0808: bit 3 puesto (hay data descriptor) y bit 11 puesto (nombre en UTF-8).
Pero crc-32 = 0xC10AF4A5 y los dos tamaños = 0x043F5B9A no son cero, cuando la
especificación dice que deben serlo. Y el data descriptor está igualmente presente detrás
de los datos, con firma:
043f5bcd: 504b 0708 a5f4 0ac1 9a5b 3f04 9a5b 3f04 PK.......[?..[?.
El escritor puso el bit, escribió el descriptor y rellenó la cabecera. Es la primera entrada,
com.cam001.selfie.apk (stored); el descriptor empieza en 71.261.133. Es el único caso: APKPure y
APKMirror dejan la cabecera a cero, como pide la especificación. Por ejemplo, el .xapk de
«Штрафы ГИБДД: проверка с фото» 6.10 tiene flags 0x0008, la cabecera con CRC y tamaños a cero,
y el descriptor en 10.111.215.
¿Por qué importa? Un lector que ignore los tres campos del LFH funciona; uno que valide que
son cero falla sobre un fichero que el lector de la plataforma no rechazaría. Android no instala un
.xapk, pero libziparchive no exige ceros en el LFH con el bit 3 puesto: en ese caso no
compara esos tres campos con el Central Directory («sección 3 de
Qué rechaza cada lector · libziparchive: el ZIP»). Es el caso límite que
obliga a la lectura tolerante de la «sección 11 · Lectura tolerante frente a lectura estricta». Todos los descriptores leídos llevan la firma
PK\x07\x08.
7.4 El ZIP exterior de .apkm y .xapk
Cada tienda escribe el contenedor a su manera, y eso permite reconocer de dónde viene un fichero aunque el nombre engañe. Lee la tabla por columnas: cada columna es una tienda.
.apkm (APKMirror) |
.xapk (APKPure) |
.xapk (APKCombo) |
|
|---|---|---|---|
| Ficheros | 388 | 71 | 1 |
| Entradas con bit 3 | 9.228 de 9.618 | 561 de 561 | 20 de 20 |
| Cabecera local con el bit 3 | a cero | a cero | rellena |
| Entradas del ZIP exterior | 9.228 deflate y 390 stored (APKM_installer.url 388 e icon.png 2) |
556 stored y 5 deflate | todas stored |
| APK de dentro | deflate (7.288) | stored (430 de 433) y deflate (3) | stored (17) |
| Fechas | varias en 388 de 388 | a cero (1980-00-00) en 71 de 71 |
una sola |
| Otras marcas | APKM_installer.url |
comentario «ApkPure.com» en 296 de 561 entradas | — |
| Fichero mayor (bytes) | 2.278.208.136 | 2.346.527.360 | 165.104.652 |
En los 460 contenedores no hay zip64, ni entradas cifradas, ni comentario del EOCD, y la cabecera
local nunca difiere del Central Directory. No sabemos por qué cada tienda elige su método. Tres
ejemplos:
- El
.xapkde Sweet Selfie 5.7.1776 (APKCombo, aunque el nombre diga APKPure). - El
.xapkde «Штрафы ГИБДД: проверка с фото» 6.10 (APKPure). - El
.apkmdecom.google.android.keep5.26.411.03.97 (APKMirror): primera entradaMETA-INF/MANIFEST.MFconflags0x0808, la cabecera a cero y fecha 2026-10-19 13:46:14. Es la variante de Wear OS de Keep: sirve para el ZIP exterior, no como ejemplo de móvil.
8. Extra fields
Tanto el Local File Header como la entrada del Central Directory terminan en un campo de
longitud variable con la misma estructura: una secuencia de registros.
| Campo | Offset | Tamaño | Tipo | Significado |
|---|---|---|---|---|
header id |
0x00 | 2 | uint16_t |
Identificador del registro |
data size |
0x02 | 2 | uint16_t |
Longitud de los datos que siguen |
data |
0x04 | var | — | Contenido específico del header id |
Los registros se encadenan hasta agotar extra field length. Un lector que no reconozca un
header id salta 4 + data_size bytes y sigue: el mismo principio de «ignorar sin perder»
que gobierna los chunks de resources.arsc. El extra field del LFH y el del
Central Directory son campos distintos y no tienen por qué coincidir, y esa es la
propiedad que Android explota para alinear. En el muestrario casi siempre difieren («sección 11 · Lectura tolerante frente a lectura estricta»).
8.1 El extra field como relleno de alineación
zipalign no reordena nada ni toca los datos: cambia el tamaño del extra field del
Local File Header hasta que el offset de los datos cae donde debe. Añade al final del
extra field, detrás de los registros que ya tuviera, tantos ceros como falten para el
múltiplo siguiente (ZipFile::alignEntry y ZipEntry::addPadding): 1, 2 o 3 para alinear a 4
bytes, hasta 16.383 para alinear a 16 KiB. Esos ceros no son ningún registro: con menos de
cuatro no cabe ni una cabecera id+size, y con cuatro o más se leen como registros con
header id y data size a cero, seguidos, si la cuenta no es múltiplo de 4, de una cola de uno
a tres bytes.
Un parser de registros id+size tiene que tolerar las dos cosas, la cola corta y los
registros 0/0, que es lo que hace apksig en createExtraFieldToAlignData: lee registros
mientras quedan al menos cuatro bytes y descarta los 0/0, que su comentario atribuye a «the old
APK data alignment method (filling the extra field with 0x00 bytes)».
Los ceros de relleno son la regla: aparecen en la cabecera local de entre el 79 % y el 94 % de las
apps, según la fuente, casi siempre como extra de 1 a 3 bytes (la alineación a 4). Pero no todo
es relleno: hay registros de verdad, y la «sección 8.3 · Registros que aparecen de verdad» los cuenta.
Medido sobre org.fdroid.fdroid_2000052.apk, entrada
lib/arm64-v8a/libandroidx.graphics.path.so (stored, LFH en 8.204.916, nombre de 42
bytes): el Local File Header declara extra field length = 3.396 y la entrada del
Central Directory declara 0. Los 3.396 bytes son todos cero (lo comprobamos leyendo el
fichero), y el offset de los datos resulta 8.204.916 + 30 + 42 + 3.396 = 8.208.384 =
16.384 × 501: alineado exactamente a 16 KiB. Las otras tres ABI de la misma pieza caen en
16.384 × 502, 503 y 504.
Consecuencia de primer orden: zipinfo -v y cualquier herramienta que lea solo el
Central Directory informan de extra field length: 0 para esa entrada. Un parser que
copie entradas de un ZIP a otro leyendo únicamente el Central Directory destruye la
alineación sin dar ningún aviso.
zipalign decide la alineación por extensión de fichero, no por contenido: su
getAlignment() devuelve pageSize si el nombre acaba en .so y pageAlignSharedLibs está
activo, y defaultAlignment en cualquier otro caso. Y las entradas comprimidas no se
alinean nunca, porque no se mapean: alinear un stream deflate no sirve de nada.
Los datos lo confirman. Las entradas deflate caen en un múltiplo de 4 una de cada cuatro veces,
justo lo que daría el azar. Las stored sí se alinean, con poquísimas excepciones (ninguna en
Google Play). A 16 KiB la cosa cambia: alrededor del 5 % de las .so stored quedan fuera de un
múltiplo de 16.384 en F-Droid y Google Play, y la mitad en el mercado chino. Son recuentos de
entradas, no de apps; las entradas de una misma pieza no son independientes, y por eso no los
hemos tratado como proporciones de apps.
No todos los empaquetadores rellenan con ceros mudos. El del Android Gradle Plugin desde la 2.2
—dentro de builder en la 2.2 y como apkzlib desde la 2.3— hasta que la 3.6 lo cambió por
zipflinger en las compilaciones debug y la 4.0 en todas, cubre el hueco con un registro de
verdad: header id = 0xD935, la alineación en los dos primeros bytes de datos y ceros detrás
(makeExtraAlignmentBlock en la 2.2, ExtraField.AlignmentSegment después). Un parser que lea
APK construidos con esas versiones puede encontrar ese registro en el extra field del LFH, y
apksigner escribe uno igual cuando tiene que realinear una entrada al firmar.
Ese registro existe en el muestrario, pero es la minoría: el 9 % de las apps de F-Droid, el 1 % de las piezas de Google Play y, como excepción, el 43 % de las del mercado chino. Casi siempre declara 4 bytes de alineación; unas pocas entradas, 16.384 o 4.096.
¿Quién lo escribe? Con las versiones del Gradle Plugin de la 2.2 a la 4.1 encaja con la historia
del plugin: entre las piezas de F-Droid con el registro, 38 llevan Created-By 4.0.x y 34, 3.5.0.
Pero también aparece en apps hechas con versiones recientes (AGP 7, 8 y 9, según
app-metadata.properties). La pista más clara es quién firmó en v1: lo llevan 50 de 53 piezas
firmadas con SignApk, bastantes de jarsigner y apksigner, y ninguna de las 765 firmadas por
el propio Gradle Plugin. Eso es lo que se esperaría de una firma que realinea, pero es una
correlación: no hemos leído el código de esos plugins, y que haya 38 piezas con 4.0.x no encaja
con «desde la 4.0 zipflinger» (el Created-By es de la versión que escribió el MANIFEST.MF,
no de quien alineó; podría ser un re-firmado con apksigner). En estático no se puede cerrar. Un
ejemplo: la pieza base.apk de com.dreamappsstore.bouncegame (carpeta de adb de Google Play)
lleva 0xD935 y 4.096 en las .so.
8.2 El extra field zip64, 0x0001
| Campo | Offset | Tamaño | Tipo | Significado |
|---|---|---|---|---|
header id |
0x00 | 2 | uint16_t |
0x0001 |
data size |
0x02 | 2 | uint16_t |
Suma de los campos presentes |
Original Size |
0x04 | 8 | uint64_t |
Tamaño sin comprimir |
Compressed Size |
0x0C | 8 | uint64_t |
Tamaño comprimido |
Relative Header Offset |
0x14 | 8 | uint64_t |
Offset del Local File Header |
Disk Start Number |
0x1C | 4 | uint32_t |
Disco de inicio |
En la entrada del Central Directory solo están presentes los campos cuyo equivalente de
32 bits vale 0xFFFFFFFF, y en ese orden. data size dice cuántos hay. Leer los cuatro
siempre es un error clásico. En el Local File Header la regla es otra: APPNOTE 4.5.3 exige que
el registro lleve siempre los dos tamaños —«This entry in the Local header MUST include BOTH
original and compressed file size fields»—, y libziparchive lo convierte en una condición: si
uno de los dos tamaños del LFH vale 0xFFFFFFFF, el otro también tiene que valerlo, o rechaza
la entrada con zip64 on Android requires both compressed and uncompressed length to be UINT32_MAX.
8.3 Registros que aparecen de verdad
Los ceros de relleno no son lo único que hay en un extra field. En las cabeceras locales del
muestrario aparecen ocho identificadores de registro. Contamos piezas con algún registro de ese
identificador:
header id |
F-Droid | IzzyOnDroid | Google Play (más instaladas) | Google Play (sorteo) | Mercado chino | Qué es |
|---|---|---|---|---|---|---|
0xD935 |
435 | 200 | 105 | 8 | 43 | alineación del Gradle Plugin y de apksigner («sección 8.1 · El extra field como relleno de alineación») |
0x5455 |
391 | 17 | 7 | 1 | 31 | marcas de tiempo de Info-ZIP |
0xCAFE |
155 | 14 | 55 | 0 | 1 | marca de JAR |
0x7875 |
1 | 0 | 3 | 0 | 26 | propietario de Info-ZIP |
0x000A |
0 | 0 | 0 | 0 | 3 | NTFS |
0x7075 |
0 | 0 | 0 | 0 | 2 | nombre en Unicode |
0x0001 |
0 | 0 | 1 | 0 | 0 | zip64 («sección 8.2 · El extra field zip64, 0x0001») |
0x5555 |
0 | 0 | 1 | 0 | 0 | sin nombre confirmado |
El más común, con diferencia, es 0xD935. En conjunto, los registros son minoritarios salvo en el
mercado chino, donde los llevan 63 de cada 100 apps. Basta con que existan para que un lector
tenga que saltar los que no conoce y tolerar la cola corta de ceros. Hay incluso una pieza de
Google Play con un extra mal formado. Dos ejemplos:
com.sec.pcw2.2.161101 (Google Play, vía APKMirror): un registro0xCAFE.おサイフケータイ Webプラグイン(連携用)3.2.0 (Google Play, vía APKPure): 65 registros0x5455y uno0xD935.
El medidor junta los registros 0/0 con la cola de ceros: no sabemos cuántas entradas tienen el registro 0/0 por separado.
9. Métodos de compresión
De los métodos que define APPNOTE.TXT, en un APK solo aparecen dos. En el muestrario es así sin excepción, tanto en las piezas como en el ZIP exterior de los contenedores.
| Método | Valor | Descripción de la spec | Uso en Android |
|---|---|---|---|
stored |
0 |
«The file is stored (no compression)» | resources.arsc desde targetSdk 30; .so con extractNativeLibs=false; classes*.dex con minSdk ≥ 28 desde AGP 4.2; ficheros ya comprimidos (.png, .webp, .ogg) |
deflate |
8 |
«The file is Deflated» | Todo lo demás: classes*.dex con minSdk < 28, AndroidManifest.xml, res/*.xml, assets/, META-INF/ |
La columna «Uso en Android» es una regla de las herramientas, no de Android, y el muestrario la
sigue casi siempre. resources.arsc va sin comprimir prácticamente en todas las apps, incluso
en las de targetSdk anterior al 30, a las que no se les exige. Las imágenes y el sonido ya
comprimidos (.png, .ogg, .mp3, .webp) van stored en más del 99 % de los casos, salvo en
el mercado chino, donde los .png van stored en 63 de cada 100 apps. El manifiesto y los
res/*.xml van deflate casi siempre, y assets/ mezcla métodos. Los classes*.dex son el caso
interesante: dependen del minSdk, y los vemos en el párrafo siguiente.
stored no es solo «no comprimir»: es la condición necesaria para mapear en memoria la
entrada. Un fichero deflate hay que descomprimirlo a RAM; uno stored y alineado se mapea
directo desde el APK instalado, sin copia. Ese es el único motivo de la sección siguiente. Y no
es que los demás métodos no aparezcan: libziparchive no sabe extraerlos, y una entrada con
cualquier otro valor falla al leerla («Qué rechaza cada lector → §3 · libziparchive: el ZIP»).
DEX sin comprimir según minSdk. Con minSdk 28 o más y el Gradle Plugin de la 4.2 en
adelante (la versión sale de app-metadata.properties), casi todas las apps llevan los
classes*.dex de la raíz sin comprimir: el 99 % en F-Droid y el 89 % en Google Play. Con minSdk
menor que 28 son una rareza en F-Droid (2 %), pero no en Google Play: los llevan stored la mitad
de las apps más instaladas y tres de cada cuatro del sorteo. Esa regla no lo explica: lo escribe
otra herramienta, que no hemos comprobado. Que ART use el DEX sin
copiarlo es lo que dice la documentación de AOSP; no lo hemos medido. Dos contraejemplos, con
minSdk 28 o más y los DEX en deflate:
com.coloros.weather.service16.28.0 (Google Play, vía APKMirror; piezabase.apk):minSdk28 y Gradle Plugin 8.2.0.com.miui.calculator17.3.0 (Google Play, vía APKMirror):minSdk29 y Gradle Plugin 8.3.1.
9.1 Cómo cambia el ZIP según el marco
El marco (framework) con que se hizo la app decide qué entradas hay y cómo se guardan. Contamos apps con la huella del marco, sin las protegidas elegidas a propósito, y su método de compresión. En Google Play, las apps son las que tienen la huella en cualquier pieza.
| Marco | Qué se mide | Resultado |
|---|---|---|
| Flutter (509 apps de F-Droid, 148 de IzzyOnDroid, 33 de Google Play, 66 del sorteo, 17 del mercado chino) | libflutter.so con todas sus entradas stored |
F-Droid 297 de 509 (58 %), IzzyOnDroid 61 de 148, Google Play 21 de 33, sorteo 61 de 66 (92 %), mercado chino 0 de 16 |
| Flutter | assets/flutter_assets/ |
ninguna app con todo stored; con alguna entrada stored, F-Droid 356 de 509 (70 %) |
| Unity (110 apps de Google Play, 84 del sorteo, 13 del mercado chino) | assets/bin/Data/ con alguna entrada stored |
Google Play 105 de 110 (95 %), con todas solo 1 de 110; entradas stored: 18 % en Google Play y 0,3 % en el mercado chino |
| React Native (96, 14, 50, 37, 25) | index.android.bundle stored |
F-Droid 59 de 96 (62 %), IzzyOnDroid 9 de 14, Google Play 15 de 26, sorteo 26 de 37, mercado chino 0 de 2 |
| Xamarin / .NET (9 de IzzyOnDroid, 1 de Google Play, 1 del sorteo) | todo stored |
ninguna; con alguna stored, IzzyOnDroid 3 de 9 |
| Cordova (23, 7, 2, 8) | assets/www/ con alguna stored |
F-Droid 21 de 23; ninguna con todo stored |
| Capacitor (72, 25, 4, 8) | assets/public/ con alguna stored |
F-Droid 60 de 72; ninguna con todo stored |
Fíjate en dos filas. El motor de Flutter (libflutter.so) va sin comprimir en algo más de la
mitad de las apps Flutter de F-Droid, pero en casi todas las del sorteo de Google Play. Y en una
app de Unity casi siempre hay algo de assets/bin/Data/ sin comprimir, pero rara vez todo. Son
excepciones a la columna «Uso en Android» de la «sección 9 · Métodos de compresión». No hemos verificado qué hace
el motor con una libapp.so comprimida: solo contamos el método.
10. Reglas propias de Android
10.1 resources.arsc sin comprimir y alineado a 4 bytes
Desde targetSdkVersion 30. La formulación oficial:
«Apps that target Android 11 (API level 30) or higher can't be installed if they contain a compressed
resources.arscfile or if this file is not aligned on a 4-byte boundary. This file can't be memory-mapped by the system if either of these conditions is present. Resources tables that can't be memory-mapped must be read into a buffer in RAM, resulting in unnecessary memory pressure on the system and greatly-increased RAM usage on the device.»
El incumplimiento produce el error de instalación
INSTALL_PARSE_FAILED_RESOURCES_ARSC_COMPRESSED, el fallo de reempaquetado más frecuente de
las herramientas que reconstruyen el ZIP sin cuidado. Eso se apoya en la documentación y en el
código de AOSP; no lo hemos probado en un teléfono.
Todo lo que se instala la cumple. Todas las piezas con resources.arsc sacadas con adb de
un teléfono lo llevan sin comprimir y alineado a 4 bytes. Entre las apps con targetSdk 30 o más
del resto del muestrario, solo una no la cumple: dudeofx.eval 102 (F-Droid, targetSdk 36). Su
resources.arsc está stored, pero en un offset con resto 1 al dividir entre 4, y
zipalign -c 4 la suspende. Si Android la rechazaría con ese error, no lo hemos probado. Con
targetSdk menor que 30 sí hay unos pocos APK con resources.arsc en deflate o desalineado, y
no es un error.
En el muestrario, resources.arsc está stored tanto en com.termux_1022.apk (targetSdk 28)
como en org.fdroid.fdroid_2000052.apk (targetSdk 37), los dos de F-Droid. En Termux, el offset
de los datos es 113.977.743 + 30 + 14 + 1 = 113.977.788, múltiplo exacto de 4 (28.494.447 × 4):
la cabecera local lleva un solo byte de relleno para llegar ahí. En F-Droid,
10.320.370 + 30 + 14 + 2 = 10.320.416, resto 0. Se ve con zipinfo -v … resources.arsc (receta
13.2).
10.2 .so sin comprimir cuando extractNativeLibs=false
El atributo del manifiesto decide si el instalador copia las bibliotecas nativas al sistema de ficheros:
«This attribute indicates whether the package installer extracts native libraries from the APK to the file system. If set to
"false", your native libraries are stored uncompressed in the APK. Although your APK might be larger, your application loads faster because the libraries load directly from the APK at runtime.»
Desde AGP 3.6:
«When you build your app, the plugin now sets
extractNativeLibsto"false"by default. That is, your native libraries are page aligned and packaged uncompressed.»
Desde AGP 4.2 se configura por DSL con useLegacyPackaging en vez de escribirse en el
manifiesto. La documentación advierte además de que «the default value of extractNativeLibs
depends on minSdkVersion and the version of AGP you're using».
El umbral exacto lo da la referencia de la DSL de AGP, no la guía: JniLibsPackaging.useLegacyPackaging
—«If null, .so files will be uncompressed and page-aligned when minSdk >= 23»—.
Esa regla de la DSL habla de lo que hace el plugin al construir; el atributo del manifiesto es lo
que ve el instalador. En un sentido, los datos la cumplen sin excepción: ninguna app que declara
extractNativeLibs=false lleva una .so comprimida, porque Android no la instalaría. En el
otro sentido hay matices. La tabla cuenta apps con alguna .so en lib/<abi>/, según el
atributo de su pieza base o única y el método de sus .so:
Atributo y método de las .so |
F-Droid | IzzyOnDroid | Google Play (más instaladas) | Google Play (sorteo) | Mercado chino |
|---|---|---|---|---|---|
false, todas stored |
1.863 | 538 | 344 | 213 | 4 |
true, todas deflate |
577 | 212 | 226 | 96 | 52 |
true, alguna stored |
1 | 0 | 27 | 0 | 7 |
Sin atributo, todas deflate |
265 | 70 | 16 | 2 | 29 |
Sin atributo, alguna stored |
3 | 0 | 2 | 0 | 8 |
Total de apps con .so |
2.709 | 820 | 615 | 311 | 100 |
Lee la tabla por columnas. El minSdk marca la diferencia: con 23 o más, el 87 % de las apps de
F-Droid llevan todas las .so stored; por debajo, casi ninguna. Las que comprimen es porque
declaran extractNativeLibs=true o, en 18 apps de F-Droid y 1 de IzzyOnDroid, porque no declaran
nada pese a tener minSdk 23 o más. Esas 18 no cumplen la regla de la DSL tal como está escrita
(puede que usen una versión anterior del plugin o useLegacyPackaging=true). Sin atributo y con
minSdk menor que 23 (que Android toma como 1), las .so van casi siempre deflate. Y hay 27
apps de Google Play que declaran true con alguna .so stored, como la pieza base.apk de
com.google.android.apps.fitness 2026.09.24.00 (armeabi-v7a, vía APKMirror).
El contraste, con dos APK de F-Droid:
| APK | targetSdk |
extractNativeLibs |
.so en el ZIP |
|---|---|---|---|
com.termux_1022.apk |
28 | true |
Defl:N (deflate) |
org.fdroid.fdroid_2000052.apk |
37 | false |
Stored + alineado a 16 KiB |
com.termux_1022.apk tiene minSdk 24, el Gradle Plugin 4.2.2 y 12 .so (3 por ABI), ninguna
stored. org.fdroid.fdroid_2000052.apk tiene minSdk 24, el Gradle Plugin 9.2.1 y 4 .so, las 4
stored, en 16.384 × 501 a 504.
El detalle de lo que eso implica para el binario está en «Código nativo y ELF».
10.3 Alineación de entradas
zipalign es la herramienta oficial:
«
zipalignis a zip archive alignment tool that helps ensure that all uncompressed files in the archive are aligned relative to the start of the file. This lets the files be accessed directly viammap(2), removing the need to copy this data in RAM and reducing your app's memory usage.»
Dos alineaciones, con dos motivos distintos:
| Alineación | A qué se aplica | Motivo |
|---|---|---|
| 4 bytes | Toda entrada stored |
Acceso alineado a la palabra. Obligatorio para resources.arsc desde targetSdk 30 |
16 KiB (-P 16) |
Entradas .so stored |
Página de memoria de 16 KiB. Ver «Código nativo y ELF → §6 · Páginas de 16 KB» |
Las dos alineaciones se cumplen casi siempre. zipalign -c 4 lo pasa prácticamente todo el
mundo: fallan 7 piezas de F-Droid, 1 de IzzyOnDroid y 3 del mercado chino, y ninguna de Google
Play. Con -P 16 fallan algunas más, pero aun así pasan el 97 % o más de las piezas en todas las
fuentes salvo el mercado chino (81 de 100). Cuanto más alto el targetSdk, mejor: con 35 o más
pasa el 99,8 % de las piezas de F-Droid. Ojo con los splits de ABI de Google Play, que no son
una excepción menor: uno de cada once de los sacados con adb no cumple -P 16, mientras que
ninguna base ni ningún split de idioma falla. Cuatro ejemplos:
dudeofx.eval102 (F-Droid): falla-c 4.com.chessclock.android31 (F-Droid): falla-c 4.tk.hack5.treblecheck5001001 (F-Droid): pasa-c 4y falla-P 16.com.google.android.gm.lite2022.10.10 (Google Play, vía APKMirror; piezasplit_config.armeabi_v7a.apk): falla-P 16.
zipalign -c -P 16 pasa cuando no hay ninguna .so stored: no demuestra que el APK esté listo
para páginas de 16 KiB (ver «Código nativo y ELF»).
«If your APK contains shared libraries (
.sofiles), use-P 16to ensure that they're aligned to a 16KiB page boundary suitable formmap(2)in both 16KiB and 4KiB devices.»
Y el orden respecto a la firma, que es la fuente número uno de APK rotos: «If you use
apksigner, zipalign must be used before the APK file has been signed» — porque la
firma v2 y superiores cubren todos los bytes del fichero, y mover un byte después de firmar
la invalida. Ver «Alineación y zipalign».
10.4 Cuántas apps ya alinean a 16 KiB
Alinear las .so a 16 KiB está casi generalizado entre las apps recientes y mucho menos entre las
antiguas. «Cumplir 16 KiB» tiene aquí dos definiciones, y cada cifra dice cuál usa:
- Guía de Android: la
.soes un ELF conp_alignde 16.384 o más y, si se carga desde el APK, estástoreden un múltiplo de 16.384. - Cargador de Android 17: además, el ZIP está bien alineado, de modo que el sistema no entra en modo de compatibilidad. Es más estricto.
Contamos apps con alguna .so ELF en lib/arm64-v8a/:
| F-Droid | IzzyOnDroid | Google Play (más instaladas) | Google Play (sorteo) | Mercado chino | |
|---|---|---|---|---|---|
Apps con .so para arm64 |
2.689 | 790 | 546 | 310 | 98 |
| Cumplen según la guía de Android | 2.201 | 662 | 471 | 263 | 7 |
| Cumplen según el cargador de Android 17 | 2.096 | 635 | 406 | 240 | 1 |
Según la guía, son compatibles más del 80 % de las apps con .so para arm64 en F-Droid,
IzzyOnDroid y Google Play, y solo 7 de 98 en el mercado chino. Con el criterio más estricto del
cargador de Android 17, la cifra baja unos puntos. Lo que más pesa es el targetSdk: con 35 o más
cumplen el 94 % de las apps de F-Droid; por debajo, el 37 %.
Entre las apps que declaran extractNativeLibs=false, casi todas tienen todas sus .so en
múltiplo de 16.384. Las demás tienen alguna solo en 4.096 (según la documentación, Android 16 o
posterior la extrae con un aviso), y ninguna de F-Droid queda fuera de 4.096, que sería el caso
de rechazo. Un ejemplo de app reciente que no cumple: com.fast.free.unblock.secure.vpn 4.4.4
(Google Play, vía APKMirror), con targetSdk 35 o más y no compatible. La exigencia de Google Play
(fecha y umbral) no la hemos medido.
10.5 Las piezas tal como Google Play las instala
Las carpetas sacadas con adb de un teléfono son el formato exacto que Google Play entrega: un
base.apk y varios split_config.*, generados por bundletool y firmados por Play o por el
desarrollador. En el muestrario hay 365 apps así. Son APK muy regulares: casi todas las piezas
llevan la fecha de 1981, solo una lleva el bit 3, y todos los resources.arsc cumplen la regla de
la «sección 10.1 · resources.arsc sin comprimir y alineado a 4 bytes». Las bases se firmaron casi siempre con v2+v3, y Play App Signing firma tres de
cada cuatro. Y aun así, los splits de ABI no cumplen siempre: 25 de 282 fallan
zipalign -P 16. Un ejemplo: la pieza split_config.arm64_v8a.apk de
com.ronald.bright.pink.iconpack (carpeta de adb).
11. Lectura tolerante frente a lectura estricta
Un lector estricto valida todo lo validable y aborta ante la primera discrepancia: es lo
correcto para un verificador de seguridad. Un lector tolerante acepta lo que Android
acepta, registra lo que ha perdonado y sigue: es lo que necesita una herramienta de análisis,
porque un APK que no se puede abrir tampoco se puede analizar. libziparchive es estricto en
la coherencia entre LFH y Central Directory, y laxo en el contenido: no comprueba el CRC,
salta los extra field que no conoce y del bit 3 solo avisa. Sus comprobaciones de coherencia
dicen dónde divergen en la práctica las dos copias de los metadatos:
| Comprobación | Mensaje de error de AOSP |
|---|---|
| Longitud del nombre | "lfh name length did not match central directory" |
| Contenido del nombre | "lfh name did not match central directory" |
| Tamaños y CRC sin descriptor | "size/crc32 mismatch. expected {…}, was {…}" |
| Bit 3 de los flags | "gpb flag mismatch at bit 3". Solo aviso: no rechaza, y usa el bit del LFH |
Los dos tamaños zip64 del LFH |
"zip64 on Android requires both compressed and uncompressed length to be UINT32_MAX", si solo uno de los dos vale 0xFFFFFFFF («sección 8.2 · El extra field zip64, 0x0001») |
Lo que no comprueba es el CRC de los datos al extraerlos: kCrcChecksEnabled = false. La lista
completa de lo que rechaza, avisa o ignora, con el mensaje literal y la línea de zip_archive.cc
en android-17.0.0_r1, está en la «sección 3 de
Qué rechaza cada lector · libziparchive: el ZIP», y lo que deja pasar sin
decir nada, en su «sección 10 · Lo que pasa en silencio».
Discrepancias reales observadas en el muestrario, en orden de frecuencia:
extra field lengthdistinto entreLFHyCentral Directory. Es lo normal en los APK alineados, aunque no universal: pasa en casi todas las apps de F-Droid con alguna entradastoredy en el 85 % de las piezas de Google Play, que bajan porque sus splits de idioma no llevanextra. No ocurre en dos casos: cuando ninguna cabecera local llevaextra(casi siempre, splits de idioma) y cuando elCentral Directoryrepite elextrade la cabecera local (casi siempre, firmas deSignApk). Que elCentral Directorylleveextraes raro salvo en el mercado chino, donde pasa en la mitad de las piezas. Elextrade la cabecera local se deduce de los offsets (datos =LFH+ 30 + nombre +extra) y el delCentral Directory, del tamaño del índice menos 46 y el nombre de cada entrada; eso no se puede calcular en 25 piezas con huecos entre entradas. No es un error, es cómo funciona la alineación; un lector que asuma que coinciden calcula mal el offset de los datos. Los 3.396 bytes deorg.fdroid.fdroid_2000052.apkfrente a 0 son el caso típico («sección 8.1 · El extra field como relleno de alineación»). Ejemplos de piezas donde no hay discrepancia:fr.smarquis.sleeptimer16300 (F-Droid): las entradasstoredcaen alineadas sin relleno.com.samsung.android.spdclient6.1.01 (Google Play, vía APKMirror): elCentral Directoryrepite elextradelLFH(395 bytes en las dos); firma v1 deSignApk.com.google.android.apps.googleassistant0.1.884448652 (Google Play, vía APKMirror): elCentral Directoryrepite elextra(1.235 bytes en las dos).
- Firma del
data descriptorpresente aunque sea opcional. Todos los descriptores de los contenedores la llevan, aunque la especificación no lo obliga. - Bit 3 puesto con los tamaños del
LFHrellenos. Solo en el.xapkde APKCombo (el de Sweet Selfie 5.7.1776), con la primera entrada de la «sección 7.3 · Qué aparece de verdad en el muestrario» como ejemplo. La spec dice que deben ser cero.
La regla operativa, que no admite matices: el Central Directory es la fuente de verdad
sobre qué entradas existen, cómo se llaman, cuánto ocupan y dónde están. El
Local File Header solo aporta un dato que el Central Directory no tiene: su propio
extra field length, imprescindible para localizar el inicio de los datos. Todo lo demás que
diga el LFH es una copia, y cuando la copia contradice al índice, gana el índice. La
excepción es el bit 3: ahí libziparchive hace caso al LFH.
La regla se sostiene en el muestrario: ninguna pieza tiene nombres duplicados, ni nombres que no sean UTF-8, ni entradas que se solapen. Pero hay rarezas que un lector que recorra las cabeceras en orden pisaría:
- Bytes antes de la primera entrada. 208 piezas empiezan con bytes que el índice no nombra,
sobre todo de IzzyOnDroid (el 11 % de las suyas). Casi siempre son 132 bytes. Solo leímos la de
com.dsi.ant.service.socket4.18.00: sus 132 bytes son una cabecera local sin nombre (30 bytes más 102 de ceros deextra, con versión 0, flags 0, método 0, hora0x0821y fecha0x0221). Se lee conpython3 -I -c "import struct,sys;b=open(sys.argv[1],'rb').read(200);print(b[:4],struct.unpack('<HHHHHIIIHH',b[4:30]))" <pieza>. Eso no contradice a la «sección 12 · Nota histórica: Master Key y Janus»: aquello son bytes arbitrarios; esto es una cabecera local válida en el offset 0. De las otras 207 piezas solo sabemos que hay bytes antes de la primera entrada. En los 460 contenedores no hay ninguno. - Orden físico distinto del orden del índice. 124 piezas guardan los datos en otro orden, la mayoría de F-Droid.
- Huecos entre entradas. 25 piezas, con huecos de 84 a 63.482 bytes. Un ejemplo con un hueco
de 12.288 bytes y orden distinto del índice:
com.fast.free.unblock.secure.vpn4.4.4 (Google Play, vía APKMirror). - Nombres. La contrabarra y el «/» inicial de la «sección 4 · Local File Header» (
/publicsuffix/PublicSuffixDatabase.gzencom.planes.android39;assets/weathericon\api\day\113.pngensadLogic.HomeCentral20) y las colisiones por mayúsculas, que tienen dos de cada tres apps de F-Droid y son un problema real al descomprimir en macOS o Windows.
11.1 Qué dejan los protectores en el ZIP
Un protector (un empaquetador que envuelve o cifra el código) deja huellas en el ZIP aunque no se abra el DEX. Contamos apps del mercado chino (pieza base o única) con protector según la heurística del muestrario, que excluye a PairIP: 38 de 100, frente a 62 sin él. Las cinco apps protegidas que elegimos a propósito solo sirven de ejemplo.
| Huella en el ZIP (apps del mercado chino) | Con protector (38) | Sin protector (62) |
|---|---|---|
| Varias fechas | 38 | 43 |
| Bit 3 | 27 | 10 |
Alguna .so fuera de lib/ |
16 | 8 |
| Orden físico igual al del índice | 38 | 60 |
Firma v1 de apksigner |
32 | 51 |
Lee la tabla por filas: el bit 3 y las .so fuera de lib/ son más frecuentes con protector, y
todas las apps protegidas mezclan fechas. APKiD 3.1.0 da el mismo cuadro, y coincide con la
heurística en 93 de 98 apps. Son pistas, no pruebas: una app sin protector también puede
tenerlas. Los protectores se describen en
«Packers y protectores». Ejemplos:
com.tuniu.app.ui384 (protegida a propósito): Baidu; varias fechas y.sofuera delib/.com.qihoo.browser10010726 (protegida a propósito): Jiagu 360; bit 3 en 4.767 de 4.782 entradas.com.jzzs.ParentsHelper1006033 (mercado chino): Jiagu 360.com.corp21cn.mail189185 (mercado chino): Ijiami.
12. Nota histórica: Master Key y Janus
Contexto de diseño, no guía. Las dos vulnerabilidades explotaban propiedades estructurales del contenedor, y entender cuáles explica por qué el ecosistema quedó como quedó.
Master Key (bug 8219321, 2013). Android verificaba la firma con código Java y cargaba el
código con una implementación en C++. Ambas leían el mismo ZIP y discrepaban ante nombres
duplicados: el verificador, sobre un LinkedHashMap, se quedaba con la última entrada —
«only the last entry with a given name is considered for signature verification: all previous
duplicates are discarded» — y el cargador nativo, sobre una tabla hash con sondeo lineal, con
la primera — «earlier entries are used instead of later ones». Con dos entradas llamadas
classes.dex, se verificaba la legítima y se ejecutaba la maliciosa, con la firma intacta.
Lo explotado: el ZIP no prohíbe nombres duplicados en el Central Directory, y dos
implementaciones pueden resolver el duplicado de forma distinta. El arreglo fue rechazar el
archivo entero ante un nombre repetido.
Janus (CVE-2017-13156, 2017).
«An APK file is a ZIP archive which can contain arbitrary bytes at the start, before and between its ZIP entries. The JAR signature scheme only takes into account the ZIP entries, ignoring any extra bytes when computing or verifying the application's signature.»
Y por el otro lado, un DEX admite bytes arbitrarios al final. Un mismo fichero podía ser
a la vez un DEX válido y un APK válido: se anteponía un DEX malicioso al APK original, el
verificador v1 ignoraba el prefijo y validaba las entradas ZIP intactas, y el runtime cargaba
el DEX del principio. Lo explotado: la firma v1 cubre entradas, no bytes. La firma v2
lo cierra por construcción, porque cubre todos los bytes del fichero. Y el lector cerró la puerta
por su cuenta: desde la corrección del fallo 64211847, libziparchive exige que el fichero
empiece por un Local File Header y rechaza el resto con Entry at offset zero has invalid LFH signature, así que un APK con bytes antepuestos ni siquiera se abre como ZIP. ¿Y las 208
piezas del muestrario que empiezan con bytes que el índice no nombra? Solo leímos una, y lo que
hay delante es una cabecera local válida en el offset 0 («sección 11 · Lectura tolerante frente a lectura estricta»). De las otras 207 solo
sabemos que hay bytes.
Ambos casos dejan la misma lección: las propiedades laxas del ZIP no son bugs del formato, son el espacio donde dos implementaciones pueden discrepar, y la discrepancia es la vulnerabilidad.
13. Recetas
Herramientas usadas: unzip y zipinfo del sistema (UnZip 6.00), xxd, python3 3.12 y
zipalign de build-tools 37.0.0. Todas las salidas de esta sección las ejecutamos el 31 de
octubre de 2026 sobre el muestrario. Los dos APK de las recetas son com.termux_1022.apk y
org.fdroid.fdroid_2000052.apk, ambos de F-Droid. MUESTRAS debe apuntar a una carpeta con
copias de los dos. No ejecutes estos comandos contra APK de origen desconocido sin copiarlos antes:
los APK son datos no confiables, y estas recetas solo los leen.
13.1 Listado y método de compresión
unzip -l da nombres y tamaños; unzip -v añade el método en la columna Method.
MUESTRAS=~/muestras-apk
unzip -l $MUESTRAS/com.termux_1022.apk | head -6
unzip -v $MUESTRAS/org.fdroid.fdroid_2000052.apk \
| awk '$0 ~ /\.so$|resources.arsc/ {print $2, $8}' | sort -u | head -3
Archive: ~/muestras-apk/com.termux_1022.apk
Length Date Time Name
--------- ---------- ----- ----
55 01-01-1981 01:01 META-INF/com/android/build/gradle/app-metadata.properties
3203456 01-01-1981 01:01 classes.dex
876 01-01-1981 01:01 classes2.dex
Stored lib/arm64-v8a/libandroidx.graphics.path.so
Stored lib/armeabi-v7a/libandroidx.graphics.path.so
Stored lib/x86/libandroidx.graphics.path.so
En awk, print $2, $8 imprime el método y el nombre (las columnas 2 y 8 de unzip -v);
sort -u | head -3 deja las tres primeras .so, y resources.arsc queda fuera del head.
13.2 zipinfo -v: el EOCD y una entrada
zipinfo -v $MUESTRAS/com.termux_1022.apk | sed -n '8,9p;13,16p'
zipinfo -v $MUESTRAS/com.termux_1022.apk resources.arsc \
| grep -E "compression method|extended local header|length of extra|offset of local"
Actual end-cent-dir record offset: 114920904 (0000000006D98DC8h)
Expected end-cent-dir record offset: 114920904 (0000000006D98DC8h)
central directory contains 745 entries.
The central directory is 48584 (000000000000BDC8h) bytes long,
and its (expected) offset in bytes from the beginning of the zipfile
is 114872320 (0000000006D8D000h).
offset of local header from start of archive: 113977743
compression method: none (stored)
extended local header: no
length of extra field: 0 bytes
«Actual» y «Expected» coinciden; qué compara cada uno está en la tabla de la «sección 6.2 · Por qué el comentario complica la búsqueda». Si
difieren, hay algo entre el Central Directory y el EOCD que no debería estar, o bytes
antepuestos al fichero que desplazan todo: Info-ZIP avisa entonces de «extra bytes at beginning
or within zipfile» (process.c, líneas 159-161).
extended local header: no es como zipinfo llama al bit 3, y length of extra field es el
del Central Directory, no el del Local File Header — ver 13.4. Fíjate en que aquí vale 0, aunque
la cabecera local de resources.arsc lleva 1 byte («sección 10.1 · resources.arsc sin comprimir y alineado a 4 bytes»): zipinfo enseña el del
Central Directory.
13.3 Localizar el EOCD a mano
Sin comentario, el EOCD son los últimos 22 bytes exactos:
tail -c 22 $MUESTRAS/com.termux_1022.apk | xxd
00000000: 504b 0506 0000 0000 e902 e902 c8bd 0000 PK..............
00000010: 00d0 d806 0000 ......
Si empieza por 504b 0506, no hay comentario. Si no, hay que buscar hacia atrás en la
ventana entera. Volcarla con el xxd por defecto no sirve: la firma se parte entre dos
líneas de 16 bytes en cuanto el offset no es múltiplo de 16, que es justo lo que pasa aquí.
Hay que volcar hexadecimal plano en una sola línea.
tail -c 65557 $MUESTRAS/com.termux_1022.apk | xxd -p -c 65557 | tr -d '\n' \
| grep -bo '504b0506' | tail -1
python3 -I -c "print(114920926 - 65557 + 131070//2)"
131070:504b0506
114920904
grep -bo da el desplazamiento en caracteres hexadecimales: se divide entre dos y se
suma al inicio de la ventana. Una coincidencia en desplazamiento impar cae a caballo entre dos
bytes y no es una firma: se descarta y se toma la anterior. El resultado es el «Actual
end-cent-dir record offset» de 13.2.
Con el campo de 0x10 del EOCD —00 d0 d8 06 = 0x06D8D000 = 114.872.320— se salta a la
primera entrada del Central Directory:
xxd -s 114872320 -l 48 $MUESTRAS/com.termux_1022.apk
06d8d000: 504b 0102 0003 0000 0000 0800 2108 2102 PK..........!.!.
06d8d010: dca9 c923 3300 0000 3700 0000 3900 0000 ...#3...7...9...
06d8d020: 0000 0000 0000 0000 b681 0000 0000 4d45 ..............ME
version made by = 0x0300, byte alto 0x03 = Unix; crc-32 = 0x23C9A9DC,
compressed size = 51 y uncompressed size = 55, idénticos a los del Local File Header de
la «sección 4 · Local File Header»; external file attributes en 0x26 = 0x81B60000, cuyos 16 bits altos son el
modo Unix 0o100666; relative offset of local header en 0x2A = 0, porque es la primera
entrada; y desde 0x2E, el nombre, que empieza por ME.
13.4 Ver el relleno de alineación que zipinfo no enseña
xxd -s 8204916 -l 64 $MUESTRAS/org.fdroid.fdroid_2000052.apk
007d3274: 504b 0304 0000 0000 0000 2108 2102 a0ba PK........!.!...
007d3284: 3497 7027 0000 7027 0000 2a00 440d 6c69 4.p'..p'..*.D.li
007d3294: 622f 6172 6d36 342d 7638 612f 6c69 6261 b/arm64-v8a/liba
007d32a4: 6e64 726f 6964 782e 6772 6170 6869 6373 ndroidx.graphics
file name length = 2a 00 = 42; extra field length = 44 0d = 3.396, todos ceros. La
entrada equivalente del Central Directory declara extra field length: 0 bytes. El crc-32
(a0ba 3497) y el tamaño (7027 0000 = 10.096) son los de la misma biblioteca en otros APK;
cambian solo el relleno y los offsets.
13.5 Comprobar la alineación con zipalign
BT=~/Library/Android/sdk/build-tools/37.0.0
$BT/zipalign -c -P 16 -v 4 $MUESTRAS/org.fdroid.fdroid_2000052.apk | tail -5
10320416 resources.arsc (OK)
12408217 META-INF/CIARANG.SF (OK - compressed)
12448026 META-INF/CIARANG.RSA (OK - compressed)
12449137 META-INF/MANIFEST.MF (OK - compressed)
Verification successful
Los offsets que imprime son los de los datos, no los de los Local File Header. Las
entradas (OK - compressed) pasan por definición: no se alinean. Los nombres CIARANG.SF y
CIARANG.RSA son del firmante de F-Droid (el alias de su clave).
Atención al interpretar el resultado: com.termux_1022.apk, cuyas .so están
comprimidas, también da Verification successful con -P 16. La comprobación no dice «este
APK cumple la regla de 16 KiB», dice «las entradas que debían estar alineadas lo están».
13.6 Cómo repetir las medidas
Las cifras de este documento se calculan con un script de Python que lee el Central Directory y las
cabeceras locales sin ejecutar nada del APK:
MUESTRARIO_RAIZ=<carpeta del muestrario> \
python3 -I scripts/muestrario/cifras/zip_y_contenedores_2.py --salida cifras.json
Tarda unos 5 segundos y usa unos 0,6 GB. Con --volumen lee directamente del volumen lo que
ninguna pasada guarda. Los ejemplos del texto se citan por nombre de paquete y versión; para repetir las
recetas de arriba necesitas la misma pieza. Las medidas sueltas de las secciones «1», «3»,
«7.3», «8.1» y «10.1» se repiten con estos comandos, uno por cifra:
for f in <ruta1> <ruta2>; do unzip -tqq "$f" >/dev/null 2>&1; echo $?; done # sección 1: salida 0
python3 -I -c "print(4076962064/4294967296)" # sección 2: 0,949
xxd -l 32 <xapk de Sweet Selfie>; xxd -s 71261133 -l 16 <xapk de Sweet Selfie> # sección 7.3
python3 -I -c "import sys;b=open(sys.argv[1],'rb').read(8204916+30+42+3396);print(set(b[8204916+72:])=={0})" <org.fdroid.fdroid_2000052.apk> # sección 8.1: True
Las recetas 13.1 a 13.5 las ejecutamos el 31 de octubre de 2026.
Fuentes
- APPNOTE.TXT — .ZIP File Format Specification, versión 6.3.10 (1 de noviembre de 2022) — https://pkware.cachefly.net/webdocs/casestudies/APPNOTE.TXT
Consultado el 12 de agosto de 2026. De aquí salen íntegras las tablas de campos de las
secciones «4», «5», «6», «7.1» y «8.2», las firmas de la «sección 3 · Firmas mágicas», la descripción del bit 3 y los
valores de método de compresión de la «sección 9 · Métodos de compresión». Reconsultado el 18 de octubre de 2026,
todavía en la versión 6.3.10: de aquí salen también la codificación de los nombres del
apéndice D («sección 4 · Local File Header»), el
data descriptorsin firma de 4.3.9 («sección 7.1 · Qué es») y la regla de 4.5.3 sobre los dos tamaños del registro zip64 delLocal File Header(«sección 8.2 · El extra field zip64, 0x0001»). - AOSP —
system/libziparchive/zip_archive.cc— https://android.googlesource.com/platform/system/libziparchive/+/refs/tags/android-17.0.0_r1/zip_archive.cc Consultado el 25 de septiembre de 2026. De aquí salen el algoritmo de búsqueda delEOCDde la «sección 6.1 · El algoritmo de búsqueda», el comentario «Scan backward for the EOCD magic…» y los mensajes de error de la tabla de la «sección 11 · Lectura tolerante frente a lectura estricta». Reconsultado el 18 de octubre de 2026: la comprobación UTF-8 y sinNULde los nombres está en las líneas 617-621, y el comentario «always enforces that entry names are valid UTF-8», en las 976-979 («sección 4 · Local File Header»); con el bit 3 puesto, el CRC y los tamaños delLFHno se comparan con elCentral Directory(líneas 985-999, «sección 7.3 · Qué aparece de verdad en el muestrario»); y la condición de los dos tamaños zip64 delLFHestá en las líneas 925-934 («sección 8.2 · El extra field zip64, 0x0001»); y la búsqueda delZip64 EOCD locatoren cuanto uno de los campos delEOCD, la longitud del comentario incluida, vale el máximo está en las líneas 328-337, con el rechazo «Zip64 eocd locator signature not found» en la 233 («sección 6 · EOCD y cómo se localiza»). - AOSP —
system/libziparchive/zip_archive_common.h— https://android.googlesource.com/platform/system/libziparchive/+/refs/tags/android-17.0.0_r1/zip_archive_common.h Consultado el 25 de septiembre de 2026. De aquí salekMaxCommentLen = 65535de la «sección 6.1 · El algoritmo de búsqueda» y la confirmación de que AOSP modela las estructuras zip64 (Zip64EocdRecord,Zip64EocdLocator) que se documentan en la «sección 8.2 · El extra field zip64, 0x0001». - Behavior changes: Apps targeting Android 11 — Compressed resource files — https://developer.android.com/about/versions/11/behavior-changes-11
Consultado el 12 de agosto de 2026. De aquí sale citada la regla de
resources.arscsin comprimir y alineado a 4 bytes de la «sección 10.1 · resources.arsc sin comprimir y alineado a 4 bytes». <application>— android:extractNativeLibs — https://developer.android.com/guide/topics/manifest/application-element Consultado el 12 de agosto de 2026. De aquí sale la descripción del atributo de la «sección 10.2 · .so sin comprimir cuando extractNativeLibs=false» y la advertencia de que su valor por defecto depende deminSdkVersiony de la versión de AGP.- Android Gradle Plugin 3.6.0 release notes — Native libraries packaged uncompressed by default — https://developer.android.com/build/releases/past-releases/agp-3-6-0-release-notes
Consultado el 12 de agosto de 2026. De aquí sale que AGP fija
extractNativeLibsa"false"por defecto («sección 10.2 · .so sin comprimir cuando extractNativeLibs=false»). Reconsultado el 18 de octubre de 2026: de aquí sale también que la 3.6 empaqueta las compilaciones debug conzipflinger(«sección 8.1 · El extra field como relleno de alineación»). - Android Gradle Plugin 4.2.0 release notes — Use the DSL to package compressed native libraries — https://developer.android.com/build/releases/past-releases/agp-4-2-0-release-notes
Consultado el 12 de agosto de 2026. De aquí sale que
useLegacyPackagingsustituye al atributo del manifiesto («sección 10.2 · .so sin comprimir cuando extractNativeLibs=false»). - zipalign — Android Studio — https://developer.android.com/tools/zipalign
Consultado el 12 de agosto de 2026. De aquí salen las citas sobre
mmap(2), los flags-p,-Py-c, y la regla de orden respecto aapksignerde la «sección 10.3 · Alineación de entradas». - AOSP —
build/make/tools/zipalign/ZipAlign.cpp(android-17.0.0_r1) — https://android.googlesource.com/platform/build/+/refs/tags/android-17.0.0_r1/tools/zipalign/ZipAlign.cpp Consultado el 12 de agosto de 2026 en el espejo de GitHub y el 18 de octubre de 2026 en la etiquetaandroid-17.0.0_r1. De aquí sale la funcióngetAlignment()citada en la «sección 8.1 · El extra field como relleno de alineación» (líneas 39-51) y la confirmación de que las entradas comprimidas se copian sin alinear (líneas 73-81). - APK signature scheme v2 — Android Open Source Project — https://source.android.com/docs/security/features/apksigning/v2
Consultado el 12 de agosto de 2026. De aquí sale la descripción de las cuatro secciones
del APK y la posición del
APK Signing Blockde la «sección 2 · Layout global». - Exploit (& Fix) Android "Master Key" — Jay Freeman (saurik) — https://www.saurik.com/id/17 Consultado el 12 de agosto de 2026. De aquí salen las dos citas sobre el comportamiento divergente del verificador Java y del cargador C++ de la «sección 12 · Nota histórica: Master Key y Janus». Se usa esta fuente porque el bug 8219321 no tiene una descripción técnica equivalente en la documentación oficial de Android.
- Janus Vulnerability: Threats and Mitigation — Guardsquare — https://www.guardsquare.com/blog/new-android-vulnerability-allows-attackers-to-modify-apps-without-affecting-their-signatures-guardsquare Consultado el 12 de agosto de 2026. De aquí sale la cita sobre los bytes arbitrarios al inicio del ZIP y el alcance de la firma v1 de la «sección 12 · Nota histórica: Master Key y Janus». Es la fuente del descubridor de la vulnerabilidad.
- AOSP —
system/libziparchive/zip_archive.cc(android-17.0.0_r1) — https://android.googlesource.com/platform/system/libziparchive/+/refs/tags/android-17.0.0_r1/zip_archive.cc Es el mismo fichero que la fuente 2; esta entrada recoge lo que sale de él para las secciones «6.2», «7.2» y «11». Consultado el 25 de septiembre de 2026 enandroid-16.0.0_r1y el 18 de octubre de 2026 enandroid-17.0.0_r1, donde sigue igual. De aquí salen que elEOCDse toma de la primera firma desde el final y, si no cuadra, se devuelvekInvalidFile(líneas 299-326, «sección 6.2 · Por qué el comentario complica la búsqueda»), que «gpb flag mismatch at bit 3» es unALOGWsinreturny que manda el bit delLFH(líneas 966-983, secciones «7.2» y «11»), ykCrcChecksEnabled = false(línea 72, «sección 11 · Lectura tolerante frente a lectura estricta»). - AOSP —
core/java/android/util/apk/ApkSigningBlockUtils.javayZipUtils.java(android-17.0.0_r1) — https://android.googlesource.com/platform/frameworks/base/+/refs/tags/android-17.0.0_r1/core/java/android/util/apk/ApkSigningBlockUtils.javaApkSigningBlockUtils.javaes también el fichero de la fuente 16. Consultado el 25 de septiembre de 2026 enandroid-16.0.0_r1y el 18 de octubre de 2026 enandroid-17.0.0_r1, donde sigue igual. De aquí salen «ZIP64 APK not supported» (ApkSigningBlockUtils.java, línea 79) y la búsqueda del bloque hacia atrás desde elCentral Directory(findApkSigningBlock, desde la línea 730) («sección 2 · Layout global»), y la búsqueda delEOCDque continúa hasta que cuadra la longitud del comentario (ZipUtils.java, líneas 146-179, «sección 6.2 · Por qué el comentario complica la búsqueda»). - UnZip 6.0 — Info-ZIP,
process.c— «https://downloads.sourceforge.net/project/infozip/UnZip 6.x (latest)/UnZip 6.0/unzip60.tar.gz» Consultado el 18 de octubre de 2026, en elunzip60.tar.gzpublicado por Info-ZIP. De aquí salen que el «Expected end-cent-dir record offset» que imprimezipinfoesoffset_start_central_directory + size_central_directory(líneas 1564-1565), que su diferencia con el «Actual» da los avisos de bytes de más o de menos, entre ellos «extra bytes at beginning or within zipfile» (líneas 159-161 y 857-889), y que la firma delEOCDse toma de la primera coincidencia desde el final (rec_find, líneas 1118-1191). Del comentario comprueba un sentido, no la igualdad: con-vavisa de «The zipfile comment is truncated» si la longitud declarada se sale del fichero (líneas 217-218 y 1620-1625), y no mira lo que haya detrás (secciones «6.2» y «13.2»). - AOSP —
core/java/android/util/apk/ApkSigningBlockUtils.java(android-17.0.0_r1) — https://android.googlesource.com/platform/frameworks/base/+/refs/tags/android-17.0.0_r1/core/java/android/util/apk/ApkSigningBlockUtils.java Consultado el 18 de octubre de 2026. De aquí sale que la verificación de firma exige que elCentral Directoryacabe donde empieza elEOCD, con el mensaje «ZIP Central Directory is not immediately followed by End of Central Directory» (líneas 422-426, «sección 6.2 · Por qué el comentario complica la búsqueda»). - AOSP
tools/base—apkzliby el empaquetador del Android Gradle Plugin, etiquetasgradle_2.2.0,gradle_2.3.0,gradle_3.0.0,gradle_3.4.0ystudio-4.0.0— https://android.googlesource.com/platform/tools/base/+/refs/tags/gradle_3.0.0/apkzlib/src/main/java/com/android/apkzlib/zip/ExtraField.java Consultado el 18 de octubre de 2026. Engradle_2.2.0el mismo código vive todavía enbuild-system/builder/…/internal/packaging/zip/ZFile.java, conALIGNMENT_ZIP_EXTRA_DATA_FIELD_HEADER_ID = 0xd935(línea 226) ymakeExtraAlignmentBlock, que escribe identificador, tamaño, alineación y ceros (líneas 2316-2333), yApkCreatorFactories.javallama asetCoverEmptySpaceUsingExtraField(true)(línea 79) en la rama por defecto, porqueAndroidGradleOptions.javafijaDEFAULT_USE_OLD_PACKAGING = false(línea 44). Desdegradle_2.3.0salenALIGNMENT_ZIP_EXTRA_DATA_FIELD_HEADER_ID = 0xd935yAlignmentSegment, que escribe la alineación en dos bytes seguida de ceros (ExtraField.java, líneas 55 y 324-390), queZFilecubre los huecos con él (ZFile.java, línea 976) y queApkCreatorFactorieslo activa consetCoverEmptySpaceUsingExtraField(true)(línea 73 engradle_3.0.0; también engradle_2.3.0ygradle_3.4.0); y que enstudio-4.0.0el empaquetador eszipflinger(APK_FLINGER) siempre queandroid.useNewApkCreatoresté activo, como lo está por defecto (VariantScopeImpl.java, línea 1486, yBooleanOption.kt, línea 147) («sección 8.1 · El extra field como relleno de alineación»). Y de las mismas etiquetas sale que ninguno de los dos empaquetadores pone el bit 3 («sección 7.3 · Qué aparece de verdad en el muestrario»):GPFlags.makesolo añade el bit 11 (GPFlags.java, líneas 132-140, engradle_2.2.0ygradle_3.0.0),writeEntryrechaza una entrada condata descriptor(«Cannot write entries with a data descriptor»,ZFile.java, líneas 1101-1103 engradle_2.2.0y 1196-1198 engradle_3.0.0), engradle_3.0.0ZFilequita los descriptores al abrir para escribir (líneas 1476-1482), y enstudio-4.0.0zipflingerescribe 0 en los flags (LocalFileHeader.java, líneas 75 y 95;CentralDirectoryRecord.java, línea 64). - AOSP —
tools/apksig,ApkSigner.java(android-17.0.0_r1) — https://android.googlesource.com/platform/tools/apksig/+/refs/tags/android-17.0.0_r1/src/main/java/com/android/apksig/ApkSigner.java Consultado el 18 de octubre de 2026. De aquí sale queapksignertambién alinea con un registro0xd935cuando tiene que realinear una entrada (líneas 80, 791-796 y 903, «sección 8.1 · El extra field como relleno de alineación»), y quecreateExtraFieldToAlignDatalee registros mientras quedan al menos cuatro bytes y descarta los 0/0 (líneas 851-910, en particular 866 y 873-878, «sección 8.1 · El extra field como relleno de alineación»). - AOSP —
build/make/tools/zipalign/ZipFile.cppyZipEntry.cpp(android-17.0.0_r1) — https://android.googlesource.com/platform/build/+/refs/tags/android-17.0.0_r1/tools/zipalign/ZipEntry.cpp Consultado el 18 de octubre de 2026. De aquí sale quezipalignrellena conalignTo − (offset mod alignTo)ceros (ZipFile::alignEntry,ZipFile.cpp, líneas 501-519) queZipEntry::addPaddingañade detrás delextra fieldque ya hubiera (ZipEntry.cpp, líneas 198-227) («sección 8.1 · El extra field como relleno de alineación»). - Muestrario de octubre de 2026 — descrito en «El muestrario».
Medidas hechas con el muestrario descargado entre el 19 y el 27 de octubre de 2026, con
zipalign37.0.0 yunzip6.00 en los controles. Para repetirlas, la «sección 13.6 · Cómo repetir las medidas».