Especificaciones oficiales
1. Qué es y por qué existe
Esta página es el índice de lo normativo: lo que define el formato, no lo que lo describe.
Abre la parte normativa del bloque de referencias, después de
«El muestrario», y plantea la pregunta que ordena las dos siguientes:
¿quién tiene la autoridad sobre cada pieza de un APK?
La respuesta no es cómoda, así que va primero:
Algunas piezas clave del
APKno tienen especificación publicada. Es el caso deresources.arsc—la tabla que traduce cada número de recurso al texto, la imagen o el color que tocan según el idioma y la pantalla— y del XML binario (AXML), la forma compacta en que viajan elAndroidManifest.xmly los layouts. Google no publica ningún documento con sus estructuras (ResTable_package,ResStringPool…). En esos casos la autoridad es el código de AOSP (el código abierto de Android): lo que haceResourceTypes.cppal leer el fichero es, en la práctica, lo que el formato significa.
No es un descuido. Son formatos internos que nunca se pensaron como un contrato con terceros: Google puede cambiarlos en una release y le basta con actualizar a la vez su lector y su escritor. Que haya todo un ecosistema de herramientas apoyado en ellos es un accidente histórico, no un compromiso.
Si implementas algo, esto tiene dos consecuencias. Para DEX, el bytecode, la firma y el
ZIP hay spec, y hay que leerla: citar un blog para un dato que está en la especificación es
un error. Para los recursos no la hay, y buscarla es perder el tiempo: hay que ir al código,
que es de lo que trata «Código fuente de referencia».
Lo que no es normativo está en «Bibliografía y comunidad», y el bloque entero se presenta en la «sección 1 de El muestrario · Qué es y por qué existe».
2. La autoridad real de cada formato
La tabla resume todo el bloque. «Tipo de autoridad» distingue tres cosas muy distintas:
- Spec publicada: un documento con voluntad de contrato, versionado y fechado. Puedes citar un número de sección y esperar que signifique lo mismo dentro de dos años.
- Código fuente: no hay documento, la implementación es la definición. Se cita una ruta de fichero y la etiqueta de la versión (release) que se leyó.
- Documentación de producto: una página de
developer.android.comque describe el comportamiento de una herramienta. Es útil y oficial, pero no es una especificación: no enumera campos, cambia sin aviso y no se versiona.
| Formato / pieza | Qué es | Tipo de autoridad | Referencia |
|---|---|---|---|
Contenedor ZIP |
El fichero comprimido que es el APK |
Spec publicada (PKWARE) | APPNOTE.TXT 6.3.10 — «§10.1 · PKWARE APPNOTE.TXT — .ZIP File Format Specification» |
Firma v1 (JAR signing) |
La forma más antigua de firmar un APK: la firma de una lista de huellas (hashes) de los ficheros, guardada en META-INF/ |
Spec publicada (Oracle) | JAR File Specification — «§10.2 · JAR File Specification» |
DEX (estructura del fichero) |
El código de la app, en un fichero compacto | Spec publicada (Google) | Dalvik executable format — «§4.1 · Dalvik executable format» |
| Bytecode Dalvik (opcodes) | Las instrucciones que contiene ese código | Spec publicada (Google) | Dalvik bytecode — «§4.2 · Dalvik bytecode» |
| Formatos de instrucción | Cómo se colocan los bits dentro de cada instrucción | Spec publicada (Google) | Instruction formats — «§4.3 · Dalvik executable instruction formats» |
Restricciones de validez del DEX y del bytecode |
Las reglas que debe cumplir un DEX para ser válido |
Spec publicada (Google) | Constraints — «§4.5 · Constraints» |
| Firma v2 / v3 / v3.1 / v3.2 / v4 | Las formas modernas de firmar un APK («sección 5 · Google: la firma») |
Spec publicada (Google) | source.android.com — «§5 · Google: la firma» |
resources.arsc |
La tabla que traduce cada número de recurso al texto, la imagen o el color que tocan según el idioma y la pantalla | Código fuente (AOSP) | ResourceTypes.h — «doc 03 §3.1» |
AXML (XML binario) |
El XML en forma binaria compacta (el manifiesto y los layouts) | Código fuente (AOSP) | ResourceTypes.h — «doc 03 §3.1» |
AAB (App Bundle) |
El paquete que sube el autor a Google Play | Doc. de producto + .proto |
«§6.1 · Formato del Android App Bundle» y los .proto de bundletool |
APK Set (.apks) |
El conjunto de APK que se obtiene de un AAB |
Código fuente (bundletool) |
commands.proto — «§6.2 · Los .proto de bundletool» |
.apkm, .xapk y carpetas de adb |
Una app de Google Play partida en piezas (splits), repartida por tiendas de terceros o sacada de un móvil | Ninguna que hayamos encontrado | Los propios ficheros — «§6.4 · Formatos de distribución de terceros: .apkm, .xapk y carpetas de adb» |
Código nativo (ELF) |
Las bibliotecas .so, escritas en C o C++ |
Spec publicada (gABI + ARM) | «§12.4 · ELF» |
Snapshot de Dart (libapp.so), global-metadata.dat de IL2CPP |
El código y los datos de las apps hechas con Flutter o con Unity | Código fuente del marco | «§12.7 · Marcos multiplataforma y sus formatos» |
CIL (.NET) |
El lenguaje intermedio del código de Xamarin y .NET MAUI | Spec publicada (Ecma) | ECMA-335 — «§12.7 · Marcos multiplataforma y sus formatos» |
mapping.txt de R8 |
La lista de nombres originales y nombres cortos que deja R8 | Código fuente + doc. parcial | doc/retrace.md — «§7.2 · R8» |
baseline.prof |
La lista de métodos que ART compila al instalar | Código fuente (AOSP) | profile_compilation_info.cc |
.kotlin_module |
El fichero que Kotlin deja en META-INF/ con las funciones de nivel superior de un módulo |
Ninguna | Solo la API de lectura — «§14 · Lo que ninguna especificación cubre» |
odex / vdex / oat |
El código ya compilado que guarda el dispositivo | Código fuente (AOSP) | «§14 · Lo que ninguna especificación cubre» |
Las cinco filas en negrita no tienen más autoridad que el código de AOSP, o ninguna. Las
cuatro de AOSP (resources.arsc, AXML, baseline.prof y odex/vdex/oat) son la razón de
ser del «documento 03 · Código fuente de referencia»; la quinta, .kotlin_module, ni siquiera tiene eso. Tampoco hemos
encontrado especificación publicada para los formatos de tiendas de terceros («§6.4 · Formatos de distribución de terceros: .apkm, .xapk y carpetas de adb») ni para casi
ninguno de los formatos de código de los marcos multiplataforma («§12.7 · Marcos multiplataforma y sus formatos»).
2.1 Cómo se lee una ficha de aquí
Cada entrada de las «secciones 4 · Google: el código y el runtime» a 12 da título y URL exacta, qué contiene, cuándo consultarla y, si aplica, qué revisión se cita. Esto último importa: las specs cambian y las páginas de producto cambian sin dejar rastro. La tabla de «§13 · Qué revisión se está citando» recoge las revisiones de las especificaciones que tienen versión o fecha propia.
Las URL de este documento devolvieron HTTP 200 entre el 12 de agosto y el 31 de octubre de 2026; cada ficha o fuente dice qué día. Las que redirigen se señalan en su ficha. Las redirecciones que encontró esa comprobación en todo el sitio están en «doc 04 §8.4».
2.2 Qué consultar según lo que se quiere hacer
| Quiero… | Empezar por |
|---|---|
| Leer el manifiesto de un APK | «Código fuente de referencia → §3.1 · Los recursos — la autoridad sin especificación» |
Leer o escribir un DEX |
«Sección 4.1 · Dalvik executable format» (estructura), 4.2 (opcodes) y 4.3 (formatos de instrucción) |
| Verificar una firma v2 | «Sección 5.2 · APK signature scheme v2», más la RFC 5652 y la RFC 8017 («sección 11 · Estándares externos: la criptografía») |
Comprobar si una .so vale para páginas de 16 KB |
«Sección 8 · Google: la plataforma y el empaquetado» y «sección 12.4 · ELF» |
Abrir un .aab o un .apks |
Secciones «6.1» y «6.2» |
Abrir un .apkm, un .xapk o una carpeta de adb |
«Sección 6.4 · Formatos de distribución de terceros: .apkm, .xapk y carpetas de adb» |
Leer un mapping.txt |
«Sección 7.2 · R8» |
| Saber si algo no tiene especificación | «Sección 14 · Lo que ninguna especificación cubre» |
3. Advertencia sobre developer.android.com
Buena parte de lo que sigue vive ahí. Tres cosas que conviene saber antes de citarlo:
- No se versiona. Una página no dice a qué versión de Android o de AGP corresponde. Hay que mirar la marca «Last updated» del pie, y aun así describe el estado actual.
- Reorganiza rutas. Las notas de release de AGP pasaron de
/build/releases/past-releases/agp-N-N-0-…a/build/releases/agp-N-N-0-…;/build/shrink-codelleva ahora a/topic/performance/app-optimization/enable-app-optimization, y/training/articles/perf-jnia/ndk/guides/jni-tips. Las rutas viejas redirigen, hoy. - Discrimina por
User-Agent. A un cliente que se presenta como navegador lo manda aaccounts.google.com, y la página solo llega si guardas las cookies por el camino. El detalle, y cómo lo resuelve el comprobador de enlaces de esta documentación, está en «doc 04 §8.3».
source.android.com es más estable y más parecido a una especificación real. Cuando algo está
en los dos sitios, manda source.android.com.
4. Google: el código y el runtime
4.1 Dalvik executable format
https://source.android.com/docs/core/runtime/dex-format Revisión citada: «Last updated 2026-10-09 UTC», con el mismo texto que la de «2025-10-03» («§13 · Qué revisión se está citando»).
La especificación completa del fichero DEX, y una de las mejores que publica Google. Da
header_item campo a campo, los códigos TYPE_* del map_list, las tablas de índices
(string_ids, type_ids, proto_ids, field_ids, method_ids), class_data_item,
code_item, debug_info_item, encoded_value, el formato de anotaciones, los
access_flags y las codificaciones LEB128 y MUTF-8.
Cuándo: siempre que toques el contenedor DEX. Es la fuente primaria de
«Formato DEX» casi en su totalidad.
Hasta dónde llega: el grueso de la especificación describe las versiones del DEX hasta la 040, y la 041 tiene sección aparte. La gramática de
SimpleName (las reglas de los nombres) marca con «since DEX version 040» los caracteres que
esa versión añadió, y ninguna regla menciona la 041. La 041 permite meter varios DEX en un
solo fichero (el formato contenedor). Según las notas de versión, es experimental en Android 16
y no se debe usar en producción. La describe una sección propia, «Container format»: file_size
cambia de sentido, header_size pasa a valer 0x78, data_size y data_off dejan de usarse
(«Unused (v41 or later)») y aparecen container_size y header_offset. La constante
kDexContainerVersion = 41 está además en art/libdexfile/dex/dex_file.h.
Ojo con una fecha: la especificación dice que la 040 llegó con Android 10, pero Android 10
todavía no la acepta. El primero que carga un DEX 040 es el 11 (en el código, la lista
kDexMagicVersions la incluye desde android-11.0.0_r1). Lo miden la «sección 4 de
Formato DEX · magic y la tabla de versiones» y la «sección 6 de
Qué rechaza cada lector · El verificador de DEX».
En la práctica. En el muestrario no hay ningún DEX 040 ni 041, en ninguna fuente: solo de
las versiones 035, 037, 038 y 039. La 039 es la más alta en aproximadamente una de cada ocho apps de
F-Droid y en una de cada cuatro de las más instaladas de Google Play. Por eso lo que esta página
dice de la 040 y la 041 no lo hemos podido contrastar con APK reales.
4.2 Dalvik bytecode
https://source.android.com/docs/core/runtime/dalvik-bytecode Revisión citada: «Last updated 2026-10-09 UTC», con el mismo texto que la de «2025-01-07» («§13 · Qué revisión se está citando»).
La tabla completa de opcodes: para cada uno, su valor, su formato de instrucción, su mnemónico y
su semántica. Incluye los sufijos (/2addr, /lit8, /jumbo, /range) y los tres formatos de
payload (packed-switch, sparse-switch, fill-array-data).
Cuándo: al escribir un desensamblador o al leer smali sin saberlo de memoria. Es la fuente
principal de «Bytecode Dalvik».
4.3 Dalvik executable instruction formats
https://source.android.com/docs/core/runtime/instruction-formats Revisión citada: «Last updated 2026-10-09 UTC», con el mismo texto que la de «2024-08-26» («§13 · Qué revisión se está citando»).
El complemento imprescindible de la anterior: cómo se disponen los bits dentro de cada
instrucción. Define la nomenclatura (35c, 3rc, 21c, 22c, 31c…), las letras de tipo y el
layout exacto de cada formato.
Cuándo: cuando decodificas bytes de verdad. La tabla de opcodes dice qué hace
invoke-virtual; esta dice dónde están sus operandos.
4.4 Multidex
https://developer.android.com/build/multidex — documentación de producto. Un fichero DEX
puede referirse como mucho a 65.536 métodos (2¹⁶), porque las instrucciones de llamada
(invoke-*, formatos 35c y 3rc) guardan el número del método en 16 bits. Una app más grande
reparte su código en varios ficheros (classes.dex, classes2.dex…), y a eso se llama
multidex. Android lo admite de serie desde la API 21; antes hacía falta la biblioteca
androidx.multidex, para minSdkVersion ≤ 20. El porqué del índice de 16 bits (el campo
meth@ de los formatos 35c y 3rc) está en «§4.3 · Dalvik executable instruction formats», no aquí.
En la práctica. En Google Play lo normal es llevar más de un classes*.dex en la raíz de la
pieza base o única: 93 de cada 100 apps entre las más instaladas y casi 8 de cada 10 en el
sorteo. En F-Droid e IzzyOnDroid, una de cada tres. Pocas de esas apps necesitan la biblioteca,
porque pocas admiten un Android anterior al 5.0 (minSdkVersion 20 o menos): unas 4 de cada
100 de las que usan varios DEX en F-Droid y en torno a 1 de cada 100 en las más instaladas de
Google Play. No hemos buscado si esas apps incluyen androidx.multidex.
4.5 Constraints
https://source.android.com/docs/core/runtime/constraints Revisión citada: «Last updated 2026-10-09 UTC».
Las reglas que tiene que cumplir un .dex para que Android lo dé por válido, en tres tablas
numeradas:
- 20 sobre el fichero en conjunto (
G1–G20:magic,checksum,signature, tamaños y offsets de la cabecera,map_list, tablas de índices); - 25 que se comprueban mirando cada instrucción por separado (
A1–A25, sin análisis de flujo); - 22 que exigen seguir el recorrido del programa (
B1–B22; por ejemplo, qué tipo tiene cada registro en cada punto).
La página no nombra ningún verificador (la parte de ART que comprueba estas reglas al cargar el
código); solo dice que «a runtime is required to support only valid .dex files». Varias reglas
dependen de la versión: G4, G5 y G15 separan la 040 o anterior de la 041 en adelante, G7
añade una regla propia de la 041, y A24 y A25 endurecen invoke-super e invoke-static en
los DEX anteriores a la 037.
Cuándo: es la contrapartida normativa de lo que comprueban los verificadores de ART. Lo que hace el código con cada fallo —rechazar, avisar o dejar pasar— está en las secciones «6» y «7» de «Qué rechaza cada lector» y en la «sección 10 de Bytecode Dalvik · La verificación de bytecode de ART».
4.6 Banderas de aconfig
https://source.android.com/docs/setup/build/feature-flagging/declare-flag https://source.android.com/docs/setup/build/feature-flagging/set-values Revisiones citadas: «Last updated 2026-06-17 UTC» y «Last updated 2026-08-12 UTC».
No describen ningún formato, pero cambian cómo se lee el código de AOSP. Parte del
comportamiento de la plataforma depende de banderas que se declaran en ficheros .aconfig y cuyo
valor fija cada compilación. En Java, una bandera del paquete foo.bar se consulta en la clase
generada foo.bar.Flags. Su estado (ENABLED o DISABLED, con permiso READ_ONLY o
READ_WRITE) lo dan los ficheros de valores de una release configuration, «a directory that
contains all of the flag values files for a specific build of Android». Por defecto, una bandera
es READ_WRITE y vale DISABLED.
El caso que toca a este sitio es el targetSdkVersion mínimo instalable. En android-17.0.0_r1,
PackageManagerService.java lo define como Flags.minTargetSdk24() ? Build.VERSION_CODES.N : Build.VERSION_CODES.M (líneas 576-577): 24 con la bandera, 23 sin ella. La bandera,
min_target_sdk_24, se declara en core/java/android/content/pm/flags.aconfig con
is_fixed_read_only: true. En el repositorio build/release de la misma etiqueta, las
configuraciones ap4a y bp1a le dan ENABLED y READ_ONLY; las posteriores de la cadena de
la que hereda cp1a (bp2a, bp3a, bp4a y la propia cp1a) no tienen fichero de valores
propio para ella. Lo que hace el instalador con ese mínimo está en la «sección 5 de
Qué rechaza cada lector · El instalador».
Cuándo: siempre que una regla de AOSP aparezca envuelta en Flags.…(). Leer la línea de
código no basta: hace falta el valor de la bandera en la compilación de la que hablas.
5. Google: la firma
Es el bloque mejor especificado de todo el APK, y con diferencia. Las cuatro páginas de
source.android.com son concretas, completas y estables.
5.1 Application signing (panorámica)
https://source.android.com/docs/security/features/apksigning
En qué versión de Android se introdujo cada esquema, cómo conviven y por qué se recomienda firmar con todos los que admita el rango de SDK. Es la puerta de entrada al bloque.
5.2 APK signature scheme v2
https://source.android.com/docs/security/features/apksigning/v2
La pieza normativa central de la firma moderna. Define en qué cuatro zonas se divide el APK
para firmarlo (las entradas del ZIP, el APK Signing Block, el directorio central y el final
del ZIP) y dónde va el bloque de firma, que se reconoce por la cadena mágica
APK Sig Block 42. También define cómo se calcula el resumen. El contenido se trocea en bloques
de 1 MiB; se calcula el hash de cada uno con el byte 0xa5 y su longitud por delante, y luego el
hash de todos esos hashes con el byte 0x5a y su número por delante. Y da la tabla de
identificadores de algoritmo de firma.
Cuándo: antes de escribir una sola línea de un verificador. Fuente principal de «APK Signing Block».
5.3 APK signature scheme v3 y v3.1
https://source.android.com/docs/security/features/apksigning/v3 https://source.android.com/docs/security/features/apksigning/v3-1
v3 permite cambiar la clave con la que se firma una app sin romper sus actualizaciones (la
rotación de claves). Guarda una cadena de claves, el proof-of-rotation (0x3ba06f8c), que
prueba que cada clave nueva la autorizó la anterior. Los campos minSDK y maxSDK dicen a qué
versiones de Android va dirigido cada firmante. v3.1 pone la clave nueva en un bloque aparte que
solo leen Android 13 y posteriores; los dispositivos anteriores siguen viendo la clave original
en el bloque v3. Por eso hay APK con dos bloques que parecen repetidos.
Cuándo: al implementar lineage (la cadena de claves) o al explicar por qué un APK trae
dos bloques que parecen redundantes.
En la práctica (rotación). Se ve sobre todo en Google Play. Entre las apps con bloque v3,
llevan un bloque v3.1 en torno al 11 % de las más instaladas y el 1 % del sorteo; en F-Droid e
IzzyOnDroid, ninguna. El linaje (proof-of-rotation) dentro de v3 sí aparece en el mercado
chino: 12 de las 37 apps con v3, frente a 15 de 593 en las más instaladas de Google Play. Un
ejemplo de bloque v3.1 es el .apk suelto de APKMirror de Maps Go (com.google.android.apps.mapslite
165.0).
Su límite: no cubre v3.2, la firma híbrida de Android 17 (lleva dos firmas: una clásica, RSA,
y otra poscuántica, ML-DSA), que tiene página propia:
https://source.android.com/docs/security/features/apksigning/v3-2
(«Esquemas de firma v1, v2, v3, v3.1 y v3.2, §7»). Su código está en la etiqueta
android-17.0.0_r1 de apksig y no en la rama main, como explica la «sección 2.3 de
Código fuente de referencia · La regla: fijar una etiqueta, no leer main».
En la práctica (v3.2). Ya circula, aunque poco: 9 de las 369 apps del sorteo de Google Play,
con 34 piezas en total, todas de carpetas de adb. No la lleva ninguna de las más instaladas, ni
de F-Droid, IzzyOnDroid, el mercado chino o las webs de autores, y no sabemos por qué solo
aparece en el sorteo. Cada bloque v3.2 trae dos firmantes, uno RSA y otro ML-DSA-65 (0x0501):
34 firmantes ML-DSA en 34 bloques. Ojo con la versión de Java: apksigner de las build-tools
37.0.0 verifica las 34 piezas con Java 25, pero con Java 21 no lee ML-DSA. Dos ejemplos, con la
pieza dentro de una carpeta de adb: com.phasora (base.apk, con v2 y v3.2, esta con dos
firmantes) y com.astropeak.congklak (split_config.xxhdpi.apk, un split de una app con v3.2
que también la lleva).
5.4 APK signature scheme v4
https://source.android.com/docs/security/features/apksigning/v4
La firma v4 sirve para la instalación incremental (adb install --incremental), en la que la app
arranca antes de haberse copiado entera. Va en un fichero aparte, el .idsig, con un árbol de
Merkle: un árbol de hashes que permite comprobar cada bloque según llega. La página da el formato
del .idsig, el tamaño de bloque, la sal y la exigencia de que v4 vaya siempre acompañada de una
firma v2 o v3, nunca sola. Es corta y precisa.
Cuándo: al tratar con instalación incremental. Se lee junto con la documentación de fs-verity del kernel («§12.5 · fs-verity»), que es donde está la construcción real del árbol.
En la práctica. El muestrario no contiene ningún .idsig, ni dentro ni junto a ninguno de los
ficheros. De v4 solo podemos hablar por la especificación.
5.5 Lo que viaja en el bloque de firma además de las firmas
El APK Signing Block no solo guarda firmas. Android ignora los pares con un identificador que
no conoce, así que las tiendas y las herramientas de compilación aprovechan el bloque para dejar
sus propios datos. Ninguno de estos pares tiene especificación publicada: el sello se explica en
el código de apksig, y los datos de dependencias, en la opción dependenciesInfo del plugin
de Gradle de Android (AGP). Las cifras son de las apps que llevan bloque de firma, es decir, una
firma v2 o posterior en su pieza base o única.
- Sello de origen (source stamp,
0x6dff800d). Es una firma de la tienda que distribuye la app. Lo llevan casi 8 de cada 10 apps de las más instaladas de Google Play y casi 9 de cada 10 del sorteo. En F-Droid, ninguna; en IzzyOnDroid, 6 de 1.386; en el mercado chino, ninguna. - Frosting (
0x2146444e). Lo añade Google Play a la pieza base: en torno a 3 de cada 4 apps de las más instaladas y casi todas las del sorteo (368 de 369). Los splits (losAPKparciales de una app de Google Play, con las bibliotecas de una arquitectura, las imágenes de una densidad de pantalla o los textos de un idioma) llevan sello y no frosting: sello en casi todos los de las dos listas, frosting en ninguno. - Datos de dependencias (
0x504b4453). Los añade el plugin de Gradle, cifrados con una clave de Google, y no son exclusivos de Google Play: los llevan en torno al 2 % de las apps de F-Droid y el 30 % de las de IzzyOnDroid, frente al 7 % de las más instaladas de Google Play y el 10 % del sorteo.
Más detalle, con la tabla de identificadores, en «APK Signing Block». Ejemplos:
TickTock-TikTok+Live+Wallpaper36.0 (APKPure,.apksuelto): v2, v3, sello y relleno.- Calculator 9.3 (
com.google.android.calculator,.apkmde APKMirror),base.apk: frosting con la lista de 7 splits. moe.henry_zhr.force_dark(IzzyOnDroid): v2, datos de dependencias (206 B) y relleno.com.tortillum.signalid(IzzyOnDroid): el únicoAPKfuera de Google Play con frosting.
6. Google: la distribución
6.1 Formato del Android App Bundle
https://developer.android.com/guide/app-bundle/app-bundle-format
La estructura interna del .aab: BUNDLE-METADATA/, root/, la separación de manifest/ y
dex/, y qué va en cada módulo.
Cuándo: al abrir un .aab por primera vez. Ojo: es documentación de producto, no
especificación. El contrato real de los ficheros .pb está en los .proto, no aquí.
6.2 Los .proto de bundletool
https://raw.githubusercontent.com/google/bundletool/1.18.3/src/main/proto/commands.proto
https://raw.githubusercontent.com/google/bundletool/1.18.3/src/main/proto/config.proto
https://raw.githubusercontent.com/google/bundletool/1.18.3/src/main/proto/targeting.proto
Etiqueta citada: 1.18.3, la última publicada (15 de diciembre de 2025, según la API de
GitHub el 18 de octubre de 2026).
Un APK Set (.apks) es un ZIP con los APK parciales que bundletool genera a partir de un
.aab y un índice, toc.pb, que dice cuáles le tocan a cada dispositivo.
Esta es la autoridad real sobre el APK Set. commands.proto define BuildApksResult, que
es exactamente lo que contiene un toc.pb, con la jerarquía Variant → ApkSet →
ApkDescription. config.proto define BundleConfig.
Cuándo: siempre que haya que interpretar un toc.pb o un BundleConfig.pb. Un fichero
.proto es una especificación de las buenas: es ejecutable y no puede desincronizarse de la
implementación.
6.3 Resources.proto de aapt2
La versión en protobuf de la tabla de recursos, que es lo que lleva un .aab en lugar de
resources.arsc. Define la jerarquía ResourceTable → Package → Type → Entry →
ConfigValue.
Cuándo: al comparar el mundo .aab con el mundo .apk. Es, además, lo más parecido a una
especificación que publica Google del modelo de datos de recursos, aunque sea del formato
protobuf y no del binario.
6.4 Formatos de distribución de terceros: .apkm, .xapk y carpetas de adb
Muchas apps de Google Play se instalan con varios APK a la vez: la base y los splits (piezas
con las bibliotecas de una arquitectura, las imágenes de una densidad de pantalla o los textos de
un idioma). Las tiendas de terceros reparten ese conjunto en un único fichero. Ninguno de estos
formatos tiene especificación publicada que hayamos encontrado: lo que sabemos sale de abrir los
ficheros. La composición del muestrario está en «El muestrario»; aquí van
solo las cifras que describen estos formatos.
.apkm(APKMirror). Es unZIPcon uninfo.json(versión, arquitecturas, densidades, idiomas,min_api), unicon.png, unAPKM_installer.urly losAPK, y lo firma APKMirror (META-INF/APKMIRRO.RSA). Los 388 del muestrario siguen esa estructura, con 7.288 piezas. Un.apkmtrae de 1 a 125APK(mediana 12)..xapk(APKPure y APKCombo). Es unZIPcon unmanifest.json(package_name,version_code,min_sdk_version,permissions,split_apks…) y losAPK, sin firma exterior. Los 72 del muestrario (71 de APKPure y 1 de APKCombo) siguen esa estructura, con 450 piezas; traen de 2 a 22APK(mediana 3).- Carpeta de
adb pull. No es un fichero: son losAPKque el teléfono tiene instalados (base.apky los splits que ese teléfono necesita). Tenemos 365 carpetas con 1.225APK. Los splits de arquitectura son todosarm64_v8a(en unas tres de cada cuatro carpetas) y los de densidad, todosxxhdpi(en dos de cada tres): son los del móvil de origen.
Los nombres de las piezas siguen la convención de bundletool (split_config.<x>.apk), salvo
los .xapk, que usan config.<x>.apk y el nombre del paquete: en los .apkm, 388
base.apk, 6.394 split_config.<x>.apk y 506 split_<módulo>.apk; en las carpetas, 365, 830
y 30; en los .xapk, 72 <paquete>.apk, 367 config.<x>.apk y 11 con otro nombre. En el
muestrario no hay ningún .aab, ningún .apks, ningún toc.pb ni ningún ZIP de SAI.
Un asset pack es un split sin código que lleva los datos grandes de un juego. Lo tiene alguna
pieza del 8 % de las apps más instaladas de Google Play y del 5 % del sorteo; en F-Droid,
IzzyOnDroid y el mercado chino, de ninguna. Los .obb (datos que se descargan aparte) casi no
aparecen: 2 de los 388 .apkm y ninguno de los .xapk ni de las carpetas.
Ejemplos:
- El
.apkmmás pequeño:com.callapp.contacts2.150W (1.003.422 B). - El
.xapkmás pequeño: una app rusa de multas de tráfico de APKPure, versión 6.10 (12.735.503 B). - Un
.apkmcon un.obbdentro: Plants vs. Zombies 2 (com.ea.game.pvz2_row) 13.5.1. - Un asset pack dentro de un
.xapk:AssetPackMain.apkde Call of Duty Mobile 1.0.57 (APKPure). - Una carpeta de
adbcon base, splits y asset pack:com.pixelverse.indian.wedding.dressup.makeover(base.apk).
7. Google: la cadena de compilación
7.1 Documentación de producto de las herramientas
Ninguna de estas páginas es una especificación —no enumeran campos ni se versionan—, pero son la única fuente oficial de la sintaxis de cada herramienta.
| Herramienta | URL | Qué aporta |
|---|---|---|
aapt2 |
https://developer.android.com/tools/aapt2 |
Las fases compile y link y los ficheros .flat. Para aapt2 esto es todo lo que hay: lo que escribe en resources.arsc solo está en TableFlattener.cpp |
bundletool |
https://developer.android.com/tools/bundletool |
build-apks, extract-apks, install-apks, get-device-spec, y la definición del APK Set |
d8 |
https://developer.android.com/tools/d8 |
El compilador de .class a DEX: --release, --min-api, --lib |
apksigner |
https://developer.android.com/tools/apksigner |
La advertencia de que alinear va antes de firmar |
zipalign |
https://developer.android.com/tools/zipalign |
La justificación por mmap(2) y la regla de -P 16 |
retrace |
https://developer.android.com/tools/retrace |
Sintaxis y opciones |
apkanalyzer |
https://developer.android.com/tools/apkanalyzer |
Antes en /studio/command-line/apkanalyzer, que redirige |
En la práctica (zipalign). Una .so guardada sin comprimir (stored) tiene que empezar en
una posición que el sistema pueda mapear en memoria sin copiarla. Entre las piezas con alguna
.so stored, casi todas cumplen la regla de 16 KB (todas sus .so stored empiezan en un
múltiplo de 16.384): 96 de cada 100 en F-Droid y 95 de cada 100 en las más instaladas de Google
Play. Con targetSdkVersion 35 o más son casi todas (1.682 de 1.687 en F-Droid). Una minoría
tiene alguna .so alineada solo a 4 KB (67 de 1.867 en F-Droid), y 3 piezas de F-Droid ni
siquiera a 4 KB. La unidad es la pieza.
7.2 R8
https://developer.android.com/topic/performance/app-optimization/enable-app-optimization
(la ruta antigua https://developer.android.com/build/shrink-code redirige aquí)
https://r8.googlesource.com/r8/+/refs/tags/9.2.4-dev/compatibility-faq.md
https://r8.googlesource.com/r8/+/refs/tags/9.2.4-dev/doc/retrace.md
Etiqueta citada: 9.2.4-dev, la del R8 de las build-tools 37.0.0 (commit 084a891).
mapping.txt es el fichero que deja R8 al ofuscar: dice qué nombre original corresponde a cada
nombre corto (a, b, c…) y permite traducir de vuelta las trazas de error.
La primera es la documentación de producto: reducción de código (shrinking), optimización y
ofuscación, y el estado del full mode. Las otras dos viven en el repositorio de R8 y son mucho
más útiles. compatibility-faq.md enumera las diferencias del full mode frente a ProGuard, y
doc/retrace.md es lo más parecido a una especificación del formato mapping.txt que
existe: versionado del formato, rango catch-all 0:65535 y semántica de sourceFile,
synthesized, rewriteFrame, outline y residualsignature. El contexto de R8 está en
«R8 y ProGuard».
Cuándo: retrace.md es obligatorio para cualquiera que analice un mapping.txt. Aun así no
cubre la gramática entera; el resto sale de ProguardMapReader.java
(«doc 03 §4.9»).
8. Google: la plataforma y el empaquetado
| Página | URL | Qué fija |
|---|---|---|
| Support 16 KB page sizes | https://developer.android.com/guide/practices/page-sizes |
La alineación de los segmentos LOAD del ELF a 16 KB, la fecha del requisito y el umbral de targetSdkVersion. Una .so cumple la regla si todos sus segmentos LOAD tienen p_align de 16.384 o más |
<application> |
https://developer.android.com/guide/topics/manifest/application-element |
extractNativeLibs y su valor por defecto dependiente de minSdkVersion y de AGP |
| Android ABIs (NDK) | https://developer.android.com/ndk/guides/abis |
Las cuatro ABIs vigentes y la retirada de armeabi, mips y mips64 en NDK r17 |
| Behavior changes: Android 11 | https://developer.android.com/about/versions/11/behavior-changes-11 |
resources.arsc sin comprimir y alineado a 4 bytes; obligación de firma v2+ desde targetSdkVersion 30 |
| App resources overview | https://developer.android.com/guide/topics/resources/providing-resources |
assets/ frente a res/raw/ y la ausencia de resource ID |
| Baseline Profiles | https://developer.android.com/topic/performance/baselineprofiles/overview |
La ruta assets/dexopt/baseline.prof y la compilación AOT en instalación |
| Include native symbols | https://developer.android.com/build/include-native-symbols |
El stripping por defecto y los niveles NONE/SYMBOL_TABLE/FULL |
| Configure ART | https://source.android.com/docs/core/runtime/configure |
dex2oat y el contenido de .vdex, .odex y .art |
| Manifest overview | https://developer.android.com/guide/topics/manifest/manifest-intro |
El catálogo de elementos y atributos del manifiesto |
Las tres primeras son las que más se mueven: las fechas y umbrales que contienen caducan. El procedimiento de revisión está en «doc 04 §8».
En la práctica. «Código nativo» quiere decir que la app tiene alguna .so en lib/<abi>/:
bibliotecas escritas en C o C++, compiladas para una ABI (la arquitectura del procesador, como
arm64-v8a). Salvo que se diga otra cosa, la unidad es la app y se mira la pieza base o única.
-
Páginas de 16 KB. Hay dos formas de contar, y cada cifra dice cuál usa.
Según la guía de Android, cumple quien tiene todas las
.sodearm64-v8a, en todas las piezas, con todos sus segmentosLOADap_alignde 16.384 o más y, si se cargan desde elAPK, además alineadas en elZIP. Así cumplen unas 8 de cada 10 apps de F-Droid con código nativo enarm64-v8a(2.201 de 2.689) y 86 de cada 100 de las más instaladas de Google Play (471 de 546). Entre las que tienentargetSdkVersion35 o más, que son a las que obliga Google Play, suben a 92 de cada 100 en las más instaladas (469 de 508) y 94 de cada 100 en F-Droid (1.995 de 2.130). De las 39 de Google Play que no cumplen, 33 fallan por unp_alignpor debajo de 16 KiB, 4 por la alineación en elZIPy 2 quedan sin veredicto.Según el cargador de Android 17, la cifra baja. Aquí cumple quien, en un dispositivo de 16 KB, no entra en modo de compatibilidad ni por
p_align, ni por RELRO, ni por solape de segmentos, y tiene elZIPbien. Así cumplen 2.096 de las 2.689 de F-Droid y, contargetSdkVersion35 o más, 405 de las 508 más instaladas de Google Play: 64 de esas 508 entran en compatibilidad por RELRO o por solape aunque sup_alignsea correcto. Ejemplos, todos en un.apkmde APKMirror, ensplit_config.arm64_v8a.apk: Photomath 8.48.0 (5.soconp_alignde 4.096), ShareIt Lite 3.9.38 (p_aligncorrecto, pero el cargador entra en compatibilidad por RELRO en 2 de 16.so) y Google Play Kiosco 5.168.0 (compatible del todo). -
extractNativeLibs. ConextractNativeLibs="false"Android carga las.sodirectamente delAPK, y por eso tienen que ir sin comprimir y alineadas. Lo escriben unas 7 de cada 10 apps de F-Droid con código nativo (1.863 de 2.709) y algo más de la mitad de las más instaladas de Google Play (344 de 615), y ninguna de ellas lleva una.socomprimida. Cuando el atributo falta, valetruey la app lleva casi siempre las.socomprimidas: 247 de las 250 apps de F-Droid con el atributo ausente yminSdkVersionmenor que 23. Lo que decide el valor es elminSdkVersion: con 23 o más, 1.854 de 2.133 apps de F-Droid escribenfalse; con menos de 23, solo 9 de 576. No podemos distinguir unfalseque puso el plugin de Gradle de uno que puso el desarrollador. Ejemplos: Facebook Lite 534.0.0.7.108 (atributo ausente,minSdkVersion23 y 2.socomprimidas) y UserLAnd (tech.ula,trueexplícito y 8 de 116.sostored). -
ABI.
arm64-v8aes la que más se ve: está en 2.689 de las 2.709 apps de F-Droid con código nativo, 790 de 820 de IzzyOnDroid y 546 de 615 de las más instaladas de Google Play. No es la única:armeabi-v7aestá en 2.071 de las 2.709 de F-Droid yx86_64en 1.982. Las ABI que el NDK r17 retiró (armeabi,mipsymips64) siguen en 63 de las 2.709 de F-Droid (en torno al 2 %) y en 9 de las 615 de Google Play. DosAPKllevanriscv64, uno de F-Droid y otro de IzzyOnDroid. Cuidado con el sorteo de Google Play: sus carpetas deadbsalen de un móvilarm64-v8a, así que su 310 de 311 no mide el mercado (el 91 % de las carpetas con código nativo traen solo esa ABI). Ejemplos: RF Analyzer (com.mantz_it.rfanalyzer,lib/riscv64/), KernelSU (me.weishu.kernelsu,lib/riscv64/) y BitBanana (app.michaelwuensch.bitbanana, conarmeabi,mipsymips64junto a las ABI vigentes). -
Android 11. Exige que el
resources.arscde las apps contargetSdkVersion30 o más vaya sin comprimir y alineado a 4 bytes, y que la app lleve una firma v2 o posterior. Se cumple en casi todas las del muestrario: 4.108 de 4.109 apps de F-Droid, y todas las de IzzyOnDroid, las más instaladas de Google Play, el sorteo y el mercado chino. Con firma v2 o posterior, todas. La única excepción esdudeofx.eval(F-Droid,targetSdkVersion36): lleva elresources.arscsin comprimir, pero sus datos empiezan en el desplazamiento 26.913, que no es múltiplo de 4. Es una excepción medida, no un fallo demostrado: no hemos comprobado qué hace Android con eseAPK. -
Baseline Profiles. Un perfil de arranque dentro del
APK(assets/dexopt/baseline.prof) es lo normal en las apps de Google Play y frecuente en las de F-Droid: lo llevan 9 de cada 10 apps entre las más instaladas y casi 9 de cada 10 del sorteo, 7 de cada 10 en F-Droid y la mitad en el mercado chino. Casi siempre va con unbaseline.profm. Ejemplo:org.fossify.math(F-Droid;baseline.profde 384 B ybaseline.profmde 6.464 B, sin comprimir). -
Símbolos nativos. La mayoría de las bibliotecas nativas van sin la tabla de símbolos ni la información de depuración. Conservan
.symtab1.893 de 30.284.sode F-Droid y 799 de 23.930 de las apps de Google Play más instaladas; llevan secciones.debug_*265 y 226 respectivamente. Son recuentos de ficheros.so, no de apps: una misma biblioteca puede repetirse en muchas apps y no distinguimos una propia de una de terceros.
9. Google Play: los requisitos que caducan cada año
https://developer.android.com/google/play/requirements/target-sdk Consultado el 12 de agosto de 2026, el 31 de octubre de 2026 y el 1 de noviembre de 2026 («Last updated 2026-10-28 UTC»).
No es una especificación de formato, pero condiciona qué APK circulan, y por eso pertenece a
este índice. Estado el día de la consulta:
| Regla | Umbral | Fecha |
|---|---|---|
| Aplicaciones nuevas y actualizaciones | Android 16 (API 36) o superior | desde el 31 de agosto de 2026 |
| Aplicaciones ya publicadas, para seguir disponibles a usuarios nuevos | Android 15 (API 35) o superior | vigente |
| Wear OS y Android Automotive (apps nuevas) | Android 15 (API 35) | desde el 31 de agosto de 2026 |
| Android TV y Android XR (apps nuevas) | Android 14 (API 34) | desde el 31 de agosto de 2026 |
Esta tabla tiene fecha de caducidad conocida: se queda obsoleta en agosto de 2027. Es el elemento de mantenimiento más previsible de toda esta documentación.
La prórroga ya terminó. Google dejó pedir en Play Console una prórroga para el requisito de API 36. Con ella, una app seguía llegando a todos los usuarios de Play aunque no apuntara a API 36, pero solo hasta el 1 de noviembre de 2026. Esa fecha era el final de la prórroga, no el plazo para pedirla. Desde el 2 de noviembre de 2026 ya no cubre a ninguna app.
El otro requisito con fecha es el de las páginas de 16 KB («§8 · Google: la plataforma y el empaquetado»). Rige desde el 1 de noviembre de
2025 para las apps nuevas y las actualizaciones con targetSdkVersion 35 o superior; el 1 de
febrero de 2027 es el plazo que da Google Play para publicar actualizaciones que no lo cumplan
(«sección 6.2 de Código nativo y ELF · Fecha y alcance en Google Play»). La página de 16 KB,
consultada el 31 de octubre de 2026 («Last updated 2026-10-16 UTC»), da la fecha del 1 de febrero
de 2027.
En la práctica. Con las descargas de octubre de 2026, 599 de las 658 apps más instaladas de
Google Play (91 %) declaran targetSdkVersion 35 o más, el nivel que Google Play pide para seguir
mostrando una app a usuarios nuevos; 502 de 658 (76 %) declaran 36 o más, el que pide para las apps
nuevas y las actualizaciones desde el 31 de agosto de 2026. En el sorteo, 322 de 369 declaran 35 o
más. Fuera de Google Play el reparto es otro: en torno al 62 % de las apps de F-Droid declaran 35
o más, y solo 16 de las 100 del mercado chino. Las más instaladas llegan de espejos y pueden no
ser la última versión, y no guardamos la fecha de cada versión: estas cifras no dicen si una app
cumplía el requisito el día en que se publicó.
10. Estándares externos: el contenedor
10.1 PKWARE APPNOTE.TXT — .ZIP File Format Specification
https://pkware.cachefly.net/webdocs/casestudies/APPNOTE.TXT Versión 6.3.10, revisada el 1 de noviembre de 2022. Estado: FINAL, sustituye a la 6.3.9. (Los tres datos están en la cabecera del propio fichero y los leímos de ahí.)
La especificación del ZIP, y por tanto de la capa más externa de todo APK, AAB, .apks,
.xapk y .apkm. Define Local File Header, Central Directory, EOCD, las estructuras
Zip64, el data descriptor y el bit 3 del campo de flags, y los métodos de compresión. Los 388
.apkm y los 72 .xapk del muestrario se abren como ZIP estándar: ninguna entrada está cifrada
y solo hay entradas stored (método 0, sin comprimir) y deflate (método 8). Las 365 carpetas de
adb no son ZIP, y no tenemos ningún .aab ni .apks.
Cuándo: es la fuente de casi todo «Contenedor ZIP».
Trampa de acceso: la URL «bonita» https://support.pkware.com/pkzip/appnote ya no sirve el
documento: redirige a una página de producto en pkware.my.site.com. La del dominio principal,
https://www.pkware.com/documents/casestudies/APPNOTE.TXT, sí devuelve texto, pero la versión
6.3.9 de julio de 2020, desde una copia en pkwaredownloads.blob.core.windows.net. El mismo CDN
de arriba publica la versión con su número en la ruta,
https://pkware.cachefly.net/webdocs/APPNOTE/APPNOTE-6.3.10.TXT, byte a byte idéntica (SHA-256
0b993022…a50cd6, mismo ETag): es lo más parecido a una dirección permanente, porque no
cambiará de contenido cuando salga otra versión, aunque ninguna página de PKWARE la enlace.
Lo comprobamos el 25 de septiembre de 2026. Aun así, conviene guardar una copia local con su
SHA-256.
Su límite, y es grande: la especificación describe el ZIP correcto. No describe qué hace
Android con un ZIP incorrecto (por ejemplo, que la cabecera de una entrada, el
Local File Header, diga otra cosa que el índice del final, el Central Directory, o que falte
el data descriptor con el flag puesto). Eso solo está en libziparchive.
En la práctica. Los APK del muestrario son ZIP casi siempre limpios. De las 30 anomalías
que buscamos en las 15.183 piezas, solo apareció una: bytes antes de la primera entrada (un
registro vacío de 132, 139 o 140 bytes), en 208 piezas. Se concentra en IzzyOnDroid, en torno a
una de cada diez piezas, y en el resto es rara: 48 de 4.766 en F-Droid, 6 de 100 en el mercado
chino, 5 de 7.893 en las más instaladas de Google Play y 6 de 1.272 en el sorteo. Ninguna pieza
usa ZIP64, y en ninguna la cabecera local difiere del directorio central en el bit 3. Ese bit (el
tamaño y el CRC van después de los datos) se ve más en F-Droid, con 410 de 4.766 piezas, y en el
mercado chino, con 37 de 100. De las 526 piezas con bit 3, 408 las firmó jarsigner. Ejemplos: moe.henry_zhr.kill_domain_verification (IzzyOnDroid, 132 bytes antes de
la primera entrada), pro.rudloff.lineageos_updater_shortcut (F-Droid, 7 entradas con bit 3,
firmada con jarsigner) y Magisk 30.7 (com.topjohnwu.magisk, F-Droid, comentario en el EOCD).
Campos extra del ZIP. El relleno de alineación de zipalign son ceros sueltos, sin
identificador: lo llevan 9 de cada 10 piezas de F-Droid. apksigner y bundletool escriben el
registro 0xd935: unas 5 de cada 100 piezas de F-Droid y 14 de cada 100 de IzzyOnDroid. El
registro 0xcafe es la marca de los JAR: aparece en 155 piezas de F-Droid.
10.2 JAR File Specification
https://docs.oracle.com/en/java/javase/21/docs/specs/jar/jar.html (Java SE 21) La edición antigua https://docs.oracle.com/javase/8/docs/technotes/guides/jar/jar.html (Java SE 8) también responde y es la que citan muchas herramientas.
Define META-INF/MANIFEST.MF con su gramática, el límite de 72 bytes por línea y su regla de
continuación, los atributos x-Digest-Manifest y x-Digest, los nombres reservados de
META-INF/, las extensiones .RSA/.DSA/.EC y el procedimiento de validación.
En la práctica. La extensión del fichero de firma de META-INF/ coincide siempre con el tipo
de clave del certificado. Las 9.745 piezas con firma v1 llevan .RSA (9.448), .DSA (294) o
.EC (3), y ninguna lleva más de un .SF ni más de un bloque. La coincidencia es total en todas
las fuentes.
Cuándo: para todo lo relativo a la firma v1. Es la base de v1, pero Android no la sigue al
pie de la letra: apksig lo reconoce en V1SchemeVerifier («Android's APK verification logic
differs from that spec»). Hay dos diferencias:
- La especificación mete en el manifiesto los ficheros de los subdirectorios de
META-INF/y los deMETA-INF/que no son de firma; Android no exige digest de nada bajoMETA-INF/. - El
.SFde Android lleva la cabeceraX-Android-APK-Signed, que Java no conoce.
Un verificador escrito solo con esta spec no se comporta como el de Android.
En la práctica (X-Android-APK-Signed). La cabecera aparece cuando el APK lleva también una
firma v2 o posterior: 9.323 piezas con .SF. Donde más falta es en F-Droid (la lleva el 89 %); en
IzzyOnDroid, Google Play y el mercado chino casi siempre está. De las 422 piezas sin ella, 420
están firmadas solo con v1 (F-Droid 399, IzzyOnDroid 16, Google Play 4, mercado chino 1). Las
otras 2 llevan v2 o posterior, pero las firmó una herramienta distinta de apksigner
(Created-By 21.0.8 de BiSheng y keystore-cli (Go)). Cuando está, su valor (2 o 2, 3)
coincide siempre con los esquemas del bloque de firma. Ejemplos: pro.rudloff.lineageos_updater_shortcut (solo v1, sin la
cabecera), Bolt (ee.mtakso.client CA.229.0, v1 y v2 sin la cabecera, Created-By 21.0.8 de
BiSheng) y com.tencent.tgclub (v1 y v2 sin la cabecera, keystore-cli (Go)).
JEP 238: Multi-Release JAR Files — https://openjdk.org/jeps/238. Define el atributo
Multi-Release: true y la estructura META-INF/versions/<N>/. En la práctica. La carpeta
META-INF/versions/ está en 532 de las 4.766 apps de F-Droid y en 129 de las 658 de Google Play
más instaladas, pero casi nunca con clases de otra versión de Java: lo que lleva dentro es un
OSGI-INF/MANIFEST.MF (847 piezas) o un previous-compilation-data.bin (25), y solo una app de
todo el muestrario, de F-Droid, declara Multi-Release: true. Ejemplos: org.dydlakcloud.resticopia
(la única con Multi-Release: true, con N = 9) y org.codeberg.quecomet.oshi
(META-INF/versions/9/previous-compilation-data.bin).
10.3 DEFLATE y ZLIB
https://www.rfc-editor.org/rfc/rfc1951.html — DEFLATE Compressed Data Format Specification version 1.3, mayo de 1996. https://www.rfc-editor.org/rfc/rfc1950.html — ZLIB Compressed Data Format Specification version 3.3, mayo de 1996.
RFC 1951 define el método de compresión 8 del ZIP (deflate), que es el que usa toda entrada
comprimida de los APK del muestrario: ninguna de las 15.183 piezas tiene entradas con otro
método que no sea stored (0, sin comprimir) o deflate (8). RFC 1950 define Adler-32, que es
la suma de comprobación de la cabecera del DEX (bytes 8 a 11).
Cuándo: rara vez hay que implementarlos —hay bibliotecas—, pero si recalculas la cabecera de
un DEX, la definición de Adler-32 que debes citar es la del campo ADLER32, en el apartado 2.2
de la RFC 1950; su apartado 9 es código C de ejemplo, y el 8.2, la justificación del algoritmo.
En la práctica. El Adler-32 de la cabecera es correcto en los 16.158 DEX que leímos, sin
excepción. El SHA-1 del campo signature, en cambio, no coincide con el contenido en 415. Por piezas
con DEX en la raíz: 6 de cada 100 en F-Droid, 3 de cada 100 en IzzyOnDroid, 26 de 100 en el
mercado chino, 4 de 773 en las más instaladas de Google Play y 2 de 373 en el sorteo. De los 415
DEX, 382 son de la versión 035, y entre los que anotan su compilador destacan versiones antiguas
de D8 (1.2.49, 1.4.94 y 1.5.69) y de R8 (1.5.64). Ejemplo: el classes.dex de
net.iptux.xposed.usbdebugging (IzzyOnDroid): Adler-32 bien y SHA-1 mal, compilado con R8 1.4.94.
11. Estándares externos: la criptografía
Todo lo que un APK firma se apoya en esta pila. Ninguno de estos documentos es específico de
Android; todos son normativos.
| Documento | URL | Fecha / estado | Qué aporta al APK |
|---|---|---|---|
| RFC 5652 — Cryptographic Message Syntax (CMS) | https://www.rfc-editor.org/rfc/rfc5652.html |
Septiembre de 2009, Standards Track, R. Housley. Obsoleta la RFC 3852 | El SignedData que es el contenido de los ficheros .RSA/.DSA/.EC de la firma v1 |
| RFC 2315 — PKCS #7 v1.5 | https://www.rfc-editor.org/rfc/rfc2315.html |
Marzo de 1998, Informational | La versión antigua del mismo formato. Se cita porque las herramientas y el glosario dicen «PKCS#7»; lo vigente es CMS |
| RFC 8017 — PKCS #1: RSA Cryptography Specifications v2.2 | https://www.rfc-editor.org/rfc/rfc8017.html |
Noviembre de 2016, Informational. Moriarty (ed.), Kaliski, Jonsson, Rusch. Obsoleta la RFC 3447 | RSASSA-PKCS1-v1_5, que es lo habitual (0x0103 y 0x0104, y 0x0421, su variante con el resumen de verity, «§12.5 · fs-verity»), y RSASSA-PSS, opcional (0x0101 y 0x0102). Ningún firmante del muestrario usa PSS (cifras bajo la tabla; «sección 7 de APK Signing Block · Algoritmos de firma») |
| RFC 5280 — X.509 PKI Certificate and CRL Profile | https://www.rfc-editor.org/rfc/rfc5280.html |
Mayo de 2008, Standards Track | El certificado que viaja en el bloque de firma y contra el que se compara la identidad del firmante |
| RFC 7292 — PKCS #12 v1.1 | https://www.rfc-editor.org/rfc/rfc7292.html |
Julio de 2014, Informational | El formato .p12 de los keystores modernos, sucesor de JKS |
| FIPS 180-4 — Secure Hash Standard | https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.180-4.pdf |
Agosto de 2015, NIST | SHA-256 y SHA-512, los digests de todos los esquemas de firma, y SHA-1: el que apksig elige para la firma v1 cuando minSdkVersion es menor que 18 (RSA) o que 21 (DSA), y el del campo signature de la cabecera del DEX |
| FIPS 186-5 — Digital Signature Standard (DSS) | https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.186-5.pdf |
3 de febrero de 2023, NIST. Sustituye a la FIPS 186-4 | ECDSA, la de 0x0201, 0x0202 y 0x0423. DSA ya no se especifica aquí: solo se admite para verificar firmas anteriores, y su definición sigue en la FIPS 186-4 (https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.186-4.pdf), que es la referencia de 0x0301 y 0x0425 |
| FIPS 204 — Module-Lattice-Based Digital Signature Standard | https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.204.pdf |
13 de agosto de 2024, NIST | ML-DSA, la mitad poscuántica de la firma v3.2: 0x0501, con ML-DSA-65 o ML-DSA-87 («sección 7 de Esquemas de firma · v3.2: la firma híbrida»). En el muestrario, las 34 piezas con v3.2 usan ML-DSA-65 (nota bajo la tabla) |
Cuándo: RFC 5652 y RFC 8017 son las dos que de verdad hacen falta para implementar un
verificador; las demás se consultan puntualmente. La tabla de qué algoritmo concreto usa cada
identificador no está en ningún RFC: está en SignatureAlgorithm.java de apksig.
En la práctica.
- Algoritmos de firma (RFC 8017). En el muestrario nadie usa RSASSA-PSS (
0x0101,0x0102): ni un firmante, ni una app de ninguna fuente. Los bloques v2, v3 y v3.1 de las 15.178 piezas (sin las 5 de protectores) tienen 28.072 firmantes y 6.072 certificados distintos. Apariciones por identificador:0x010321.270,0x01045.872,0x0421(verity) 1.861, DSA0x0301913 y0x04255, ECDSA0x020111 y0x02026, y0x99012 (un identificador que ninguna fuente de esta sección nombra). Un firmante con verity cuenta en dos identificadores. «Lo habitual» se confirma por app:0x0103está en 9 de cada 10 apps de F-Droid y casi 19 de cada 20 de IzzyOnDroid;0x0104, en 247 de 369 del sorteo. La variante con verity no sale por defecto: una de cada cinco apps de F-Droid y 17 de 654 de las más instaladas de Google Play. Ejemplos:pro.rudloff.search_to_browser(F-Droid;0x0421junto a0x0103) yrsquared226.budget_my_life(IzzyOnDroid; el firmante v2 lista0x0103y0x9901). - SHA-1 en la firma v1 (FIPS 180-4). La regla de
apksig(fuente 29) se cumple casi siempre. Las 5.562 piezas con v1 yminSdkVersionmenor que 18 (5.299 con RSA y 263 con DSA; unminSdkVersionsin declarar cuenta como 1) llevan todas digests SHA-1. Se apartan 143 piezas con v1, todas con RSA y SHA-1 pese a tenerminSdkVersionde 18 o más (46 con 18–20 y 97 con 21 o más). Casi todas las firmójarsigner(133; 6 son deapksigner, 3 deSignApky 1 de otra herramienta), y casi todas son de F-Droid: 131 de 3.663, frente a 4 de 94 en el mercado chino, 4 de 728 en IzzyOnDroid, 3 de 4.396 en las más instaladas de Google Play y ninguna en el sorteo. Ejemplo:pro.rudloff.lineageos_updater_shortcut(SHA-1 conminSdkVersionde 18 o más, firmada conjarsigner). - Certificados (RFC 5280). «Firmado con SHA-1» o «con MD5» es el algoritmo de firma del
propio certificado, no el resumen de la firma del
APK. Miramos el certificado del firmante de la pieza base o única. Los certificados viejos abundan en Google Play: firmado con SHA-1 está el de algo más de la mitad de las apps más instaladas (349 de 658), el 58 % de las del mercado chino, el 14 % del sorteo y en torno al 3 % de F-Droid e IzzyOnDroid. Firmado con MD5: 42 de 658 de las más instaladas de Google Play, 2 de 369 del sorteo, 2 de 100 del mercado chino y ninguna en F-Droid ni IzzyOnDroid. Con el firmante de v3.1, que es el que ve Android 13 o posterior, las más instaladas de Google Play bajan a 16 de 658 con MD5 y 319 con SHA-1. Caducado antes del 19 de octubre de 2026: 10 de 4.766 de F-Droid y 7 de 1.402 de IzzyOnDroid. Certificado con emisor distinto del sujeto (no autofirmado), en piezas de las más instaladas de Google Play: 184 de 7.893, y ninguna en los demás grupos. No hemos medido los periodos de validez de 25 años o más. Ejemplos: Google Play Música 8.29.9113 (com.google.android.music, certificado del firmante v3.1 firmado con MD5) yzatrit.skinbread(F-Droid, certificado caducado). - ECDSA y DSA (FIPS 186-5). ECDSA es rara y reciente: tienen clave EC 9 de las 4.766 apps de
F-Droid y 5 de las 1.402 de IzzyOnDroid, con certificados emitidos desde 2024, y ninguna app de
Google Play ni del mercado chino. DSA es antigua: 39 apps (F-Droid 7, IzzyOnDroid 4, las más
instaladas de Google Play 22, sorteo 3, mercado chino 2, webs de autores 1); en 35 de las 39 el
certificado es de 2008 a 2017 y en 4, de 2021 a 2023. Ninguna app con DSA lleva solo v1.
Ejemplos, todos de IzzyOnDroid:
org.axpos.lovelaceav(clave EC P-521),be.cuypers_ghys.gaai(clave EC P-256) ycom.netvor.settings.database.provider(clave DSA). - ML-DSA (FIPS 204).
0x0501aparece en 34 firmantes, el segundo de cada uno de los 34 bloques v3.2, en 34 piezas de 9 apps del sorteo de Google Play («sección 5.3 · APK signature scheme v3 y v3.1»). Todos son ML-DSA-65; ninguno es ML-DSA-87.apksignercon Java 25 verifica las 34; con Java 21 no lee ML-DSA.
12. Estándares externos: codificaciones y binario
12.1 UTF-8, y por qué el DEX no lo usa
https://www.rfc-editor.org/rfc/rfc3629.html — UTF-8, a transformation format of ISO
10646. STD 63, noviembre de 2003.
https://www.unicode.org/versions/latest/ — el estándar Unicode vigente. Lo comprobamos el 24
de septiembre de 2026: redirige a https://www.unicode.org/versions/Unicode18.0.0/, es decir,
la versión en vigor es Unicode 18.0.0 (el 12 de agosto aún era la 17.0.0).
RFC 3629 define el UTF-8 estándar. En resources.arsc y en el XML binario (AXML) las
cadenas pueden ir en UTF-8: es cuando su string pool (la tabla de cadenas) lleva la bandera
UTF8_FLAG. Es casi el UTF-8 normal. aapt2 pasa cada cadena por Utf8ToModifiedUtf8, y la
diferencia es que escribe los caracteres que no caben en 16 bits (fuera del BMP, el plano básico
de Unicode), como los emojis, como dos piezas de tres bytes en vez de una de cuatro. Es lo que se
llama CESU-8. Con texto latino, cirílico o chino no cambia nada; con un emoji, sí.
En la práctica. En el muestrario el resources.arsc va casi siempre en UTF-8 y el manifiesto
compilado casi nunca. El string pool global de resources.arsc está en UTF-8 en el 99 % de las
piezas de F-Droid y de IzzyOnDroid y en todas las de las más instaladas de Google Play, el
sorteo, el mercado chino y las webs de autores. El del manifiesto, solo en 31 de las 15.183
piezas (26 de F-Droid, 2 de IzzyOnDroid, 1 de las más instaladas de Google Play y 2 del mercado
chino). Ejemplo: com.jvillalba.apod.md (F-Droid, manifiesto con el pool en UTF-8). No hemos
medido cuántas cadenas llevan emojis u otros caracteres de cuatro bytes: no guardamos el texto de
las cadenas, así que la regla de Utf8ToModifiedUtf8 queda sin contrastar.
El DEX no usa esto. Usa MUTF-8 (Modified UTF-8), una variante de UTF-8 heredada de Java
que cambia dos cosas: el carácter nulo (U+0000) ocupa dos bytes (0xC0 0x80) en vez de uno, y
los caracteres que no caben en 16 bits, como los emojis, se escriben como dos piezas de tres
bytes (pares subrogados) en vez de una de cuatro. Con texto ASCII no hay diferencia; por eso
leer MUTF-8 como UTF-8 parece funcionar hasta que aparece un nombre con un carácter así, y
entonces falla en silencio. Es un error clásico. No hemos medido qué parte de las cadenas de los
DEX es ASCII puro.
La definición normativa de MUTF-8 no está en un RFC, sino en la especificación de la JVM:
https://docs.oracle.com/javase/specs/jvms/se21/html/jvms-4.html, apartado 4.4.7
(«The CONSTANT_Utf8_info Structure»). La spec del DEX («§4.1 · Dalvik executable format») la describe también, y remite al
mismo sitio.
Cuándo: al escribir el lector de cadenas de un DEX. Es la diferencia entre un parser que
funciona y uno que corrompe nombres de clase con caracteres no latinos.
12.2 LEB128
https://dwarfstd.org/doc/DWARF5.pdf — DWARF Debugging Information Format, Version 5, 13 de febrero de 2017, DWARF Debugging Information Format Committee. (Título y fecha leídos de la portada del propio PDF.)
LEB128 (Little Endian Base 128) es la codificación de enteros de longitud variable que el
DEX usa en casi todas sus estructuras, en las variantes uleb128, sleb128 y uleb128p1.
Su origen normativo es DWARF, no Android: Google la tomó prestada.
Cuándo: en la práctica, la descripción de la spec del DEX («§4.1 · Dalvik executable format») basta y es más directa. Se
cita DWARF por rigor de procedencia y porque su redacción del caso con signo es más clara. LEB128
está en el apartado 7.6, «Variable Length Data» (páginas 221-222, con los ejemplos de las
tablas 7.7 y 7.8), y los algoritmos de codificación y decodificación, en el apéndice C,
«Variable Length Data: Encoding/Decoding (Informative)» (página 283).
12.3 Protocol Buffers
https://protobuf.dev/programming-guides/encoding/ — la referencia del wire format.
https://protobuf.dev/programming-guides/proto3/ — el lenguaje .proto.
El AAB está hecho de protobuf: BundleConfig.pb, resources.pb, toc.pb. La página de
encoding documenta los varints (base 128, con bit de continuación: el mismo principio que
LEB128, distinto formato) y los seis wire types: VARINT (0), I64 (1), LEN (2),
SGROUP (3), EGROUP (4), I32 (5).
Cuándo: al leer un .pb sin tener el .proto a mano. Con los wire types puedes recorrer un
mensaje desconocido y sacar la estructura, que es justo lo que hace falta para inspeccionar un
toc.pb cuya versión no conoces.
12.4 ELF
https://refspecs.linuxfoundation.org/elf/gabi4+/contents.html — System V ABI, generic
(gABI): ch4.eheader.html para Elf64_Ehdr y e_ident, ch5.pheader.html para
Elf64_Phdr y p_align.
https://github.com/ARM-software/abi-aa/blob/main/aaelf64/aaelf64.rst — ELF for the Arm
64-bit Architecture (AAELF64).
El gABI es la parte genérica; la parte específica de cada arquitectura vive aparte. Ojo con la
versión: la copia de refspecs es un borrador de 2001 y no conoce la arquitectura ARM de 64 bits,
así que le falta EM_AARCH64 (183, 0xB7), el valor que identifica en la cabecera una .so
de arm64-v8a, que es la ABI que más se ve («§8 · Google: la plataforma y el empaquetado»). Sí lo tienen el gABI mantenido
(https://www.sco.com/developers/gabi/latest/ch4.eheader.html) y AAELF64.
Cuándo: al identificar un .so de lib/<abi>/ o al comprobar la alineación de sus segmentos
LOAD para la regla de 16 KB.
12.5 fs-verity
https://docs.kernel.org/filesystems/fsverity.html — documentación del kernel de Linux.
Define la construcción del árbol de Merkle, el relleno con ceros del último bloque, el
tratamiento de la sal y —el detalle que se escapa— que el digest se calcula sobre la
estructura fsverity_descriptor, no sobre la raíz del árbol a secas.
Cuándo: imprescindible para la firma v4. La página de v4 de source.android.com («§5.4 · APK signature scheme v4»)
describe el .idsig pero delega en esta la matemática del árbol.
12.6 JNI
https://docs.oracle.com/en/java/javase/21/docs/specs/jni/index.html (Java SE 21) y
https://docs.oracle.com/javase/8/docs/technotes/guides/jni/spec/design.html (Java SE 8,
Design Overview). La composición del nombre mangled, la tabla de escapes _0–_3 y la
regla del nombre corto frente al largo. Es normativa: Android implementa JNI, no lo redefine.
Cuándo: al correlacionar un método native con el símbolo exportado de un .so. La guía de
Android (https://developer.android.com/ndk/guides/jni-tips, antes
/training/articles/perf-jni) añade RegisterNatives, que es justo lo que rompe esa
correlación.
En la práctica. Un tercio de las bibliotecas nativas del muestrario exporta JNI_OnLoad y
ningún símbolo Java_*, que es el rastro del registro dinámico con RegisterNatives (la
biblioteca dice al arrancar qué función corresponde a cada método native, en vez de dejarlo al
nombre del símbolo): 10.246 de 30.284 .so de F-Droid y 7.618 de 23.930 de las apps de Google
Play más instaladas. Son recuentos de ficheros .so y repiten bibliotecas conocidas: si quitamos
las .so cuyo nombre aparece en 3 apps o más, en F-Droid quedan 196 con solo JNI_OnLoad, 399
con ambos, 1.164 con solo Java_* y 2.832 con ninguno. Es una pista, no una medida de
RegisterNatives: no hemos desensamblado ninguna .so.
12.7 Marcos multiplataforma y sus formatos
Muchas apps no escriben su código en Java o Kotlin y, por tanto, no lo llevan en el DEX. Usan un
marco (framework) que trae su propio formato de código. Para casi todos esos formatos no hemos
encontrado una especificación publicada (no hicimos una búsqueda exhaustiva): lo que define el
formato es el código del marco. La excepción es el código de .NET (Xamarin, .NET MAUI): su
lenguaje intermedio, CIL, está en el estándar ECMA-335,
https://ecma-international.org/publications-and-standards/standards/ecma-335/
(Common Language Infrastructure, 6.ª edición, junio de 2012; consultado el 31 de octubre de
2026), cuya partición III es el juego de instrucciones CIL.
En la práctica. El marco se reconoce por archivos de lib/, assets/ y META-INF/, no
ejecutando la app, y una app puede llevar más de uno. Llevan código fuera del DEX, de alguno de
los marcos que reconocemos: el 17 % de las apps de F-Droid (814 de 4.766), el 16 % de las de
IzzyOnDroid, el 36 % de las más instaladas de Google Play, el 60 % del sorteo y el 67 % del
mercado chino. Por marco, de menor a mayor presencia por fuente:
- Flutter. Muy presente en F-Droid e IzzyOnDroid (en torno al 11 %) y en el sorteo y el mercado chino (17–18 %); poco entre las más instaladas de Google Play (33 de 658).
- React Native. Frecuente en el mercado chino (25 de 100); 50 de 658 entre las más instaladas de Google Play, 37 de 369 en el sorteo, y raro en F-Droid (96 de 4.766) e IzzyOnDroid (14 de 1.402).
- Unity. Ninguna app de F-Droid ni de IzzyOnDroid. 110 de 658 entre las más instaladas de Google Play, 84 de 369 en el sorteo y 13 de 100 en el mercado chino.
- Otros. Xamarin / .NET para Android: 9 de 1.402 en IzzyOnDroid y 1 de 658 y 1 de 369 en Google Play. Capacitor: 72 de 4.766 en F-Droid, 25 de 1.402 en IzzyOnDroid, 4 de 658 y 8 de 369 en Google Play. Cordova: 23 de 4.766 en F-Droid, 7 de 1.402 en IzzyOnDroid, 2 de 658 y 8 de 369 en Google Play. Godot: 40 de 4.766 en F-Droid, 1 de 658 y 4 de 369 en Google Play. Cocos2d-x / Cocos Creator: 23 de 658 y 10 de 369 en Google Play, 6 de 100 en el mercado chino. Unreal Engine: 3 de 658 en las más instaladas de Google Play, ninguna más.
No medimos la versión del marco. Ejemplos:
- Antistress (
com.JindoBlu.Antistress11.4.3): Unity. com.cn21.ecloud(360): Flutter, protegida con Ijiami.- Housing (15.2.3, APKPure): React Native.
com.ovz.carscanner2.2.21: Xamarin / .NET para Android.com.natenai.glowhockey1.5.2 (.apkm,base.apk): Godot.
13. Qué revisión se está citando
Resumen de todo lo anterior en un solo sitio. Sin esta tabla la lista no vale para mantener nada: dentro de un año habrá que comparar contra estos valores para saber qué se movió.
| Especificación | Revisión / versión | Fecha | Estabilidad esperada |
|---|---|---|---|
| PKWARE APPNOTE.TXT | 6.3.10 (FINAL) | 1 nov 2022 | Muy alta — años |
| JAR File Specification | Java SE 21 | — | Muy alta — congelada de hecho |
| JEP 238 | final | — | Muy alta |
| RFC 5652 (CMS) | STD, obsoleta 3852 | sep 2009 | Muy alta |
| RFC 8017 (PKCS#1 v2.2) | obsoleta 3447 | nov 2016 | Muy alta |
| RFC 5280 (X.509) | Standards Track | may 2008 | Muy alta |
| RFC 7292 (PKCS#12 v1.1) | Informational | jul 2014 | Muy alta |
| RFC 3629 (UTF-8) | STD 63 | nov 2003 | Congelada |
| RFC 1951 / 1950 | 1.3 / 3.3 | may 1996 | Congeladas |
| DWARF | Versión 5 | 13 feb 2017 | Alta |
| Dalvik executable format | «Last updated» | 9 oct 2026 (texto de 3 oct 2025) | Media — cambia con el DEX |
| Dalvik bytecode | «Last updated» | 9 oct 2026 (texto de 7 ene 2025) | Alta |
| Instruction formats | «Last updated» | 9 oct 2026 (texto de 26 ago 2024) | Muy alta |
| Firma v2 / v3 / v3.1 / v3.2 / v4 | sin versionar | — | Alta — v3.2 llegó con Android 17 |
| Requisitos de Play | vigente | ago 2026 | Baja — caduca en 2027 |
| Páginas de 16 KB | vigente | 1 nov 2025 (requisito); 1 feb 2027 (plazo) | Baja — fecha límite feb 2027 |
| Resources.proto / commands.proto | etiqueta android-17.0.0_r1 / etiqueta 1.18.3 |
— | Media — sin versionar |
Constraints (DEX y bytecode) |
«Last updated» | 9 oct 2026 (texto de 12 mar 2025) | Media — cambia con el DEX |
| FIPS 186-5 (DSS) | final | 3 feb 2023 | Muy alta |
| FIPS 204 (ML-DSA) | final | 13 ago 2024 | Alta — estándar reciente |
| ECMA-335 (CLI) | 6.ª edición | jun 2012 | Muy alta |
La marca «Last updated» de source.android.com no fecha el contenido. El sitio la renueva en
bloque. El 9 de octubre de 2026 cambió la marca de las cuatro páginas del runtime —Dalvik
executable format, Dalvik bytecode, Instruction formats y Constraints, que decían 3 oct
2025, 7 ene 2025, 26 ago 2024 y 12 mar 2025— sin cambiar su texto: el del artículo de las cuatro
es idéntico al de las copias anteriores del Internet Archive. Para saber si una especificación ha
cambiado hay que comparar su texto, no su marca. En la tabla, la fecha entre paréntesis es la
marca anterior, que ya llevaba ese mismo texto.
Mantenimiento. Las notas «En la práctica» de este documento dan cifras del muestrario descargado entre el 19 y el 27 de octubre de 2026 y caducan con él: habrá que recalcularlas cuando se renueve.
14. Lo que ninguna especificación cubre
La lista concreta. Todo lo de aquí solo está en el código, y por eso existe el «documento 03»:
| Pieza | Por qué no hay spec | Dónde está la autoridad |
|---|---|---|
resources.arsc completo |
Formato interno de la plataforma | androidfw/ResourceTypes.h |
AXML completo |
Ídem | androidfw/ResourceTypes.h |
ResTable_config y sus reglas de match |
Ídem. La lógica de «qué configuración gana» es puro código | ResourceTypes.cpp: match(), isBetterThan() |
FLAG_SPARSE, FLAG_OFFSET16, FLAG_COMPACT |
Optimizaciones añadidas sin documentar. De las tres, solo FLAG_SPARSE se ve en el muestrario (nota bajo la tabla) |
LoadedArsc.cpp (lectura), TableFlattener.cpp (escritura) |
El DEX de contenedor (versión 041) |
La spec sí lo documenta, en «Container format», pero como experimental y sin el detalle del código | art/libdexfile/dex/dex_file.h |
Tolerancia del lector de ZIP de Android |
La spec describe el ZIP correcto, no el roto |
system/libziparchive/zip_archive.cc |
Identificadores del APK Signing Block de terceros |
Nadie los publica: los datos de dependencias del plugin de Gradle, el frosting de Google Play, los canales de las tiendas chinas (Walle, de Meituan, y VasDolly, de Tencent) y once identificadores más que ninguna fuente nombra | apksig para los de Google; avast/apkverifier para el resto |
| Correspondencia identificador → algoritmo de firma | La spec da la tabla, el código da los parámetros PSS exactos | apksig/SignatureAlgorithm.java |
Gramática completa de mapping.txt |
doc/retrace.md cubre la mitad |
R8: ProguardMapReader.java |
baseline.prof / .profm |
Formato interno de ART | art/libprofile/.../profile_compilation_info.cc |
.kotlin_module |
No hay documento de ningún tipo. Es el fichero que Kotlin deja en META-INF/ con la lista de las funciones sueltas de un módulo |
Solo la API kotlinx-metadata-jvm |
odex / vdex / oat |
Formatos internos del dispositivo, sin garantía entre versiones | art/runtime/oat/ |
| Protectores y empaquetadores comerciales (Jiagu 360, Bangcle/SecNeo, Ijiami, Tencent Legu, Baidu, DexGuard, DexProtector) | Cifran o esconden el DEX, y muchos cargan el código real desde una .so propia. Ninguno publica su formato que hayamos encontrado |
Las reglas de APKiD y, para PairIP, el código de la propia app protegida. Ver «Packers y protectores» |
.apkm, .xapk y carpetas de adb |
Formatos de tiendas de terceros, sin documento publicado que hayamos encontrado | Los propios ficheros («sección 6.4 · Formatos de distribución de terceros: .apkm, .xapk y carpetas de adb») |
Formatos de código de los marcos multiplataforma (por ejemplo, el snapshot de Dart y el global-metadata.dat de IL2CPP) |
Los define el código del marco; el CIL de .NET es la excepción (ECMA-335) | El código del propio marco («sección 12.7 · Marcos multiplataforma y sus formatos») |
Qué escribe aapt2 exactamente |
No hay contrato de salida | aapt2/format/binary/TableFlattener.cpp |
En la práctica.
.kotlin_module. Casi todas las apps usan Kotlin, pero pocas conservan este fichero. Llevan algúnMETA-INF/*.kotlin_moduleen alguna pieza el 8 % de las apps de F-Droid y de IzzyOnDroid, casi la mitad de las más instaladas de Google Play (313 de 658), el 14 % del sorteo y el 36 % del mercado chino. Con alguna prueba de Kotlin en elDEXhay 3.956 de 4.765 apps de F-Droid y 589 de 658 de las más instaladas de Google Play. De esas, no conservan ningún.kotlin_module9 de cada 10 en F-Droid (3.561 de 3.956) y casi la mitad entre las más instaladas (276 de 589), porque las herramientas de reducción de código pueden quitarlo. Ejemplo:org.debian.eugen.headingcalculator(F-Droid, conMETA-INF/*.kotlin_module).FLAG_SPARSE,FLAG_OFFSET16yFLAG_COMPACT.FLAG_SPARSE(tipos dispersos, de Android 8) está en alguna pieza de 100 de las 658 apps de Google Play más instaladas, 32 de las 369 del sorteo y 1 de las 100 del mercado chino; en F-Droid e IzzyOnDroid, en ninguna. Ninguna app llevaFLAG_OFFSET16niFLAG_COMPACT(ambos de Android 14), ni el alias staged (Android 12) ni el flagged (Android 16). «No se ve» es de este muestrario; no quiere decir que Android 14 no los admita.- Identificadores de terceros del bloque de firma. En las 15.183 piezas aparecen 21
identificadores de par distintos: diez con nombre en «APK Signing Block»
(v2, v3, v3.1, v3.2, el sello v2, el relleno, el frosting, los datos de dependencias, Walle y
VasDolly) y once sin nombre (
0xfa1cfabe,0x71717874,0x71777775,0x881155f0,0xff3b5998,0x0134899c,0x71777776,0x12344321,0x99666666,0x7a786b21y0x71777778). En el mercado chino, 31 de las 100 apps llevan un canal de Walle o de VasDolly; con el par0x71717874y su textochannelId=…, 46 de 100 lo llevan en el bloque y, contando tambiénMETA-INF/y el comentario del ZIP, 48 de 100. Por canal: Walle (Meituan,0x71777777) 24 de 100; VasDolly (Tencent,0x881155ff) 7 de 100; algún identificador sin nombre (de los once, que incluyen el par0x71717874) 28 de 100. Fuera de allí casi no hay: Walle en 1 de las 658 apps de Google Play más instaladas, y ninguno en F-Droid, IzzyOnDroid, el sorteo ni webs de autores. El identificador sin nombre0xfa1cfabeestá en 35 de las 654 apps con bloque de las más instaladas de Google Play y en 23 de las 369 del sorteo. El comentario delEOCDlleva un canal en 4 piezas (una de F-Droid, una de IzzyOnDroid, una de Google Play y una del mercado chino). Ejemplos:cn.ninegame.gamemanager(360; Walle y0x71777778),com.mfw.roadbook(360; VasDolly) ycom.eslamegyp.asd26(sorteo,base.apk;0xfa1cfabe). - Protectores y empaquetadores comerciales. «Empaquetada» quiere decir, en todo el sitio, que
una heurística por nombres de ficheros y de clases ve un protector elegido por quien publica,
sin contar PairIP (la protección de Google Play, que va aparte). Son raros fuera del mercado
chino: 38 de las 100 apps de ese mercado (35 de 60 de la tienda 360 y 3 de 40 de las descargadas
a mano de Tencent), 12 de las 658 de Google Play más instaladas, 1 de las 369 del sorteo, y
ninguna de F-Droid ni de IzzyOnDroid. PairIP va aparte: 45 de 658 de las más instaladas y 99 de
369 del sorteo. Con APKiD 3.1.0, que citamos solo para el mercado chino, son 40 de las 98 apps
con salida de APKiD; las dos formas de contar coinciden en 93 de esas 98. Ejemplos:
com.cn21.ecloud(Ijiami), AppCloner Premium 4.0.0 (com.applisto.appcloner.premium, DexProtector) y Piccoma 8.6.0 (jp.kakao.piccoma, AppSealing).
Fíjate en el patrón: casi todo lo que no tiene spec es lo que Google nunca consideró una
interfaz pública. Y casi todo eso es justo lo que una herramienta de terceros necesita para
reescribir un APK.
Fuentes
Las URL de esta lista devolvieron HTTP 200 al comprobarlas con curl entre el 12 de agosto y el
31 de octubre de 2026, salvo donde se indica lo contrario; cada fuente dice qué día.
- Dalvik executable format — https://source.android.com/docs/core/runtime/dex-format
Consultado el 12 de agosto de 2026 («Last updated 2025-10-03 UTC») y de nuevo el 18 de
octubre de 2026 («Last updated 2026-10-09 UTC»). De aquí sale la ficha 4.1: la gramática de
SimpleNamecon sus anotaciones «since DEX version 040», las notas de versión con la de la 041 («experimental in the Android 16 release») y la sección «Container format». - Dalvik bytecode format — https://source.android.com/docs/core/runtime/dalvik-bytecode Consultado el 12 de agosto de 2026 («Last updated 2025-01-07 UTC») y de nuevo el 18 de octubre de 2026 («Last updated 2026-10-09 UTC»). Ficha 4.2.
- Dalvik executable instruction formats — https://source.android.com/docs/core/runtime/instruction-formats Consultado el 12 de agosto de 2026 («Last updated 2024-08-26 UTC») y de nuevo el 18 de octubre de 2026 («Last updated 2026-10-09 UTC»). Ficha 4.3.
- Application signing / APK signature schemes v2, v3, v3.1, v3.2 y v4 —
https://source.android.com/docs/security/features/apksigning ,
https://source.android.com/docs/security/features/apksigning/v2 ,
https://source.android.com/docs/security/features/apksigning/v3 ,
https://source.android.com/docs/security/features/apksigning/v3-1 ,
https://source.android.com/docs/security/features/apksigning/v3-2 ,
https://source.android.com/docs/security/features/apksigning/v4
Consultadas el 12 de agosto de 2026, salvo la de v3.2, consultada el 31 de octubre de 2026
(«Last updated 2026-09-30 UTC»). De aquí sale íntegra la «sección 5 · Google: la firma». La tabla de
identificadores de algoritmo de la página de v2 se releyó el 18 de octubre de 2026
(«Last updated 2026-09-30 UTC»):
0x0101y0x0102son RSASSA-PSS,0x0103y0x0104RSASSA-PKCS1-v1_5,0x0201y0x0202ECDSA y0x0301DSA (fila de RFC 8017 de la «sección 11 · Estándares externos: la criptografía»). - Formato del Android App Bundle — https://developer.android.com/guide/app-bundle/app-bundle-format Consultado el 12 de agosto de 2026. Ficha 6.1.
google/bundletool:commands.proto,config.proto,targeting.proto— https://raw.githubusercontent.com/google/bundletool/1.18.3/src/main/proto/commands.proto Consultado el 12 de agosto de 2026 enmaster; las tres URL de la ficha 6.2, fijadas en la etiqueta1.18.3, se comprobaron el 18 de octubre de 2026, y la API de GitHub da esa etiqueta como la última publicada, del 15 de diciembre de 2025. Ficha 6.2; la jerarquíaVariant→ApkSet→ApkDescriptionse toma de «AAB, splits y contenedores».frameworks/base/tools/aapt2/Resources.proto— https://android.googlesource.com/platform/frameworks/base/+/refs/tags/android-17.0.0_r1/tools/aapt2/Resources.proto Consultado el 25 de septiembre de 2026. Ficha 6.3.- bundletool, aapt2, d8, apksigner, zipalign, retrace, apkanalyzer — documentación de
producto — https://developer.android.com/tools/bundletool ,
https://developer.android.com/tools/aapt2 , https://developer.android.com/tools/d8 ,
https://developer.android.com/tools/apksigner , https://developer.android.com/tools/zipalign ,
https://developer.android.com/tools/retrace , https://developer.android.com/tools/apkanalyzer
Consultadas el 12 de agosto de 2026. De aquí sale íntegra la tabla de la ficha 7.1, y la
redirección de
/studio/command-line/apkanalyzerregistrada en la «sección 3 · Advertencia sobre developer.android.com». - Enable app optimization with R8 — https://developer.android.com/topic/performance/app-optimization/enable-app-optimization
Consultado el 12 de agosto de 2026. Ficha 7.2; se comprobó que
https://developer.android.com/build/shrink-coderedirige aquí. - R8:
compatibility-faq.mdydoc/retrace.md— https://r8.googlesource.com/r8/+/refs/tags/9.2.4-dev/compatibility-faq.md y https://r8.googlesource.com/r8/+/refs/tags/9.2.4-dev/doc/retrace.md Consultados el 12 de agosto de 2026 enmain; el 18 de octubre de 2026 se comprobó que las dos responden en la etiqueta9.2.4-devy que esa etiqueta apunta al commit084a89126ae0596c599143df57a654646af28313(«Version 9.2.4-dev», 26 de febrero de 2026). De aquí sale la afirmación de queretrace.mdes lo más parecido a una especificación demapping.txtque existe (ficha 7.2). - Páginas de plataforma y empaquetado de Android — las nueve URL de la tabla de la «sección 8 · Google: la plataforma y el empaquetado», consultadas el 12 de agosto de 2026; la de 16 KB se reconsultó el 31 de octubre de 2026 («Last updated 2026-10-16 UTC»). Su contenido concreto está desarrollado en «Código nativo y ELF», «Artefactos auxiliares de un APK» y «Alineación y zipalign».
- Target API level requirements for Google Play apps — https://developer.android.com/google/play/requirements/target-sdk Consultado el 12 de agosto de 2026, el 31 de octubre de 2026 y el 1 de noviembre de 2026 («Last updated 2026-10-28 UTC»). De aquí sale íntegra la tabla de la «sección 9 · Google Play: los requisitos que caducan cada año», con la fecha del 31 de agosto de 2026, y la prórroga que acabó el 1 de noviembre de 2026.
- APPNOTE.TXT — .ZIP File Format Specification, versión 6.3.10 — https://pkware.cachefly.net/webdocs/casestudies/APPNOTE.TXT Consultado el 12 de agosto de 2026. La versión, el estado FINAL y la fecha del 1 de noviembre de 2022 se leyeron de la cabecera del propio fichero. Se comprobó además que https://support.pkware.com/pkzip/appnote redirige a una página de producto y no sirve el documento.
- JAR File Specification y JEP 238 — https://docs.oracle.com/en/java/javase/21/docs/specs/jar/jar.html , https://docs.oracle.com/javase/8/docs/technotes/guides/jar/jar.html y https://openjdk.org/jeps/238 Consultadas el 12 de agosto de 2026. Ficha 10.2.
- RFC 1950, 1951, 2315, 3629, 5280, 5652, 7292 y 8017 — https://www.rfc-editor.org/rfc/rfc1950.html
y las siete homólogas. Consultadas el 12 de agosto de 2026. Los títulos, autores, fechas
y estados de la tabla de la «sección 11 · Estándares externos: la criptografía» y de las fichas 10.3 y 12.1 se leyeron de la
cabecera de cada RFC, no de fuentes secundarias. La RFC 1950 se releyó el 18 de octubre de 2026 en
https://www.rfc-editor.org/rfc/rfc1950.txt : Adler-32 se define en la descripción del
campo
ADLER32del apartado 2.2, «Data format»; el 8.2 es «The Adler-32 algorithm», dentro del apéndice de justificación, y el 9, «Appendix: Sample code» (ficha 10.3). - FIPS 180-4 — Secure Hash Standard — https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.180-4.pdf Consultado el 12 de agosto de 2026. Fila correspondiente de la tabla de la «sección 11 · Estándares externos: la criptografía». El 18 de octubre de 2026 se comprobó en la portada la fecha, agosto de 2015, y que la norma especifica también SHA-1.
- JVM Specification (Java SE 21) y The Unicode Standard — https://docs.oracle.com/javase/specs/jvms/se21/html/jvms-4.html
y https://www.unicode.org/versions/latest/
Consultadas el 12 de agosto de 2026. De aquí sale que la definición normativa de
MUTF-8es el apartado 4.4.7 de la spec de la JVM, y queversions/latest/redirigía aUnicode17.0.0; el 24 de septiembre de 2026 ya redirige aUnicode18.0.0(ficha 12.1). - DWARF Debugging Information Format, Version 5 — https://dwarfstd.org/doc/DWARF5.pdf
Consultado el 12 de agosto de 2026. El título y la fecha del 13 de febrero de 2017 se
leyeron de la portada del PDF descargado; la presencia de la definición de
LEB128se confirmó extrayendo el texto del PDF conpython3yzlib(188 apariciones del término). - Protocol Buffers — Encoding y Language Guide (proto 3) — https://protobuf.dev/programming-guides/encoding/ y https://protobuf.dev/programming-guides/proto3/ Consultadas el 12 de agosto de 2026. De aquí salen los seis wire types y la descripción de los varints de la ficha 12.3.
- System V ABI (gABI), capítulos 4 y 5 — https://refspecs.linuxfoundation.org/elf/gabi4+/contents.html Consultado el 12 de agosto de 2026. Ficha 12.4.
- ELF for the Arm 64-bit Architecture (AAELF64) — https://github.com/ARM-software/abi-aa/blob/main/aaelf64/aaelf64.rst
Consultado el 12 de agosto de 2026. Define
EM_AARCH64, que el borrador de la fuente 20 no tiene y el gABI mantenido sí (fuente 25). - fs-verity — documentación del kernel de Linux — https://docs.kernel.org/filesystems/fsverity.html Consultado el 12 de agosto de 2026. Ficha 12.5.
- Java Native Interface Specification — https://docs.oracle.com/en/java/javase/21/docs/specs/jni/index.html
y https://docs.oracle.com/javase/8/docs/technotes/guides/jni/spec/design.html
Consultadas el 12 de agosto de 2026. Ficha 12.6; se comprobó que
https://developer.android.com/training/articles/perf-jniredirige a/ndk/guides/jni-tips. developer.android.comysource.android.comsegún elUser-Agent— https://developer.android.com/tools/aapt2 y https://source.android.com/docs/core/runtime/constraints Comprobados el 18 de octubre de 2026 concurl; qué responden a cada tipo de cliente y cómo lo resuelve el comprobador de enlaces de esta documentación está en la «sección 8.3 de Bibliografía y comunidad · Procedimiento de revisión». De aquí sale la advertencia de la «sección 3 · Advertencia sobre developer.android.com».- System V ABI (gABI) mantenido, capítulo 4 — https://www.sco.com/developers/gabi/latest/ch4.eheader.html
Consultado el 24 de septiembre de 2026. Lista
EM_AARCH64 183(ficha 12.4). - Constraints — https://source.android.com/docs/core/runtime/constraints
Consultado el 18 de octubre de 2026 («Last updated 2026-10-09 UTC»). De aquí sale la ficha
4.5: las tres tablas
G1–G20,A1–A25yB1–B22, la frase «a runtime is required to support only valid .dex files» y las reglas que distinguen versiones delDEX. - FIPS 186-5 — Digital Signature Standard (DSS) — https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.186-5.pdf y https://csrc.nist.gov/pubs/fips/186-5/final Consultados el 18 de octubre de 2026. De la portada sale la fecha del 3 de febrero de 2023 y de la página del CSRC que sustituye a la FIPS 186-4; del apartado de alcance, que especifica RSA, ECDSA y EdDSA y que «The Digital Signature Algorithm (DSA) is no longer specified in this standard and may only be used to verify previously generated digital signatures», con remisión a la FIPS 186-4 (https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.186-4.pdf, que responde). Fila correspondiente de la tabla de la «sección 11 · Estándares externos: la criptografía».
- FIPS 204 — Module-Lattice-Based Digital Signature Standard — https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.204.pdf y https://csrc.nist.gov/pubs/fips/204/final Consultados el 18 de octubre de 2026. La fecha de publicación, 13 de agosto de 2024, sale de la portada; los nombres ML-DSA-44, ML-DSA-65 y ML-DSA-87 de los conjuntos de parámetros, del texto. Qué conjuntos admite v3.2 sale de «Esquemas de firma v1, v2, v3, v3.1 y v3.2 → §7 · v3.2: la firma híbrida». Fila correspondiente de la tabla de la «sección 11 · Estándares externos: la criptografía».
apksig,V1SchemeSigner.java, etiquetaandroid-17.0.0_r1— https://android.googlesource.com/platform/tools/apksig/+/refs/tags/android-17.0.0_r1/src/main/java/com/android/apksig/internal/apk/v1/V1SchemeSigner.java Consultado el 18 de octubre de 2026.getSuggestedSignatureDigestAlgorithmelige SHA-1 con clave RSA siminSdkVersiones menor que 18 y con clave DSA si es menor que 21; si no, SHA-256. De aquí sale la mención de SHA-1 en la fila de FIPS 180-4.- Internet Archive — copias anteriores de las cuatro páginas del runtime — https://web.archive.org/web/20260928054154/https://source.android.com/docs/core/runtime/dex-format , https://web.archive.org/web/20260930012233/https://source.android.com/docs/core/runtime/dalvik-bytecode , https://web.archive.org/web/20260923150559/https://source.android.com/docs/core/runtime/instruction-formats y https://web.archive.org/web/20260806194454/https://source.android.com/docs/core/runtime/constraints Consultadas el 18 de octubre de 2026. Llevan las marcas «Last updated 2025-10-03», «2025-01-07», «2024-08-26» y «2025-03-12 UTC»; el texto del cuerpo del artículo, sin etiquetas y con los espacios normalizados, tiene el mismo SHA-256 que el de la página de ese día en las cuatro. De aquí salen la nota de la «sección 13 · Qué revisión se está citando» y las fechas entre paréntesis de su tabla.
- Declare an aconfig flag y Set feature launch flag values —
https://source.android.com/docs/setup/build/feature-flagging/declare-flag y
https://source.android.com/docs/setup/build/feature-flagging/set-values
Consultadas el 18 de octubre de 2026 («Last updated 2026-06-17 UTC» y «2026-08-12 UTC»). De
la primera sale la clase generada
foo.bar.Flags; de la segunda, los estados y permisos de un fichero de valores, el valor por defectoREAD_WRITEyDISABLED, y la definición de release configuration que cita la ficha 4.6. min_target_sdk_24en AOSP, etiquetaandroid-17.0.0_r1— https://android.googlesource.com/platform/frameworks/base/+/refs/tags/android-17.0.0_r1/services/core/java/com/android/server/pm/PackageManagerService.java#576 , https://android.googlesource.com/platform/frameworks/base/+/refs/tags/android-17.0.0_r1/core/java/android/content/pm/flags.aconfig#191 y https://android.googlesource.com/platform/build/release/+/refs/tags/android-17.0.0_r1/aconfig/bp1a/android.content.pm/min_target_sdk_24_flag_values.textproto Consultados el 18 de octubre de 2026 con?format=TEXT, junto con el mismo fichero de valores enaconfig/ap4a/, la ausencia de fichero enaconfig/bp2a/,bp3a/,bp4a/ycp1a/, y las líneasinheritsderelease_configs/cp1a.textprotoy de las que hereda. Ficha 4.6.- ECMA-335 — Common Language Infrastructure (CLI) — https://ecma-international.org/publications-and-standards/standards/ecma-335/ Consultado el 31 de octubre de 2026. La página da la 6.ª edición, de junio de 2012, y la partición III como el juego de instrucciones CIL. Ficha 12.7.
- «El muestrario» — descargado entre el 19 y el 27 de octubre de 2026.
De aquí salen las cifras de las notas «En la práctica» de las «secciones 4 · Google: el código y el runtime» a 14, calculadas con
los scripts de
scripts/muestrario/cifras/. Cada lote se repite conMUESTRARIO_RAIZ=<carpeta del muestrario> python3 -I scripts/muestrario/cifras/<lote>.py --salida <fichero.json>.