τTau SolutionsReferencias y anexos

Especificaciones oficiales

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

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 APK no tienen especificación publicada. Es el caso de 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— y del XML binario (AXML), la forma compacta en que viajan el AndroidManifest.xml y 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 hace ResourceTypes.cpp al 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.com que 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:

  1. 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.
  2. 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-code lleva ahora a /topic/performance/app-optimization/enable-app-optimization, y /training/articles/perf-jni a /ndk/guides/jni-tips. Las rutas viejas redirigen, hoy.
  3. Discrimina por User-Agent. A un cliente que se presenta como navegador lo manda a accounts.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 (los APK parciales 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+Wallpaper 36.0 (APKPure, .apk suelto): v2, v3, sello y relleno.
  • Calculator 9.3 (com.google.android.calculator, .apkm de 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 único APK fuera 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

https://android.googlesource.com/platform/frameworks/base/+/refs/tags/android-17.0.0_r1/tools/aapt2/Resources.proto

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 un ZIP con un info.json (versión, arquitecturas, densidades, idiomas, min_api), un icon.png, un APKM_installer.url y los APK, y lo firma APKMirror (META-INF/APKMIRRO.RSA). Los 388 del muestrario siguen esa estructura, con 7.288 piezas. Un .apkm trae de 1 a 125 APK (mediana 12).
  • .xapk (APKPure y APKCombo). Es un ZIP con un manifest.json (package_name, version_code, min_sdk_version, permissions, split_apks…) y los APK, sin firma exterior. Los 72 del muestrario (71 de APKPure y 1 de APKCombo) siguen esa estructura, con 450 piezas; traen de 2 a 22 APK (mediana 3).
  • Carpeta de adb pull. No es un fichero: son los APK que el teléfono tiene instalados (base.apk y los splits que ese teléfono necesita). Tenemos 365 carpetas con 1.225 APK. Los splits de arquitectura son todos arm64_v8a (en unas tres de cada cuatro carpetas) y los de densidad, todos xxhdpi (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 .apkm más pequeño: com.callapp.contacts 2.150W (1.003.422 B).
  • El .xapk más pequeño: una app rusa de multas de tráfico de APKPure, versión 6.10 (12.735.503 B).
  • Un .apkm con un .obb dentro: Plants vs. Zombies 2 (com.ea.game.pvz2_row) 13.5.1.
  • Un asset pack dentro de un .xapk: AssetPackMain.apk de Call of Duty Mobile 1.0.57 (APKPure).
  • Una carpeta de adb con 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 .so de arm64-v8a, en todas las piezas, con todos sus segmentos LOAD a p_align de 16.384 o más y, si se cargan desde el APK, además alineadas en el ZIP. Así cumplen unas 8 de cada 10 apps de F-Droid con código nativo en arm64-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 tienen targetSdkVersion 35 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 un p_align por debajo de 16 KiB, 4 por la alineación en el ZIP y 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 el ZIP bien. Así cumplen 2.096 de las 2.689 de F-Droid y, con targetSdkVersion 35 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 su p_align sea correcto. Ejemplos, todos en un .apkm de APKMirror, en split_config.arm64_v8a.apk: Photomath 8.48.0 (5 .so con p_align de 4.096), ShareIt Lite 3.9.38 (p_align correcto, pero el cargador entra en compatibilidad por RELRO en 2 de 16 .so) y Google Play Kiosco 5.168.0 (compatible del todo).

  • extractNativeLibs. Con extractNativeLibs="false" Android carga las .so directamente del APK, 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 .so comprimida. Cuando el atributo falta, vale true y la app lleva casi siempre las .so comprimidas: 247 de las 250 apps de F-Droid con el atributo ausente y minSdkVersion menor que 23. Lo que decide el valor es el minSdkVersion: con 23 o más, 1.854 de 2.133 apps de F-Droid escriben false; con menos de 23, solo 9 de 576. No podemos distinguir un false que puso el plugin de Gradle de uno que puso el desarrollador. Ejemplos: Facebook Lite 534.0.0.7.108 (atributo ausente, minSdkVersion 23 y 2 .so comprimidas) y UserLAnd (tech.ula, true explícito y 8 de 116 .so stored).

  • ABI. arm64-v8a es 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-v7a está en 2.071 de las 2.709 de F-Droid y x86_64 en 1.982. Las ABI que el NDK r17 retiró (armeabi, mips y mips64) siguen en 63 de las 2.709 de F-Droid (en torno al 2 %) y en 9 de las 615 de Google Play. Dos APK llevan riscv64, uno de F-Droid y otro de IzzyOnDroid. Cuidado con el sorteo de Google Play: sus carpetas de adb salen de un móvil arm64-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, con armeabi, mips y mips64 junto a las ABI vigentes).

  • Android 11. Exige que el resources.arsc de las apps con targetSdkVersion 30 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 es dudeofx.eval (F-Droid, targetSdkVersion 36): lleva el resources.arsc sin 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 ese APK.

  • 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 un baseline.profm. Ejemplo: org.fossify.math (F-Droid; baseline.prof de 384 B y baseline.profm de 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 .symtab 1.893 de 30.284 .so de 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:

  1. La especificación mete en el manifiesto los ficheros de los subdirectorios de META-INF/ y los de META-INF/ que no son de firma; Android no exige digest de nada bajo META-INF/.
  2. El .SF de Android lleva la cabecera X-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: 0x0103 21.270, 0x0104 5.872, 0x0421 (verity) 1.861, DSA 0x0301 913 y 0x0425 5, ECDSA 0x0201 11 y 0x0202 6, y 0x9901 2 (un identificador que ninguna fuente de esta sección nombra). Un firmante con verity cuenta en dos identificadores. «Lo habitual» se confirma por app: 0x0103 está 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; 0x0421 junto a 0x0103) y rsquared226.budget_my_life (IzzyOnDroid; el firmante v2 lista 0x0103 y 0x9901).
  • 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 y minSdkVersion menor que 18 (5.299 con RSA y 263 con DSA; un minSdkVersion sin declarar cuenta como 1) llevan todas digests SHA-1. Se apartan 143 piezas con v1, todas con RSA y SHA-1 pese a tener minSdkVersion de 18 o más (46 con 18–20 y 97 con 21 o más). Casi todas las firmó jarsigner (133; 6 son de apksigner, 3 de SignApk y 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 con minSdkVersion de 18 o más, firmada con jarsigner).
  • 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) y zatrit.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) y com.netvor.settings.database.provider (clave DSA).
  • ML-DSA (FIPS 204). 0x0501 aparece 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. apksigner con 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.Antistress 11.4.3): Unity.
  • com.cn21.ecloud (360): Flutter, protegida con Ijiami.
  • Housing (15.2.3, APKPure): React Native.
  • com.ovz.carscanner 2.2.21: Xamarin / .NET para Android.
  • com.natenai.glowhockey 1.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ún META-INF/*.kotlin_module en 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 el DEX hay 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_module 9 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, con META-INF/*.kotlin_module).
  • FLAG_SPARSE, FLAG_OFFSET16 y FLAG_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 lleva FLAG_OFFSET16 ni FLAG_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, 0x7a786b21 y 0x71777778). En el mercado chino, 31 de las 100 apps llevan un canal de Walle o de VasDolly; con el par 0x71717874 y su texto channelId=…, 46 de 100 lo llevan en el bloque y, contando también META-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 par 0x71717874) 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 nombre 0xfa1cfabe está 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 del EOCD lleva 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 y 0x71777778), com.mfw.roadbook (360; VasDolly) y com.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.

  1. 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 SimpleName con 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».
  2. 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.
  3. 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.
  4. 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»): 0x0101 y 0x0102 son RSASSA-PSS, 0x0103 y 0x0104 RSASSA-PKCS1-v1_5, 0x0201 y 0x0202 ECDSA y 0x0301 DSA (fila de RFC 8017 de la «sección 11 · Estándares externos: la criptografía»).
  5. 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.
  6. 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 en master; las tres URL de la ficha 6.2, fijadas en la etiqueta 1.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ía Variant → ApkSet → ApkDescription se toma de «AAB, splits y contenedores».
  7. 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.
  8. 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/apkanalyzer registrada en la «sección 3 · Advertencia sobre developer.android.com».
  9. 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-code redirige aquí.
  10. R8: compatibility-faq.md y doc/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 en main; el 18 de octubre de 2026 se comprobó que las dos responden en la etiqueta 9.2.4-dev y que esa etiqueta apunta al commit 084a89126ae0596c599143df57a654646af28313 («Version 9.2.4-dev», 26 de febrero de 2026). De aquí sale la afirmación de que retrace.md es lo más parecido a una especificación de mapping.txt que existe (ficha 7.2).
  11. 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».
  12. 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.
  13. 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.
  14. 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.
  15. 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 ADLER32 del 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).
  16. 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.
  17. 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-8 es el apartado 4.4.7 de la spec de la JVM, y que versions/latest/ redirigía a Unicode17.0.0; el 24 de septiembre de 2026 ya redirige a Unicode18.0.0 (ficha 12.1).
  18. 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 LEB128 se confirmó extrayendo el texto del PDF con python3 y zlib (188 apariciones del término).
  19. 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.
  20. 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.
  21. 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).
  22. 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.
  23. 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-jni redirige a /ndk/guides/jni-tips.
  24. developer.android.com y source.android.com según el User-Agent — https://developer.android.com/tools/aapt2 y https://source.android.com/docs/core/runtime/constraints Comprobados el 18 de octubre de 2026 con curl; 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».
  25. 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).
  26. 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–A25 y B1–B22, la frase «a runtime is required to support only valid .dex files» y las reglas que distinguen versiones del DEX.
  27. 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».
  28. 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».
  29. apksig, V1SchemeSigner.java, etiqueta 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/internal/apk/v1/V1SchemeSigner.java Consultado el 18 de octubre de 2026. getSuggestedSignatureDigestAlgorithm elige SHA-1 con clave RSA si minSdkVersion es 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.
  30. 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.
  31. 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 defecto READ_WRITE y DISABLED, y la definición de release configuration que cita la ficha 4.6.
  32. min_target_sdk_24 en AOSP, etiqueta android-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 en aconfig/ap4a/, la ausencia de fichero en aconfig/bp2a/, bp3a/, bp4a/ y cp1a/, y las líneas inherits de release_configs/cp1a.textproto y de las que hereda. Ficha 4.6.
  33. 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.
  34. «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 con MUESTRARIO_RAIZ=<carpeta del muestrario> python3 -I scripts/muestrario/cifras/<lote>.py --salida <fichero.json>.