τTau SolutionsOfuscación

R8 y ProGuard

Antes conviene leer «Anatomía de un APK», «Formato DEX»

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

1. Qué es y por qué existe

La mayor parte del código ofuscado que vas a encontrar dentro de un APK no lo ofuscó nadie a propósito: lo ofuscó la cadena de compilación oficial de Android, porque el desarrollador puso minifyEnabled = true para que la app ocupase menos. R8 es la herramienta de Google que hace ese trabajo, y desde el plugin de Gradle 3.4.0 viene activada por defecto.

Por eso R8 es el punto de partida de este bloque. No es un producto de seguridad ni lo pretende: es un reductor de tamaño cuyo efecto secundario —renombrar todo lo que puede a a, b, c— acaba siendo la barrera de análisis más extendida del ecosistema. Un ofuscador comercial como DexGuard («Ofuscadores comerciales») empieza donde R8 termina.

El muestrario lo confirma. Llamamos «ofuscada» a una app con al menos la mitad de sus nombres de uno a tres caracteres (la definición completa está en «El muestrario»). Casi todas las ofuscadas de F-Droid e IzzyOnDroid llevan el marcador propio de R8, la firma que deja dentro del DEX («sección 9.1 · El marcador ~~R8{…} dentro del DEX»): 2.020 de 2.045 en F-Droid y 690 de 700 en IzzyOnDroid. En el sorteo de Google Play son 128 de 138. En las más instaladas baja a dos de cada tres (184 de 271). En el mercado chino la muestra es pequeña: 6 de 13.

¿Y las 87 ofuscadas de las más instaladas que no lo llevan? Casi todas son de Google: 65, una de cada cuatro de las 271. Google compila con su cadena interna, cuyo marcador es un ~~D8 de desarrollo. Calculator 9.3 lo enseña bien: su classes.dex lleva ~~D8 9.3.16-dev y SourceFile PG, y el ~~R8 solo aparece en classes3.dex, junto a un ~~L8. En las otras tres fuentes de tiendas no hay ninguna app de Google ofuscada sin ese marcador.

Sobre esas 271 ofuscadas, APKiD (un programa que reconoce protectores y empaquetadores por sus huellas) ve un protector en 21, en torno al 8 %. Y 15 de las 21 llevan además R8 propio. En F-Droid e IzzyOnDroid no ve ninguno.

¿Es de verdad la barrera más extendida? Sí, si cuentas el renombrado total y el parcial (el 20 % o más de los nombres con uno a tres caracteres). La tabla pone cada barrera en su sitio:

Ojo, los denominadores no son iguales. El renombrado cuenta las apps medibles (con al menos 200 identificadores); las otras tres filas, todas las apps del estrato.

Barrera F-Droid IzzyOnDroid Google Play, más instaladas Google Play, sorteo Mercado chino
Renombrado total o parcial 48 % (2.221 de 4.668) 56 % (754 de 1.348) 87 % (569 de 657) 72 % (267 de 369) 51 de 78
Lógica fuera del DEX 17 % (814 de 4.766) 16 % (222 de 1.402) 36 % (236 de 658) 60 % (222 de 369) 67 de 100
Empaquetador o protector, sin PairIP 0 de 4.766 0 de 1.402 2 % (12 de 658) 1 de 369 38 de 100
PairIP 0 de 4.766 0 de 1.402 7 % (45 de 658) 27 % (99 de 369) 0 de 100

El renombrado es la barrera más frecuente en F-Droid, IzzyOnDroid y las dos listas de Google Play. Si solo cuentas la ofuscación casi completa, el sorteo de Google Play se da la vuelta: 138 de 369 apps renombradas (37 %) frente a 222 de 369 con la lógica fuera del DEX (60 %). En el mercado chino manda otra barrera: 67 de 100 apps con la lógica fuera del DEX y 38 de 100 empaquetadas, frente a 51 de las 78 medibles con algún renombrado. El cifrado de cadenas no lo hemos medido.

Todo esto es reversible si tienes mapping.txt. R8 lo emite en cada compilación, con la correspondencia exacta entre cada nombre original y el ofuscado. Con él, deshacer la ofuscación es una sustitución determinista sin riesgo; sin él hay que inferir, y ahí el techo es bajo («Deofuscación»). Por eso lo más útil de esta página es la «sección 6 · mapping.txt: la gramática exacta»: fija la gramática de ese fichero con detalle suficiente para escribir un lector.

Nos quedamos del lado de la identificación: qué hace R8, qué formato produce y cómo reconocer, desde un APK ya construido, que pasó por ahí. La «sección 10 · Medición propia: la fracción de identificadores cortos» mide todo esto sobre el «muestrario».

Versiones de referencia: R8 9.2.4-dev (build-tools 37.0.0), Retrace 8.9.27, ProGuard 7.9.1 y AGP hasta la 9.4.1, consultadas en agosto y septiembre de 2026. Los ejemplos de las secciones «6», «7», «9.1» y «11» salen de ejecuciones del 18 de octubre de 2026.

2. Historia y relevo

ProGuard empezó como proyecto personal de Eric Lafortune: su primer commit es del 1 de mayo de 2002. Lo que le dio escala fue Google, al incluirlo en el SDK con Android 2.3 Gingerbread; en diciembre de 2010 ya rondaba el medio millón de descargas. En 2012 nace DexGuard, su hermano comercial, y en 2014 se funda Guardsquare, la empresa belga que hoy mantiene los dos.

ProGuard sigue vivo y es software libre bajo GPL-2.0 con excepciones. La versión más reciente es la v7.10.0, del 24 de agosto de 2026; la de las ejecuciones de este documento, la v7.9.1, del 9 de abril. Según su manual, hace cuatro pasos: shrinking, optimization, obfuscation y preverification.

ProGuard trabaja sobre bytecode de la JVM: entra .class y sale .class. Por eso la cadena antigua de Android tenía que encadenar javac → ProGuard → dx. Google lo juntó todo en dos herramientas nuevas que comparten repositorio y código:

Herramienta Entrada Salida Qué hace
D8 .class DEX Traduce y desugariza. Sustituye a dx. No renombra nada
R8 .class DEX Todo lo de D8 más shrinking, optimización y ofuscación. Sustituye a ProGuard + dx
L8 .class DEX/.class Compila la biblioteca del núcleo reescrita del core library desugaring

R8 llegó en tres pasos. En el plugin de Gradle 3.2.0 era una vista previa que había que pedir con android.enableR8=true. En la 3.3.0 sustituía a ProGuard en los tipos de build con useProguard false. Y en la 3.4.0 quedó activado por defecto, para módulos de aplicación y de biblioteca. La documentación de esa versión lo resume sin rodeos: antes, «ProGuard era un paso de compilación distinto del dexing y del desugaring»; ahora es uno solo.

Qué queda de ProGuard hoy, en la práctica:

  • El formato de configuración. Las keep rules de R8 son sintaxis de ProGuard, y los ficheros se siguen llamando proguard-rules.pro.
  • El formato de mapping.txt. R8 produce un superconjunto compatible («sección 6 · mapping.txt: la gramática exacta»).
  • La cadena PG en el atributo SourceFile («sección 9.2 · El atributo SourceFile»), que R8 trata igual que el valor por defecto aunque ProGuard no la escriba salvo que se le pida con -renamesourcefileattribute PG.
  • Quien sigue usándolo. Proyectos antiguos y builds no-Android que invocan ProGuard directamente. Proyectos Android con el plugin de Gradle com.guardsquare.proguard, que Guardsquare publica desde ProGuard 7.1 porque AGP 7 ya no deja desactivar R8 con android.enableR8: se apaga la minificación de AGP y el plugin ejecuta ProGuard (su manual lo documenta para AGP 4.x a 7.x). Y DexGuard, que es «compatible hacia atrás con ProGuard» y reutiliza su configuración.

Un marcador ~~R8 dentro del DEX («sección 9.1 · El marcador ~~R8{…} dentro del DEX») prueba que la app pasó por R8. Lo llevan el 60 % de las apps de F-Droid (2.861 de 4.765), el 69 % de IzzyOnDroid, el 85 % de las más instaladas de Google Play, el 71 % del sorteo y 30 de las 100 del mercado chino. Esa cuenta incluye los marcadores que R8 copia de las bibliotecas. Si solo cuentas los propios de la app, bajan al 58 % en F-Droid (2.763 de 4.765) y al 62 % en las más instaladas (409 de 658).

ProGuard no deja marcador, así que desde el binario no puedes probar que una app pasó por él. Lo que sí hay son candidatas: apps ofuscadas sin marcador propio de R8 y sin otra explicación (un protector, Redex, un marco que saca la lógica del DEX, o ser de Google, mirado en ese orden). Son pocas. Sin contar las de Google: 25 de 4.668 en F-Droid (0,5 %), 10 de 1.348 en IzzyOnDroid, 2 de 369 en el sorteo y 3 de 657 en las más instaladas. Si cuentas las de Google, las más instaladas suben a 66 de 657, una de cada diez, y 63 son de Google. Los denominadores son las apps medibles (con al menos 200 identificadores). En el mercado chino, 20 de 100 apps traen clases con SourceFile «ProGuard» («sección 9.2 · El atributo SourceFile»), y 17 de ellas están entre las 72 sin R8 propio. Ejemplos, todos del muestrario:

  • Candidata en F-Droid, sin marcador y con DEX 035 (el formato anterior a D8), con el 58 % de los nombres de uno a tres caracteres: com.davidshewitt.admincontrol 5.
  • Candidata en F-Droid con D8 1.3.49 y DEX 035, 58 %: com.gbeatty.arxiv 39.
  • Mercado chino, 1.970 clases con SourceFile «ProGuard» y sin marcador: com.tencent.tmgp.cod 3153.
  • Mercado chino, sin marcador, DEX 038, 70 %: com.baidu.searchbox 513934592.

3. Los tres trabajos, que no son el mismo

minifyEnabled = true enciende tres transformaciones distintas a la vez. Se confunden constantemente, y separarlas importa porque solo una de las tres es la que mapping.txt deshace.

.classlibreríaskeep rules1. SHRINKING(tree shaking)elimina loinalcanzabledesde los entrypoints2.OPTIMIZACIÓNinlining, fusiónde clasespropagación deconstantes3. OFUSCACIÓN(minification)renombra lo quequeda a a, b, c…classes.dexmapping.txt

1. Shrinking. «R8 identifica y elimina el código inalcanzable de la aplicación y de sus dependencias. Analizando los entry points de la aplicación (como las Activities o los Services declarados en el manifiesto), R8 construye un grafo del código referenciado y elimina todo lo que quede sin referenciar». Lo eliminado se lista en usage.txt.

2. Optimización. Las dos técnicas que la documentación nombra son method inlining —«R8 sustituye el punto de llamada por el cuerpo del método llamado»— y class merging —«R8 combina conjuntos de clases e interfaces en una sola clase»—. A eso se añaden propagación de constantes, eliminación de argumentos sin uso y outlining («sección 6.6 · Los comentarios de metadatos por elemento»). Desde AGP 8.12.0, R8 puede optimizar además los recursos —en 8.12 y 8.13 hay que pedirlo con android.r8.optimizedResourceShrinking=true—, y desde AGP 9.0 lo hace por defecto (la propiedad pasa a true).

Esa optimización deja huella en resources.arsc, la tabla de recursos de la app («Tabla de recursos ARSC»): los nombres de los recursos se sustituyen por una cadena fija o por el número de identificador. Es raro. Donde más se ve es en las más instaladas de Google Play, y aun así solo en 16 de 658 (2 %). En el resto: 1 de 4.766 en F-Droid, 5 de 1.401 en IzzyOnDroid, ninguna del sorteo, 1 de 100 en el mercado chino y 2 de 7 en las webs de autores.

Hay tres esquemas:

  • 0_resource_name_obfuscated: la opción --collapse-resource-names de aapt2, la herramienta de Google que empaqueta los recursos. 12 apps, entre ellas Chrome 155.
  • (name removed): Redex. 8 apps, entre ellas WhatsApp.
  • El identificador en decimal: 5 apps, entre ellas Netflix 9.88.0.

No podemos probar que el primer esquema venga de la optimización de R8 y no de un aapt2 invocado a mano, y no hemos medido AndResGuard, otra herramienta que renombra recursos. Ejemplos:

  • Chrome 155, con 18.700 nombres «0_resource_name_obfuscated».
  • WhatsApp 2.26.42.9, con 41.086 nombres «(name removed)».
  • Netflix 9.88.0, con 13.145 nombres con el identificador en decimal.

3. Ofuscación. «Para reducir el tamaño del fichero DEX, R8 acorta los nombres de clases, campos y métodos (por ejemplo, com.example.MyActivity podría convertirse en a.b.a)». Es un efecto de tamaño, no de seguridad: los nombres viven en string_ids («Formato DEX → §6 · Las tablas de índices») y acortarlos ahorra bytes.

Por qué la optimización estorba al decompilador tanto o más que el renombrado. Un nombre renombrado sigue siendo un nombre: el decompilador produce código correcto y feo, y el lector puede renombrar mentalmente. La optimización destruye la correspondencia entre el fuente y el binario: un método inlineado ya no existe como método, y su cuerpo aparece repetido dentro de cada llamador; dos clases fusionadas aparecen como una, con métodos que solo tienen sentido para la mitad del objeto; una constante propagada borra el parámetro que la transportaba; y el outlining hace lo contrario, inventa un método que no estaba en el fuente y lo llama desde sitios que no tenían relación.

mapping.txt recupera los nombres y, gracias a los rangos de línea, también la pila de llamadas original de un método inlineado («sección 6.5 · Métodos inlineados»). Lo que no recupera es la forma del código: el DEX sigue teniendo el cuerpo repetido. Esa asimetría es el motivo de que retrace funcione perfectamente sobre una traza de pila y de que deofuscar un proyecto decompilado sea otro problema.

Cada pieza se puede pedir por separado: -dontobfuscate deja shrinking y optimización, -dontoptimize deja shrinking y renombrado, -dontshrink deja los otros dos. Y se nota en APK reales: hay apps con marcador de R8 y casi ningún nombre corto, es decir, R8 sin ofuscación. Entre las apps con R8 propio, no renombran (menos del 20 % de sus nombres con uno a tres caracteres) una de cada cinco en F-Droid (543 de 2.722), 144 de 886 en IzzyOnDroid, el 13 % en las más instaladas de Google Play (53 de 409) y 4 de 158 en el sorteo. En el mercado chino, 4 de 28. Tres ejemplos:

  • LinkedIn 4.1.1264, con R8 9.2.37: su classes.dex define 83.498 identificadores, el 7,5 % con uno a tres caracteres, con mediana de longitud 12 y SourceFile «SourceFile» (con todos sus DEX: 5,0 % y mediana 13).
  • Termux 1022, con R8 2.2.71 en modo de compatibilidad.
  • Candy Crush Saga solo se parece a ese perfil en su classes.dex (3,8 % de nombres cortos, mediana 16, 2.595 valores distintos de SourceFile). Con sus 5 DEX sube al 29,9 % y la app es «parcial», así que no vale como ejemplo de «sin ofuscar».

4. Cómo se enciende y dónde viven las reglas

La forma clásica, todavía la mayoritaria, y la DSL nueva de AGP 9.3, que enciende las dos cosas de golpe y ya incluye las reglas por defecto de la plataforma:

buildTypes { release {                       buildTypes { release {
    isMinifyEnabled = true                       optimization { enable = true }
    isShrinkResources = true                 } }
    proguardFiles(
        getDefaultProguardFile("proguard-android-optimize.txt"),
        "proguard-rules.pro")
} }

Con la DSL nueva, las reglas van en ficheros con sufijo .keep dentro del source set src/<variant>/keepRules, por ejemplo src/main/keepRules/custom-rules.keep.

La forma clásica sigue siendo la mayoritaria. Desde el binario no se ve cómo se configuró el proyecto, pero sí se puede poner un límite superior. AGP deja su versión en META-INF/com/android/build/gradle/app-metadata.properties, un fichero que llevan casi todas las apps: el 86 % en F-Droid (4.102 de 4.766), el 91 % en IzzyOnDroid, el 83 % en las más instaladas de Google Play y el 96 % en el sorteo.

Entre las que lo llevan, menos de una de cada cinco se compiló con AGP 9.3 o posterior, el primero que admite la DSL nueva: 732 de 4.100 en F-Droid (18 %), 243 de 1.266 en IzzyOnDroid (19 %), 55 de 543 en las más instaladas (10 %), 9 de 354 en el sorteo, ninguna de las 68 del mercado chino y 1 de 4 en las webs de autores. Un AGP 9.3 no obliga a usar la DSL nueva, así que son cotas superiores.

Dónde caen los ficheros de salida. mapping.txt se escribe en app/build/outputs/mapping/<variante>/mapping.txt y, además, AGP lo empaqueta automáticamente dentro del AAB, como BUNDLE-METADATA/com.android.tools.build.obfuscation/proguard.map («AAB, splits y contenedores → §2.1 · Estructura interna»). La documentación advierte de lo importante: «el fichero de mapping se sobrescribe cada vez que se compila el proyecto, así que hay que guardar una copia cada vez que se publica una release».

Si esperabas encontrar alguno olvidado dentro de un APK, no hay suerte. Ninguna de las 15.183 piezas del muestrario lleva mapping.txt, proguard.map, seeds.txt, usage.txt, configuration.txt, resources.map ni una carpeta BUNDLE-METADATA/. Miramos los nombres de las entradas de todas las piezas: APK sueltos, base y splits de los contenedores y carpetas de adb. Lo que no podemos comprobar es el contenido de un AAB, porque no tenemos ninguno.

Junto a mapping.txt aparecen seeds.txt —lo que las reglas impidieron eliminar—, usage.txt —lo eliminado— y configuration.txt —«todas las reglas fusionadas de cada biblioteca y módulo que se usaron para configurar R8»—.

La ruta real lleva segmento de variante: app/build/outputs/mapping/<variante>/configuration.txt, en el mismo directorio que seeds.txt y usage.txt. Lo dicen las notas de AGP 9.0.0 («typically in a path like <app_module>/build/outputs/mapping/<build_variant>/configuration.txt») y lo confirma el código de AGP: InternalArtifactType.R8_MAPPING_CONFIGURATION se declara con categoría OUTPUTS, carpeta mapping y fichero configuration.txt, y getOutputPath() intercala la variante entre la carpeta y el fichero (platform/tools/base, etiqueta studio-2026.1.2). Las otras dos páginas oficiales fallan cada una en un detalle: la de diagnóstico omite la variante (./app/build/outputs/mapping/configuration.txt) y la del APK Analyzer escribe mappings en plural.

5. Keep rules

Una keep rule le dice a R8 qué no puede tocar. Las opciones se dividen en tres ejes que se combinan: qué se conserva (la clase, sus miembros, o ambos), si además se conserva el nombre, y si se permite optimizar por dentro.

Opción Conserva la clase Conserva los miembros Se aplica cuando
-keep Sí Los que se especifiquen Siempre
-keepclassmembers No por sí sola Sí Si la clase se conserva por otra vía
-keepclasseswithmembers Sí Sí Si la clase tiene esos miembros
-keepnames Solo el nombre — La clase puede eliminarse; si sobrevive, no se renombra
-keepclassmembernames — Solo el nombre Ídem para miembros
-keepclasseswithmembernames Solo el nombre Solo el nombre La usa la regla estándar de métodos nativos

Modificadores entre corchetes tras la opción: allowshrinking, allowoptimization, allowobfuscation, allowaccessmodification, allowrepackage, includedescriptorclasses. Comodines: * (un segmento), ** (varios, incluidos puntos), ? (un carácter), *** (cualquier tipo), ... (cualquier lista de argumentos), % (cualquier primitivo). Existen reglas condicionales -if … -keep … con retrorreferencias <1>, <2>.

Ojo con un detalle que depende de la versión: si una regla -keep no especifica miembros, R8 la convierte implícitamente en una que conserva el constructor por defecto. Así funciona R8 cuando se usa solo y con AGP hasta la 8.x. Desde AGP 9.0, android.r8.strictFullModeForKeepRules vale true y «-keep class A no longer implies -keep class A { <init>(); }» (notas de AGP 9.0.0): el constructor hay que pedirlo expresamente.

5.1 Los ficheros y su procedencia

Fichero Quién lo pone Qué contiene
proguard-android-optimize.txt AGP, vía getDefaultProguardFile() Reglas base de la plataforma
proguard-rules.pro El desarrollador Las reglas propias del módulo
consumer-rules.pro La biblioteca, vía consumerProguardFiles Reglas que la biblioteca impone a quien la usa
META-INF/proguard/* Un JAR de biblioteca Equivalente al anterior para artefactos JAR
(generado) AAPT2, o R8 con la reducción optimizada de recursos Reglas derivadas de los componentes del manifiesto

La distinción entre proguardFiles y consumerProguardFiles está bien enunciada en la documentación de Google: los primeros «se usan en tiempo de compilación para definir qué parte de tu biblioteca debe conservarse durante la compilación de la biblioteca — como mínimo, su API pública»; los segundos «se empaquetan dentro de la biblioteca para afectar a qué optimizaciones ocurren después, durante la compilación de la aplicación que la consume». Consecuencia práctica para quien analiza: buena parte de las reglas que gobiernan una aplicación no las escribió su autor, vinieron dentro de sus dependencias.

Desde AGP 9.0, publicar una biblioteca falla si sus consumer rules llevan opciones globales como -dontoptimize o -dontobfuscate, y la aplicación ignora en silencio las que lleguen dentro de un JAR o AAR ya compilado (notas de AGP 9.0.0, android.r8.globalOptionsInConsumerRules.disallowed).

El mecanismo tiene dos formas, según cómo se reduzcan los recursos. En la clásica, AAPT2 escribe las reglas al enlazar (aapt2 link --proguard) y AGP se las pasa a R8: es el aapt_rules.txt de build/intermediates/aapt_proguard_file/, que la página oficial de diagnóstico cita entre los orígenes de reglas («rules generated by AAPT») con una MainActivity conservada desde …/processReleaseResources/aapt_rules.txt:4:1. Reproducido con el aapt2 de build-tools 37.0.0 sobre un manifiesto mínimo, sale una regla por componente con su línea de origen: # Referenced at AndroidManifest.xml:5 seguido de -keep class com.ejemplo.demo.MainActivity { <init>(); }. Con la reducción optimizada de recursos —por defecto desde AGP 9.0 cuando isShrinkResources = true— esas reglas no llegan a R8: AGP deja de pasarlas («R8's optimized shrinking does not need AAPT2-generated Proguard rules», ProguardConfigurableTask.kt) y es R8 quien lee el manifiesto compilado y traza los android:name de activity, service, receiver, provider, instrumentation, process y application, y en application también los atributos backupAgent, appComponentFactory y zygotePreloadName, que nombran clases (SPECIAL_APPLICATION_ATTRIBUTES en ResourceShrinkerState.java).

5.2 Las reglas que AGP empaqueta de verdad

Desde AGP 2.2 los ficheros de $ANDROID_HOME «ya no se mantienen y serán ignorados»; lo que getDefaultProguardFile() desempaqueta son tres ficheros que viven en el propio plugin: proguard-header.txt (solo comentarios), proguard-optimizations.txt (una única línea, -allowaccessmodification) y proguard-common.txt, que es el interesante. Estas son todas sus reglas -keep* y -keepattributes, cada una en una línea; el fichero lleva además comentarios y reglas -dontnote y -dontwarn, que aquí se omiten:

-keepattributes AnnotationDefault, EnclosingMethod, InnerClasses,
                RuntimeVisibleAnnotations, RuntimeVisibleParameterAnnotations,
                RuntimeVisibleTypeAnnotations, Signature
-keep public class com.google.vending.licensing.ILicensingService
-keep public class com.android.vending.licensing.ILicensingService
-keep public class com.google.android.vending.licensing.ILicensingService
-keepclasseswithmembernames,includedescriptorclasses class * { native <methods>; }
-keepclassmembers public class * extends android.view.View { void set*(***); *** get*(); }
-keepclassmembers class * extends android.app.Activity { public void *(android.view.View); }
-keepclassmembers enum * { public static **[] values(); public static ** valueOf(java.lang.String); }
-keepclassmembers class * implements android.os.Parcelable { public static final ** CREATOR; }
-keepclassmembers class * { @android.webkit.JavascriptInterface <methods>; }
-keep class android.support.annotation.Keep
-keep @android.support.annotation.Keep class * {*;}
-keepclasseswithmembers class * { @android.support.annotation.Keep <methods>; }
-keepclasseswithmembers class * { @android.support.annotation.Keep <fields>; }
-keepclasseswithmembers class * { @android.support.annotation.Keep <init>(...); }

Cada línea es una pista de análisis: que los set*/get* de las subclases de View conserven su nombre, que los values()/valueOf() de los enum sobrevivan, que el campo CREATOR de todo Parcelable se siga llamando CREATOR y que los métodos anotados con @JavascriptInterface mantengan el suyo son anclas fijas en un DEX por lo demás ilegible, y la base de las heurísticas de «Deofuscación».

Nota verificable: el fichero de AGP solo entiende la anotación legacy android.support.annotation.Keep, no androidx.annotation.Keep, y sigue así en el proguard-common.txt de AGP 9.4.1. La versión AndroidX trae sus reglas dentro de la propia biblioteca: androidx.annotation:annotation-jvm:1.11.0 lleva META-INF/proguard/androidx-annotations.pro, con -keep,allowobfuscation @interface androidx.annotation.Keep, -keep @androidx.annotation.Keep class * {*;} y tres -keepclasseswithmembers para métodos, campos y constructores anotados. El @Keep de AndroidX funciona como regla de biblioteca, no porque lo sepa AGP.

5.3 Qué se conserva siempre, y qué rompe

Siempre: los componentes declarados en el manifiesto, que el framework instancia por nombre; los métodos native, por la regla de arriba, «para que se puedan seguir enlazando con la biblioteca nativa»; y lo que digan las reglas de las dependencias.

Lo de los componentes vale con la configuración por defecto. R8 trae ya una poda de los componentes con android:exported="false" y sin intent-filter —no los trata como raíz—, pero apagada: solo se enciende con la propiedad com.android.tools.r8.enableManifestPruning (InternalOptions.java y ResourceShrinkerState.java, etiqueta 9.4.23).

Lo que no se conserva y rompe en ejecución es todo lo alcanzado por reflexión: «R8 no puede identificar cuándo se accede a clases, campos o métodos mediante reflexión… Podría renombrarlos o eliminarlos por completo, lo que produce una ClassNotFoundException o una NoSuchMethodException en tiempo de ejecución». Y lo mismo con JNI: «cuando código nativo llama a un método Java o Kotlin… la llamada se basa en una búsqueda dinámica por cadena del nombre del método».

6. mapping.txt: la gramática exacta

Todo lo que sigue está contrastado contra tres fuentes: la gramática publicada en el manual de ProGuard, el código de R8 (ProguardMapReader.java, ClassNamingForNameMapper.java, Range.java, ProguardMapMarkerInfo.java) y doc/retrace.md del repositorio de R8. Los ejemplos son salida real de R8 9.2.4-dev, el que viene en build-tools/37.0.0/lib/d8.jar, ejecutado el 18 de octubre de 2026. El experimento, con sus fuentes y sus dos ficheros de reglas, está en la «sección 11.2 · Generar un mapping.txt real (ejecutada)», y cada ejemplo dice de cuál de sus cuatro compilaciones sale.

Es un fichero de texto plano en UTF-8, orientado a líneas, con indentación significativa de cuatro espacios.

6.1 El preámbulo de metadatos

Salida real, de la compilación sin optimizar:

# compiler: R8
# compiler_version: 9.2.4-dev
# min_api: 21
# compiler_hash: 084a89126ae0596c599143df57a654646af28313
# common_typos_disable
# {"id":"com.android.tools.r8.mapping","version":"2.2"}
# pg_map_id: 9261bef26adb7c0100db862e8152b14d13bc6f952d61e74fb44434e6556416ff
# pg_map_hash: SHA-256 9261bef26adb7c0100db862e8152b14d13bc6f952d61e74fb44434e6556416ff

El orden y la condicionalidad los fija ProguardMapMarkerInfo.toPreamble():

Línea ¿Siempre? Significado
# compiler: <Tool> Sí D8, L8, R8, R8Partial, Relocator, TraceReferences…
# compiler_version: <v> Sí Versión de R8
# min_api: <n> Solo si genera DEX minSdkVersion numérico
# compiler_hash: <sha> Solo en builds de desarrollo SHA del build de R8
# common_typos_disable Sí Desactiva el linting del fichero en algunos sistemas de build
# {"id":"com.android.tools.r8.mapping","version":"…"} Si la versión > none Versión del formato
# pg_map_id: <id> Sí Identificador del mapping
# pg_map_hash: SHA-256 <hash> Sí Hash del contenido

Dos trampas para un parser. min_api va antes de common_typos_disable, no al final. Y compiler_hash no aparece en releases estables: quien lo dé por obligatorio falla contra mapping.txt de producción. El prefijo SHA-256 de pg_map_hash es literal y R8 lo valida como tal (line.startsWith("# pg_map_hash: SHA-256 ")).

La versión estable del formato en R8 9.2.4-dev, y en main en agosto de 2026, es la 2.2 (MapVersion.STABLE). Existe una 2.3 en el enumerado, pero no es la estable. La regla de compatibilidad está en doc/retrace.md y es la que hace que el formato pueda crecer: «la información de versión se aplica al contenido del fichero que sigue a la posición de la entrada de versión hasta el final del fichero o hasta otra entrada de versión», y «al interpretar el fichero, cualquier información adicional correspondiente a una versión posterior debe ignorarse; dicho de otro modo, tratarse como un comentario normal». Un lector correcto avisa cuando ve una versión superior a la que soporta, y sigue.

6.2 Mapeo de clase

Empieza en columna 0 y termina en dos puntos (originalclassname -> obfuscatedclassname:). Ese : final es su discriminador. Salida real, las cuatro primeras líneas de la compilación sin optimizar y la quinta de la optimizada:

com.ejemplo.Calculadora -> b:
com.ejemplo.Calculadora$Auxiliar -> a:
com.ejemplo.Main -> com.ejemplo.Main:
com.ejemplo.Punto -> com.ejemplo.f:
com.ejemplo.Calculadora$Auxiliar -> R8$$REMOVED$$CLASS$$0:

Cinco cosas de la vida real en cinco líneas: los nombres van con puntos, no con barras ni en formato descriptor; las clases internas se nombran con $ como en el DEX; una clase puede mapearse a sí misma (Main -> Main, porque una keep rule la conservó); R8 puede sacar una clase de su paquete y ponerla en el paquete raíz (Calculadora -> b); y una clase eliminada cuyo código sobrevive inlineado en otra recibe el nombre centinela R8$$REMOVED$$CLASS$$<n>, que sostiene sus marcos inlineados. Una clase eliminada por inalcanzable no aparece en mapping.txt: solo en usage.txt.

El repaquetado al paquete raíz no exige -repackageclasses: las reglas de este experimento no lo piden, y R8 lo hace por defecto. Si la configuración no fija ni -repackageclasses ni -flattenpackagehierarchy, InternalOptions.getPackageObfuscationMode() devuelve REPACKAGE, al paquete de nivel superior, siempre que la salida sea DEX y se minifique, también con --pg-compat. Solo mueve lo que puede mover sin romper un acceso de paquete (RepackagingConstraintGraph.java): Punto, con visibilidad de paquete y usado desde Main, que una keep rule fija en com.ejemplo, se queda ahí.

Así que un paquete raíz poblado no delata un -repackageclasses: el comportamiento por defecto basta para explicarlo, y desde el binario no se distinguen. Tampoco es cosa de Google. Entre las apps ofuscadas con R8 propio, tienen al menos el 10 % de sus clases en el paquete raíz 812 de 2.020 en F-Droid (40 %), 283 de 690 en IzzyOnDroid (41 %), 63 de 184 en las más instaladas de Google Play sin contar las de Google (34 %) y 16 de 128 en el sorteo (13 %).

Las apps de Google lo llevan al extremo: 62 de las 70 de las más instaladas pasan de ese 10 %, con una mediana del 89,6 % de las clases en el paquete raíz. Fíjate en Gmail 2026.10.12: las primeras clases de su classes.dex son La;, Laav;, Laaw;, Labk;, Laci; y Lacr;, y el 93,5 % de sus 5.630 clases está en el paquete raíz. Para ver ese orden, con $BT como en la «sección 11.1 · Sobre un APK cualquiera (ejecutadas)»:

unzip -p "$MUESTRARIO/play/Gmail_2026.10.12.1003523797.Release_APKPure.xapk" com.google.android.gm.apk > gm.apk
unzip -p gm.apk classes.dex > classes.dex
$BT/dexdump -h classes.dex | grep 'Class descriptor' | head

6.3 Mapeo de campo

Cuatro espacios de indentación, sin rango de líneas: originalfieldtype originalfieldname -> obfuscatedfieldname. Salida real, de la compilación sin optimizar:

com.ejemplo.Calculadora -> b:
# {"id":"sourceFile","fileName":"Calculadora.java"}
    int acumulador -> a
    java.lang.String etiqueta -> b

Dos campos de tipos distintos pueden mapearse al mismo nombre ofuscado, porque en el DEX un field_id lleva class_idx, type_idx y name_idx: a de tipo int y a de tipo String son campos distintos. El mapeo no es biyectivo por el nombre solo.

6.4 Mapeo de método y los rangos de línea

La forma completa, tal como la publica el manual de ProGuard:

    [startline:endline:]originalreturntype [originalclassname.]originalmethodname(args)[:origstart[:origend]] -> obfuscatedmethodname

Y así es como R8 la serializa, en ClassNamingForNameMapper.MappedRange.toString():

if (minifiedRange != null) builder.append(minifiedRange).append(':');
builder.append(signature);
if (originalRange != null && !originalRange.equals(minifiedRange))
    builder.append(":").append(originalRange);
builder.append(" -> ").append(renamedName);

Descompuesto sobre el ejemplo del enunciado clásico, 23:25:void foo():42:44 -> a:

Trozo Nombre en el código de R8 Qué es
23:25 minifiedRange Rango de líneas en el binario producido. Es lo que aparecerá en la traza de pila del APK
void foo() signature Firma original: tipo de retorno, nombre y argumentos originales
42:44 originalRange Rango de líneas en el fichero fuente
a renamedName Nombre ofuscado del método

Tres reglas que un parser tiene que respetar y que casi ninguna descripción informal recoge:

  1. R8 omite originalRange cuando es igual a minifiedRange. La condición literal es !originalRange.equals(minifiedRange). Así que 1:3:void <init>(java.lang.String):7:7 y 1:8:void main(java.lang.String[]):5:12 conviven con líneas sin la segunda mitad, como 11:11:void main(java.lang.String[]) -> main de la compilación optimizada: línea 11 del binario, línea 11 del fuente.
  2. Un Range «cardinal» se serializa como un solo número, no como from:to. De ahí la tercera forma que documenta el javadoc de ProguardMapReader: range COLON signature COLON number ARROW name. Salida real, de la compilación optimizada: 3:5:void main(java.lang.String[]):6 -> main.
  3. Puede no haber rango en absoluto, por ejemplo en un método abstracto, que no tiene código. Salida real, el método de la interfaz Figura: double area() -> a.

Salida real completa de una clase con métodos renombrados, de la compilación sin optimizar:

com.ejemplo.Calculadora -> b:
# {"id":"sourceFile","fileName":"Calculadora.java"}
    int acumulador -> a
    java.lang.String etiqueta -> b
    1:3:void <init>(java.lang.String):7:7 -> <init>
    4:6:void <init>(java.lang.String):8:8 -> <init>
    7:8:void <init>(java.lang.String):9:9 -> <init>
    9:12:void <init>(java.lang.String):10:10 -> <init>
    1:3:int cuentaDeOperaciones():31:31 -> a
    1:6:void registrar(java.lang.String):24:24 -> b
    7:17:void registrar(java.lang.String):25:25 -> b
    18:45:void registrar(java.lang.String):26:26 -> b
    1:7:int resta(int,int):19:19 -> c
    1:7:int suma(int,int):14:14 -> d

Fíjate en que cuatro métodos originales se llaman ahora a, b, c y d y que los rangos de minifiedRange se solapan entre métodos distintos: todos empiezan en 1. No es un error. El rango solo desambigua dentro del mismo nombre ofuscado: 1:6 -> b, 7:17 -> b y 18:45 -> b son tres líneas del mismo método b, mientras que 1:7 -> c y 1:7 -> d son métodos distintos. La clave de búsqueda es el par (nombre ofuscado, línea).

El rango catch-all. Cuando basta una sola posición, R8 emite el rango completo:

0:65535:void foo():33:33 -> a

doc/retrace.md lo explica: «para asegurar la compatibilidad, R8 emite un rango catch-all 0:65535… Los rangos catch-all nunca deben usarse para sobrecargas».

6.5 Métodos inlineados

Aquí es donde el formato deja de ser una tabla y se convierte en algo con estructura. El javadoc de ProguardMapReader lo enuncia: la forma range COLON signature COLON range ARROW name significa «que signature fue inlineado desde el segundo rango a los números de línea nuevos del primero», y a continuación vienen las entradas «con la información de la traza de llamada hasta donde el miembro fue inlineado».

Salida real de la compilación con optimización, sobre el mismo código (extracto: el bloque de Main tiene 26 líneas de miembro):

com.ejemplo.Main -> com.ejemplo.Main:
# {"id":"sourceFile","fileName":"Main.java"}
    1:2:void main(java.lang.String[]):5:6 -> main
    3:5:void com.ejemplo.Calculadora.<init>(java.lang.String):7:9 -> main
    3:5:void main(java.lang.String[]):6 -> main
    6:7:void com.ejemplo.Calculadora$Auxiliar.avisa(java.lang.String):36:37 -> main
    6:7:void com.ejemplo.Calculadora.<init>(java.lang.String):10 -> main
    6:7:void main(java.lang.String[]):6 -> main
    8:8:int com.ejemplo.Calculadora.suma(int,int):14:14 -> main
    8:8:void main(java.lang.String[]):7 -> main
    …
    17:17:boolean com.ejemplo.Lambdas.lambda$cuenta$0(int,int,java.lang.String):11:11 -> main
    17:17:int com.ejemplo.Lambdas.filtra(com.ejemplo.Lambdas$Filtro,java.lang.String[]):18 -> main
    17:17:int com.ejemplo.Lambdas.cuenta(java.lang.String[]):12 -> main
    17:17:void main(java.lang.String[]):12 -> main

La lectura correcta del bloque 6:7, de arriba abajo, es de marco más interno a marco más externo:

líneas 6-7 de `main` en el APK ──► Calculadora$Auxiliar.avisa(String)  líneas 36-37  ← más interno
                                   llamado desde
                                   Calculadora.<init>(String)          línea 10
                                   llamado desde
                                   Main.main(String[])                 línea 6

Una sola línea de la traza de pila real se expande en tres marcos, y una del bloque 17:17, en cuatro: la lambda, filtra, cuenta y main. Eso es lo que hace retrace, y es la razón por la que una traza deofuscada puede ser más larga que la original. La señal sintáctica de que una entrada es un marco inlineado venido de otra clase es que la firma lleva el nombre de clase cualificado delante (void com.ejemplo.Calculadora$Auxiliar.avisa(...) en vez de void avisa(...)).

6.6 Los comentarios de metadatos por elemento

Además del preámbulo, R8 emite comentarios JSON pegados al elemento al que se refieren. El conjunto exacto de identificadores, extraído de las constantes ID del paquete com.android.tools.r8.naming.mappinginformation:

id Desde Claves Qué dice
com.android.tools.r8.mapping 1.0 version Versión del formato (solo en el preámbulo)
sourceFile 0 fileName Nombre del fichero fuente de la clase
com.android.tools.r8.synthesized 1.0 — Este elemento lo generó el compilador, no estaba en el fuente
com.android.tools.r8.residualsignature 2.2 signature Firma residual (la del binario) cuando difiere de la original
com.android.tools.r8.rewriteFrame 2.0 conditions, actions Reescritura condicional de marcos
com.android.tools.r8.outline 2.0 — Este método es un outline
com.android.tools.r8.outlineCallsite 2.0 positions, outline Correspondencia posición-en-el-outline → posición-en-el-llamador
com.android.tools.r8.mergedClasses — — Clases fusionadas
partitionSourceFiles — fileNameMappings Ficheros fuente en mappings particionados

Dos correcciones a lo que circula por ahí, verificadas en el código: no existe com.android.tools.r8.compilerSynthesized —la clase Java se llama CompilerSynthesizedMappingInformation pero su ID es com.android.tools.r8.synthesized— y no existe com.android.tools.r8.sourceFile: el identificador es el literal sourceFile, sin cualificar, porque, según doc/retrace.md, «es el único identificador sin cualificar permitido, ya que se introdujo antes del esquema de versionado». Los dos últimos de la tabla existen en el código pero no están documentados en doc/retrace.md.

Salida real con la clase sintética de una lambda, de la compilación sin optimizar (extracto: falta el segundo campo, f$1, y el constructor):

com.ejemplo.Lambdas$0 -> com.ejemplo.c:
# {"id":"sourceFile","fileName":"R8$$SyntheticClass"}
# {"id":"com.android.tools.r8.synthesized"}
    int com.ejemplo.Lambdas$$InternalSyntheticLambda$1$ab10e019…$0.f$0 -> a
      # {"id":"com.android.tools.r8.synthesized"}
    1:11:boolean acepta(java.lang.Object):0:0 -> a
      # {"id":"com.android.tools.r8.synthesized"}

Y con firma residual, de la compilación optimizada con --pg-compat:

com.ejemplo.Calculadora -> a:
    …
    1:7:int suma(int,int):14:14 -> d
      # {"id":"com.android.tools.r8.residualsignature","signature":"()I"}

Tres cosas que enseñan esos fragmentos. El fileName de una clase sintética es la cadena literal R8$$SyntheticClass; en modo compatibilidad con -keepattributes SourceFile aparece tal cual dentro del DEX —en full mode la tapa r8-map-id-…— y es una huella excelente («sección 9.2 · El atributo SourceFile»). El nombre interno de una lambda desugarizada es …$$InternalSyntheticLambda$<n>$<sha256>$<m>, con un hash de 64 hexadecimales dentro, aunque la línea de clase la llame Lambdas$0. Y residualsignature existe porque la firma del binario no siempre se puede deducir de la original: suma solo se llama con 2 y 3, R8 metió esas constantes en el cuerpo y quitó los dos parámetros, y int suma(int,int) es ()I en el DEX. R8 escribe la firma residual siempre que el tipo de retorno o los parámetros del binario no coinciden, como texto, con los originales (MappedPositionToClassNameMapperBuilder.java), también cuando solo se ha renombrado un tipo: distancia(com.ejemplo.Punto) la lleva, como (Lcom/ejemplo/f;)D, en la compilación sin optimizar. Según doc/retrace.md, «no tiene efecto sobre el retrace de trazas de pila, pero es necesaria al interactuar con firmas residuales a través de la API de Retrace o al componer ficheros de mapping».

Reglas de colocación, verbatim: la información de fichero fuente «debe colocarse directamente debajo del mapeo de clase al que se refiere»; la de synthesized, «directamente debajo del mapeo de clase, campo o método al que se refiere», y «nunca debe colocarse sobre marcos inlineados».

rewriteFrame es el más raro y merece nota: su condición throws(<descriptor>) «será cierta si la excepción lanzada arriba es <descriptor>» —varias condiciones se combinan con AND, y para hacer un OR hay que duplicar la información— y su acción removeInnerFrames(<n>) «elimina ese número de marcos empezando por el más interno», y solo se aplica «si la línea que se está deofuscando está directamente debajo de la línea de la excepción». Sirve para que los NullPointerException sintéticos que R8 introduce al inlinear no salgan en la traza.

Parte de los ejemplos de doc/retrace.md —los de synthesized— usan comillas simples en el JSON; el fichero real que emite R8 usa comillas dobles, como se ve arriba, y el de ProGuard 7.9.1 también, con las claves en otro orden (# {"fileName":"Calculadora.java","id":"sourceFile"}, «sección 11.3 · retrace, y los dos programas que se llaman igual»). Un parser tolerante acepta los dos tipos de comillas y no depende del orden de las claves.

6.7 El algoritmo de lectura

estado: clase_actual = ninguna
para cada línea:
  1. empieza por '#', con o sin sangría
                                     → metadato
       · preámbulo                   → compilador, versión, min_api, map id
       · JSON con "id"               → asociarlo al último elemento emitido
       · versión desconocida         → avisar y tratar como comentario
  2. no empieza por espacio, acaba en ':'
                                     → clase: partir por " -> ", clase_actual = esta
  3. empieza por espacios            → miembro de clase_actual, partir por " -> "
       · empieza por dígito y ':'    → método con rango
       · contiene '('                → método sin rango
       · en otro caso                → campo

La operación inversa —la de retrace— está desarrollada en «Deofuscación → §3.1 · El algoritmo», con sus tres casos límite: entradas sin minifiedRange, rangos solapados, y la no inyectividad del mapping, que hace la deofuscación ambigua cuando la traza no trae número de línea.

7. retrace

retrace es la herramienta que aplica un mapping.txt a una traza de pila. La definición oficial: «R8 retrace es una herramienta para obtener la traza de pila original a partir de una traza ofuscada. La traza se reconstruye emparejando los nombres de clase y método de un fichero de mapping con sus definiciones originales».

retrace  <fichero-de-mapping> [<fichero-de-traza>] [opciones]

Se instala con el SDK Manager en cmdline-tools/<version>/bin/. Sin fichero de traza lee de la entrada estándar. Opciones, las mismas que lista retrace --help en Retrace 8.9.27 (cmdline-tools 19.0): --verbose («imprime más información, como los parámetros y el tipo de retorno del método»), --info, --quiet, --regex <expresión> y --verify-mapping-file-hash. El retrace.jar de ProGuard acepta la misma idea con una sintaxis de comodines propia (%c clase, %m método, %l línea, %s fichero fuente…) y exige que las expresiones usen solo grupos sin captura, (?:...).

Ejecutado el 18 de octubre de 2026 sobre las compilaciones de la «sección 11.2 · Generar un mapping.txt real (ejecutada)». Las trazas de entrada son reales: las de com.ejemplo.Main fallo ejecutado con dalvikvm en un emulador de Android 14 (sdk_phone64_arm64), y en full mode el fichero de cada marco es el r8-map-id-<hash> que R8 escribe en el atributo SourceFile («sección 9.2 · El atributo SourceFile»; aquí, con el hash recortado). Con java -cp $BT/lib/d8.jar com.android.tools.r8.retrace.Retrace mapping.txt traza.txt, sobre la compilación sin optimizar, esta entrada:

Exception in thread "main" java.lang.IllegalStateException: fallo:suma
	at b.b(r8-map-id-9261bef2…:42)
	at b.d(r8-map-id-9261bef2…:3)
	at com.ejemplo.Main.main(r8-map-id-9261bef2…:3)

da esta salida:

Exception in thread "main" java.lang.IllegalStateException: fallo:suma
	at com.ejemplo.Calculadora.registrar(Calculadora.java:26)
	at com.ejemplo.Calculadora.suma(Calculadora.java:14)
	at com.ejemplo.Main.main(Main.java:7)

Y sobre el binario y el mapping.txt con optimización, dos líneas de entrada producen las mismas tres: el marco de main se expande en suma y main, porque suma está inlineada (bloque 8:8 de la «sección 6.5 · Métodos inlineados»).

Exception in thread "main" java.lang.IllegalStateException: fallo:suma
	at a.a(r8-map-id-f990d001…:3)
	at com.ejemplo.Main.main(r8-map-id-f990d001…:8)

Las cuatro compilaciones —con y sin optimización, con y sin --pg-compat— dan exactamente esa traza recuperada, con el retrace de d8.jar y con el de cmdline-tools.

Por qué es deofuscación determinista y sin riesgo. Porque no infiere nada. Es una búsqueda en una tabla que produjo el mismo compilador que produjo el binario: no hay heurística ni confianza que declarar. Es determinista, y su respuesta es un resultado, una ambigüedad —las alternativas, cada una marcada con <OR> delante del at (StringRetrace.java)— o el silencio, que deja la línea como estaba. La condición es que el mapping.txt corresponda al APK, y el hash pg_map_id permite comprobarlo («sección 9.1 · El marcador ~~R8{…} dentro del DEX»): con el mapa de otra compilación, retrace no lo detecta y devuelve marcos plausibles y falsos («sección 11.3 · retrace, y los dos programas que se llaman igual»). Con el mapa correcto, es la única deofuscación que se puede ofrecer sin reservas.

8. R8 full mode

R8 tiene dos modos. El modo compatibilidad imita a ProGuard; el modo completo (full mode) hace suposiciones más fuertes sobre el código y optimiza más. android.enableR8.fullMode pasó a valer true por defecto en AGP 8.0.

Las siete diferencias, tomadas literalmente de compatibility-faq.md del repositorio de R8:

  1. El constructor por defecto <init>() no se conserva implícitamente al conservar una clase.
  2. Tampoco se conserva para tipos que solo se usan con ldc, instanceof o checkcast.
  3. Las clases que contienen campos o métodos casados por una -keepclassmembers no se consideran implícitamente instanciadas.
  4. Los métodos default no se conservan implícitamente como métodos abstractos.
  5. Los atributos (como Signature) y las anotaciones solo se conservan para las clases, métodos y campos casados por una keep rule, aunque se haya puesto -keepattributes.
  6. Al optimizar o minificar, el atributo SourceFile siempre se reescribe a SourceFile salvo que se use -renamesourcefileattribute. En el R8 9.2.4-dev de build-tools 37 el valor por defecto en full mode es r8-map-id-<hash> («sección 9.2 · El atributo SourceFile»).
  7. La modificación de acceso (-allowaccessmodification) está activada por defecto al optimizar.

Los puntos 1 a 4 son la razón de que el modo completo «rompa más código»: cada uno elimina una conservación implícita en la que muchos proyectos se apoyaban sin saberlo, y el síntoma es una ClassNotFoundException o una NoSuchMethodException en ejecución.

El punto 1 no contradice la «sección 5 · Keep rules». Habla de lo que arrastra conservar una clase: en full mode, que una regla conserve A —por ejemplo, -keep class A { void f(); }— no conserva su <init>(). Convertir un -keep class A sin miembros en -keep class A { <init>(); } es otra cosa: lo hace el lector de reglas de R8 antes de aplicarlas, en modo compatibilidad siempre y en full mode mientras la propiedad de sistema com.android.tools.r8.enableLegacyFullModeForKeepRules valga true, que es su valor por defecto; no se aplica a -keepclasseswithmembers (ProguardConfigurationParser.java y ProguardConfigurationParserOptions.java). Esa conversión es la que AGP 9.0 apaga con android.r8.strictFullModeForKeepRules, y el código de AGP llama a las dos variantes legacy full mode y strict full mode for keep rules (BooleanOption.kt).

El punto 5 es el que más duele al analizar, no al compilar: sin Signature desaparecen los genéricos, que en el DEX viven en la anotación de sistema dalvik.annotation.Signature («Formato DEX → §9 · La sección de datos»). Un List<String> decompila como List y ya no hay forma de recuperar el parámetro de tipo.

Hay una discrepancia entre fuentes oficiales, que comprobamos de nuevo el 18 de octubre de 2026: el mismo compatibility-faq.md sigue afirmando que «el modo compatibilidad de R8 es el predeterminado en Android Studio», lo que contradice las notas de AGP 8.0. El texto de la FAQ parece desactualizado, y los datos del muestrario apoyan las notas de AGP. Entre las apps con marcador propio de R8 que declaran su modo, dicen full 2.362 de 2.673 en F-Droid (88 %), 775 de 901 en IzzyOnDroid (86 %), 136 de 157 en el sorteo de Google Play (87 %) y 292 de 407 en las más instaladas (72 %); en el mercado chino son 7 de 27 y en las webs de autores 4 de 5.

El modo compatibility se concentra en las versiones antiguas de R8: lo declaran 312 de las 323 apps con R8 3.x o 4.x (97 %). Con R8 8.x baja a 148 de 1.993 apps (7 %). Estas dos cifras juntan todos los orígenes, porque la medición no los separa. Entre las más instaladas de Google Play todavía lo declaran 115 de 407 (28 %).

Las versiones 1.x y 2.x a menudo ni traen el campo: 112 de 196. Es aún más habitual en los marcadores que la app hereda de sus bibliotecas («sección 9.1 · El marcador ~~R8{…} dentro del DEX»): 2.846 de 7.955. Ojo, esta cuenta suma los marcadores distintos de cada app entre todas las apps, así que no es una proporción de apps. Dos ejemplos:

  • Termux 1022: ~~R8 2.2.71, r8-mode compatibility.
  • Droid-ify 780: ~~R8 9.4.14, r8-mode full.

9. Cómo se detecta que una app pasó por R8

En orden de fiabilidad, de la certeza a la estadística.

9.1 El marcador ~~R8{…} dentro del DEX

R8, D8 y L8 escriben su propia firma como una cadena del DEX. Es un objeto JSON precedido de dos virgulillas, y es la huella más fuerte que existe porque no es una inferencia: es una declaración. Salida real de la compilación sin optimizar de la «sección 11.2 · Generar un mapping.txt real (ejecutada)»:

~~R8{"backend":"dex","compilation-mode":"release","has-checksums":false,"min-api":21,
     "pg-map-id":"9261bef26adb7c0100db862e8152b14d13bc6f952d61e74fb44434e6556416ff",
     "r8-mode":"full","sha-1":"084a89126ae0596c599143df57a654646af28313","version":"9.2.4-dev"}

(partido en tres líneas aquí; en el fichero es una sola cadena).

Qué se saca de ahí, de un APK cualquiera y sin herramientas: qué herramienta lo procesó, qué versión exacta, si se compiló en release o en debug, contra qué minSdkVersion, si estaba en modo full o compatibility, y el pg-map-id, que es literalmente el mismo valor que la línea # pg_map_id: del mapping.txt. Es decir: se puede verificar que un mapping.txt dado corresponde a un APK dado sin ejecutar nada.

Buscarlo es trivial:

MUESTRARIO=<carpeta del muestrario descargado>
unzip -p "$MUESTRARIO/fdroid/com.looker.droidify_780.apk" classes.dex | strings | grep '~~'

Salida, en una sola línea, sobre Droid-ify 780 (una app de F-Droid):

~~R8{"backend":"dex","compilation-mode":"release","desugared-library-identifiers":["com.tools.android:desugar_jdk_libs_configuration:2.1.5"],"has-checksums":false,"min-api":23,"pg-map-id":"ae06e847c618fe2b529b0ff6b4af8904ca732891fa1c5a4bdf155504602ab775","r8-mode":"full","version":"9.4.14"}

Esta salida no trae el campo sha-1 porque es una compilación de release; el marcador de la compilación de prueba de arriba, hecha con una versión de desarrollo, sí lo tiene.

Un R8 antiguo escribe un marcador más corto. Termux 1022 usa R8 2.2.71 en modo compatibility: su pg-map-id tiene 7 caracteres (3e60161), no los 64 de un hash SHA-256, y el marcador no lleva backend ni sha-1. La regla sigue valiendo, porque el pg-map-id es el mismo valor que la línea # pg_map_id del mapping.txt; solo cambia su formato. Salida, en una sola línea (F-Droid):

~~R8{"compilation-mode":"release","desugared-library-identifiers":["com.tools.android:desugar_jdk_libs:1.1.5"],"has-checksums":false,"min-api":24,"pg-map-id":"3e60161","r8-mode":"compatibility","version":"2.2.71"}

El propio d8.jar trae además un lector, ExtractMarker, que acepta DEX, JAR y .class. Sobre el DEX del experimento de la «sección 11.2 · Generar un mapping.txt real (ejecutada)», ejecutado el 18 de octubre de 2026:

BT=~/Library/Android/sdk/build-tools/37.0.0
java -cp $BT/lib/d8.jar com.android.tools.r8.ExtractMarker sin-optimizar-full/classes.dex
sin-optimizar-full/classes.dex: ~~R8{"backend":"dex","compilation-mode":"release","has-checksums":false,"min-api":21,"pg-map-id":"9261bef26adb7c0100db862e8152b14d13bc6f952d61e74fb44434e6556416ff","r8-mode":"full","sha-1":"084a89126ae0596c599143df57a654646af28313","version":"9.2.4-dev"}

Extrajimos el marcador de los 16.158 classes*.dex de las 7.044 apps con DEX (7.163 piezas con código; la única app de F-Droid sin DEX queda fuera). La tabla dice cuántas apps llevan algún ~~R8 (propio o heredado de una biblioteca), solo ~~D8 o ~~L8, o ningún marcador. Las tres filas no se solapan:

Marcador F-Droid IzzyOnDroid Google Play, más instaladas Google Play, sorteo Mercado chino
Algún ~~R8 60 % (2.861 de 4.765) 69 % (963 de 1.402) 85 % (557 de 658) 71 % (261 de 369) 30 de 100
Solo ~~D8 o ~~L8 37 % (1.753 de 4.765) 30 % (416 de 1.402) 3 % (22 de 658) 24 % (89 de 369) 3 de 100
Ningún marcador 3 % (151 de 4.765) 2 % (23 de 1.402) 12 % (79 de 658) 5 % (19 de 369) 67 de 100

Entre todos los marcadores aparecen al menos 194 versiones distintas de R8, D8 y L8 (160 de R8, 135 de D8, 89 de L8 y 2 de R8Partial; el mismo número de versión se repite entre herramientas, por eso las cuatro cifras no suman 194). Es una cota inferior, porque la medición guarda como mucho 50 marcadores por DEX y 83 DEX superan ese tope.

La ausencia del marcador es en sí una señal, y casi nunca significa lo mismo. No llevan marcador propio 151 de 4.765 apps de F-Droid (141 de esas 151 con DEX 035, el formato de dx y de los D8 antiguos), 80 de 658 de las más instaladas de Google Play y 67 de las 100 del mercado chino. (En las más instaladas hay una app con solo marcadores de bibliotecas, por eso «ningún marcador» son 79 en la tabla y «sin marcador propio», 80.) En Google Play, esas 80 se reparten así: 44 con la lógica fuera del DEX, 12 con el paquete X/… que se explica enseguida, 9 con un protector o un lanzador (stub), 8 sin explicación y 7 con DEX 035.

Los nombres X/… siguen el estilo de Redex (por patrón; no lo hemos comprobado), el optimizador de DEX de Meta, software libre con licencia MIT que trabaja sobre el DEX ya generado. Sus clases LX/000;, LX/001; son el formato de su pase RenameClassesPassV2: LX/ más el índice global de la clase en base 62, con un número fijo de cifras (liblocator/locator.h). Su resources.arsc lleva la cadena (name removed) («Ofuscadores comerciales → §2.9 · Ofuscación de recursos»). WhatsApp es el caso más claro: está ofuscado a la vista («sección 10 · Medición propia: la fracción de identificadores cortos») y no lleva marcador. Pero no es solo WhatsApp. En el muestrario hay 16 apps con el paquete X/… y sin ningún marcador (cada pareja paquete-origen cuenta una vez, así que WhatsApp suma dos: el de Google Play y el de la web del autor): 10 de Meta, con 9 paquetes, y 6 de ByteDance. No sabemos si es Redex quien quita el marcador ni si ByteDance lo usa (recuadro de la «sección 1 · Qué es y por qué existe»), y un paquete X/… no equivale a «es Redex». Las 16 son estas:

  • De Meta: com.facebook.katana, com.facebook.lite, com.facebook.orca, com.facebook.pages.app, com.instagram.android, com.instagram.barcelona, com.instagram.lite, com.whatsapp (Google Play y web del autor) y com.whatsapp.w4b.
  • De ByteDance: com.ss.android.ugc.aweme, com.ss.android.ugc.aweme.lite, com.ss.android.ugc.trill, com.zhiliaoapp.musically y com.zhiliaoapp.musically.go.
  • Del mercado chino: com.cat.readall.

En todas, el paquete X reúne más de la mitad de las clases. En WhatsApp de Google Play son 100.629 de 111.301; en Facebook, 189.728 de 213.454; en com.cat.readall, 169.825 de 312.927.

Ojo con una cosa que lleva a conclusiones erróneas: una app trae muchos marcadores, no uno, y cuántos depende de dónde se publica. En F-Droid e IzzyOnDroid casi siempre hay uno solo (mediana 1): llevan más de uno 564 de 4.614 apps (12 %) y 225 de 1.379 (16 %). En las más instaladas de Google Play llevan más de uno 487 de 579 (84 %), con una mediana de 6 marcadores distintos por app y un máximo de 53. En el sorteo, 195 de 350 (56 %; mediana 2, máximo 56); en el mercado chino, 19 de 33 (mediana 3, máximo 39), y en las webs de autores, 4 de 5.

Twitch 31.8.0, una versión beta, trae 8 marcadores de R8 distintos, con 8 pg-map-id distintos, de la versión 3.0.69 a la 9.3.16; el propio de la app es R8 9.3.16 en modo full y min-api 26. Tres apps de Google Play llegan a 53 marcadores distintos: ru.ok.android, com.rioo.runnersubway y FlipaClip.

¿De dónde salen tantos? No es que los AAR vengan dexificados: un AAR lleva classes.jar, bytecode de la JVM. Es que R8 y D8 copian al DEX de salida los marcadores de todas sus entradas (ApplicationWriter.computeMarkerStrings). Y una biblioteca que pasó por R8 o D8 antes de publicarse lleva el suyo dentro de cada .class, como primera constante del constant pool (CfApplicationClassWriter.MARKER_STRING_CONSTANT_POOL_INDEX, que JarClassFileReader lee al cargarla). Lo comprobamos el 18 de octubre de 2026: una clase pasada por D8 --classfile sale con ~~D8{"backend":"cf",…}, y el classes.dex que R8 genera con ella entre sus entradas lleva los dos marcadores, ese ~~D8 y su propio ~~R8. El que importa es el marcador del DEX con el código de la aplicación; los demás describen sus dependencias y, de paso, delatan qué bibliotecas usa.

9.2 El atributo SourceFile

Cada class_def_item tiene un source_file_idx («Formato DEX → §10 · class_def_item y class_data_item»). En un binario sin ofuscar hay un nombre de fichero distinto por clase; tras pasar por R8 suele haber uno solo, y su valor delata el camino recorrido.

«Suele» no es «siempre». En F-Droid e IzzyOnDroid casi todas las apps con R8 propio comparten un único valor en todas sus clases (2.458 de 2.762 y 822 de 925, el 89 %), pero en Google Play bastantes menos: 277 de 409 en las más instaladas (68 %) y 78 de 158 en el sorteo (49 %). En el mercado chino, 18 de 28, y en las webs de autores, 4 de 5 (todo sobre apps con el atributo en alguna clase). Las demás conservan varios nombres de fichero, como las que pasan por R8 sin renombrar («sección 3 · Los tres trabajos, que no son el mismo»). LinkedIn 4.1.1264 tiene un valor único («SourceFile») y no está ofuscada. Candy Crush Saga tiene como valor más frecuente R8$$SyntheticClass y 2.595 valores distintos en su classes.dex. Estos son los valores que te vas a encontrar:

Valor de SourceFile Qué significa Origen
Muchos valores distintos (Foo.java, Bar.kt…) Sin renombrar —
SourceFile Valor por defecto de R8 DexItemFactory.defaultSourceFileAttributeString
PG Cadena convencional: ProGuard no la emite salvo que se le pida (-renamesourcefileattribute PG), y R8 la reconoce y la trata como el valor por defecto DexItemFactory.pgSourceFileAttributeString, SourceFileRewriter.isDefaultOrEmpty
R8$$SyntheticClass / D8$$SyntheticClass Clase sintética generada por el compilador mapping.txt, {"id":"sourceFile"}
r8-map-id-<64 hex> El pg_map_id incrustado en el SourceFile SourceFileRewriter.computeSourceFileProvider
Cadena vacía Un reescritor de atributos que deja el nombre en blanco: R8 (sobre todo en modo compatibility), Redex o un protector El reparto está bajo la tabla

Tienen la cadena vacía como valor más frecuente 230 apps: 151 de 4.730 en F-Droid (3 %), 50 de 1.390 en IzzyOnDroid, 18 de 657 en las más instaladas de Google Play, 2 de 369 en el sorteo, 8 de 100 en el mercado chino y 1 de 7 en las webs de autores. Las deja R8 en 206 (121 en modo compatibility, 83 sin campo r8-mode y 2 en full), el patrón de Redex en 10 (todas de Meta), un protector en 9, D8 en 4 y la ausencia de marcador en 1. Vemos quién deja el vacío, no por qué; una causa posible es -renamesourcefileattribute con una cadena vacía. Dos ejemplos: China Life (273), un protector del mercado chino, y el patrón de Redex en el WhatsApp de la web del autor.

La lógica exacta está en SourceFileRewriter.java: -renamesourcefileattribute solo se aplica si SourceFile está en -keepattributes; en modo compatibilidad, además, solo cuando se están minificando nombres; y si no está, R8 reescribe al valor por defecto, que en el R8 9.2.4-dev de build-tools 37 es "SourceFile" en modo compatibilidad y r8-map-id-<hash> en full mode, el caso que sigue.

El caso r8-map-id-… merece una nota, porque el nombre del interruptor engaña. En el fuente de R8 la rama vive en SourceFileRewriter.computeSourceFileProvider y está condicionada a options.getTestingOptions().enableMapIdInSourceFile, lo que hace pensar en una opción experimental. No lo es: el campo se declara

public boolean enableMapIdInSourceFile =
    SystemPropertyUtils.parseSystemPropertyOrDefault(
        "com.android.tools.r8.enableMapIdInSourceFile", true);

es decir, activa por defecto en cualquier R8 estándar, salvo que se desactive con esa propiedad de sistema. Lo comprobamos con el R8 9.2.4-dev de build-tools 37: en full mode escribe r8-map-id-<hash> con -keepattributes SourceFile y sin ella, y con -Dcom.android.tools.r8.enableMapIdInSourceFile=false vuelve a SourceFile. Vivir en TestingOptions no la hace experimental. Eso explica sin misterio que el r8-map-id aparezca en alguna clase de 1.279 de 4.730 apps de F-Droid (27 %), 446 de 1.390 de IzzyOnDroid (32 %), 240 de 657 de las más instaladas de Google Play (37 %) y 57 de 369 del sorteo (15 %), contando las apps con el atributo. Y es la huella más útil de todas, porque el valor contiene el identificador del mapping.txt correspondiente. Ejemplos, todos de F-Droid:

  • AnkiDroid 22502300, con r8-map-id en 11.059 de sus 11.203 clases.
  • Wikipedia 50611, en 11.440 de 11.545.
  • NewPipe 1015, en 10.522 de 10.671.
  • K-9 Mail 39046, en 11.795 de 11.941.
  • Thunderbird 33, en 11.799 de 11.943.
  • Fossify Gallery 29 y Fossify Documents 7.

De las 16 apps de Fossify de F-Droid, 14 están ofuscadas y 2 son parciales, y en 8 el r8-map-id es el valor más frecuente.

Esta tabla muestra el valor de SourceFile que más se repite en cada app. Decimos «más frecuente» y no «mayoritario»: es el que más veces aparece, no uno que tengan la mayoría de las clases. En una app sin ofuscar, cada clase lleva su propio nombre y lo más repetido suele ser el de una clase sintética. Cada celda es el número de apps y, entre paréntesis, su porcentaje sobre las apps con el atributo.

Valor más frecuente F-Droid IzzyOnDroid Google Play, más instaladas Google Play, sorteo
SourceFile 1.229 (26 %) 400 (29 %) 324 (49 %) 146 (40 %)
r8-map-id-<sha256> 1.248 (26 %) 438 (32 %) 114 (17 %) 42 (11 %)
D8$$SyntheticClass 956 (20 %) 249 (18 %) 6 (1 %) 46 (12 %)
R8$$SyntheticClass 87 (2 %) 27 (2 %) 36 (5 %) 5 (1 %)
PG 0 0 64 (10 %) 0
vacío 151 (3 %) 50 (4 %) 18 (3 %) 2 (1 %)
(sin atributo) 618 (13 %) 153 (11 %) 16 (2 %) 26 (7 %)
otro 441 (9 %) 73 (5 %) 79 (12 %) 102 (28 %)
Apps con el atributo 4.730 1.390 657 369

Con PG como valor más frecuente hay 64 apps, todas de Google Play: 64 de 657 (10 %) entre las más instaladas; en F-Droid, IzzyOnDroid, el sorteo y el mercado chino, ninguna. De las 64, 61 tienen paquete com.google.* y las otras tres son com.niksoftware.snapseed, com.fitbit.FitbitMobile y com.whereismytrain.android (no hemos comprobado de quién son). Todas llevan un marcador ~~D8 de desarrollo o alfa. Es una huella de la cadena de compilación interna de Google, no de AGP. Ejemplos de apps de Google:

  • Gmail 2026.10.12: PG en 71.849 de las 72.661 clases de todos sus DEX, con ~~D8 9.6.0-alpha02.
  • YouTube 21.41.531: 55.621 de 56.360 clases, ~~D8 9.5.20-dev.
  • Photos 7.97.0: 71.013 de 71.843.
  • Drive 2.26.427: 34.478 de 35.330.
  • Calculator 9.3: 3.247 de 3.580, ~~D8 9.3.16-dev.

Ojo con los nombres: el com.google.android.apps.photos de IzzyOnDroid (100000010) no es el Photos de Google (0 de 1.090 clases con PG, ~~D8 8.11.18).

Un único valor de SourceFile para todas las clases es el indicador binario más barato de «esto pasó por un reescritor de atributos». Lo tienen 2.477 de 4.730 apps de F-Droid (52 %), 823 de 1.390 de IzzyOnDroid (59 %), 305 de 657 de las más instaladas de Google Play (46 %) y 79 de 369 del sorteo (21 %); en el mercado chino, 49 de 100, y en las webs de autores, 6 de 7.

En F-Droid e IzzyOnDroid funciona muy bien. En F-Droid, de las apps con valor único, llevan R8 propio 2.458 de 2.477 (99 %), y solo 19 de 1.968 de las que no llevan R8 lo dan por casualidad. En otros sitios falla más. En el sorteo, de las apps con valor único llevan R8 propio 78 de 79. En las más instaladas, 277 de 305 (91 %), y de las que no llevan R8 propio tienen valor único 28 de 248 (11 %). En el mercado chino es donde menos sirve: de las 72 apps sin R8 propio, 31 lo tienen único, y de las 49 con valor único solo 18 llevan R8.

9.3 Otras huellas

  • com.google.android.gms sin renombrar junto a clases La;, Lb;: es el patrón normal de una aplicación ofuscada con dependencias de Google, cuyas consumer rules conservan buena parte de su superficie. Entre las apps ofuscadas que no son de Google, tienen com.google.* entre los 40 paquetes más poblados de algún DEX 1.024 de 2.044 en F-Droid (50 %), 413 de 700 en IzzyOnDroid (59 %), 200 de 206 en las más instaladas de Google Play (97 %) y 129 de 138 en el sorteo (93 %). Un ejemplo es Netflix 9.88.0, que APKiD marca como DexGuard (en classes3.dex y en lib/arm64-v8a/libb55a.so; es la etiqueta de APKiD, con las reservas de «Lo que no hemos podido comprobar» de la «sección 1 · Qué es y por qué existe»): 65.953 de sus 78.903 clases en 9 DEX (83,6 %) están en un paquete llamado o, y de sus 298 clases de com/google/android/gms, 271 tienen un nombre de más de tres caracteres y solo 14 están en internal/cast. Su compilador es un ~~D8 «main» en los 9 DEX, sin ~~R8.
  • Clases sintéticas con nombres reconocibles: $$ExternalSyntheticLambda<n>, $$InternalSyntheticLambda$<n>$<sha256>$<m>, $$ExternalSyntheticApiModelOutline. R8 y D8 los generan y no los renombran. Su presencia identifica la herramienta que compiló las bibliotecas o el paso inicial, no necesariamente la última que tocó el DEX. Lo prueba el caso de las apps sin ningún marcador: tienen estas clases 47 de 79 de las más instaladas de Google Play sin marcador, 16 de 19 del sorteo, 15 de 67 del mercado chino y ninguna de las 151 de F-Droid. Por ejemplo, WhatsApp (205 clases sintéticas), Facebook (260) o TikTok (38). Que otra herramienta quitara después el marcador es una hipótesis (Redex), no una medida.
  • El paquete raíz poblado: el repaquetado que R8 hace por defecto («sección 6.2 · Mapeo de clase»), o -repackageclasses/-flattenpackagehierarchy. El classes.dex de Gmail 2026.10.12 empieza literalmente por La;, Laav;, Laaw;, Labk; («sección 6.2 · Mapeo de clase»).
  • META-INF/*.kotlin_module (el fichero donde Kotlin guarda el nombre de cada módulo Gradle): quedan intactos o no según de dónde viene la app. En las apps con Kotlin y R8 propio, los llevan 274 de 399 (69 %) en las más instaladas de Google Play y solo 265 de 2.600 (10 %) en F-Droid; en IzzyOnDroid, 79 de 827 (10 %), y en el sorteo, 44 de 157 (28 %). Con D8 la diferencia desaparece: F-Droid, 122 de 1.348 (9 %), y las más instaladas de Google Play, 9 de 114 (8 %). Pasa lo mismo con la anotación kotlin.Metadata: en las apps con el plugin de Kotlin y R8, el DEX la conserva en 179 de 240 (75 %) en las más instaladas y en 146 de 1.320 (11 %) en las de F-Droid, y con D8 en todas (F-Droid, 626 de 626). No hemos medido por qué F-Droid los pierde: puede ser la configuración de Gradle o las reglas de R8. Shazam 16.64.0, por ejemplo, conserva 17 entradas .kotlin_module con R8 8.6.17. Hay más ejemplos de módulos Kotlin intactos en la «sección 8.5 de Ofuscadores comerciales · Lo que sobrevive por descuido».
  • Pocos debug_info_item para muchos métodos: R8 codifica las líneas por PC y hace que muchos code_item compartan el mismo debug_info_item. No es ausencia de información de depuración: en una compilación de prueba con el R8 9.2.4 de build-tools 37, los 48 code_item tienen debug_info_off != 0 y apuntan a solo 3 debug_info_item distintos, con -keepattributes LineNumberTable y sin ella. En el classes.dex de Droid-ify 780 (R8 9.4.14), 30.460 code_item apuntan a 1.190 debug_info_item distintos, 29.441 de ellos a un item que comparten con otros, y solo 25 tienen debug_info_off == 0. Como huella separa bien R8 de D8: tienen cinco o más code_item por cada debug_info_item 2.038 de 2.763 apps de F-Droid con R8 propio (74 %), y 0 de 1.851 de las que solo llevan D8. En Google Play la separación se rompe por las apps de Google: lo cumplen 68 de 169 de las más instaladas con solo D8 (40 %), y 67 de esas 68 son de Google. Lo que hay que contar son esos code_item, no los items; ver «Formato DEX → §12 · debug_info_item».

9.4 Qué versiones de R8 y AGP circulan

Saber con qué versión se compiló una app dice qué comportamientos esperar: R8 8 trae el full mode por defecto («sección 8 · R8 full mode») y AGP 9 cambia las keep rules («sección 5 · Keep rules») y optimiza los recursos («sección 3 · Los tres trabajos, que no son el mismo»). Las dos primeras filas cuentan apps con R8 propio, por su marcador; las dos últimas, apps que llevan app-metadata.properties, por la versión de AGP («sección 4 · Cómo se enciende y dónde viven las reglas»):

Versión F-Droid IzzyOnDroid Google Play, más instaladas Google Play, sorteo Mercado chino
R8 8 o posterior (marcador propio) 88 % (2.421 de 2.763) 86 % (793 de 926) 95 % (390 de 409) 90 % (142 de 158) 15 de 28
R8 9.3 o posterior (marcador propio) 23 % (629 de 2.763) 23 % (209 de 926) 14 % (58 de 409) 6 % (9 de 158) 1 de 28
AGP 8 o posterior (app-metadata.properties) 88 % (3.612 de 4.100) 86 % (1.086 de 1.266) 92 % (499 de 543) 89 % (316 de 354) 28 de 68
AGP 9.3 o posterior (app-metadata.properties) 18 % (732 de 4.100) 19 % (243 de 1.266) 10 % (55 de 543) 3 % (9 de 354) 0 de 68

Casi todas las apps se compilan ya con R8 8 o posterior: 2.421 de 2.763 (88 %) en F-Droid y 390 de 409 (95 %) en las más instaladas de Google Play. Con AGP 9.3 o posterior, que es el primero con la DSL nueva, hay una minoría. Las dos fuentes dan resultados parecidos pero no idénticos (87,6 % y 88,1 % para «8 o posterior» en F-Droid) porque no miden las mismas apps. Un ejemplo con R8 9.4.14 en modo full: Droid-ify 780.

9.5 ¿Cambia Google Play el DEX?

Google Play puede añadir a un APK una protección propia, PairIP («sección 8 de Anti-análisis y hardening · PairIP»). La pregunta es si eso borra el marcador de R8. No lo borra: entre las apps con PairIP, conservan un marcador propio de R8 32 de 45 (71 %) de las más instaladas de Google Play y 56 de 99 (57 %) del sorteo. Entre las que no llevan PairIP, 377 de 613 (62 %) y 102 de 270 (38 %).

Otra forma de comprobarlo es comparar el mismo paquete en Google Play y en la web del autor. En 6 pares, Firefox, Brave, WhatsApp y Kanaquiz coinciden en marcador, SourceFile y mediana de longitud; Viber y Lark Player difieren en la mediana (4 frente a 6 y 3 frente a 6), y Viber también en el marcador (R8 9.3.16 en Google Play, ninguno en la web). Esa comparación mezcla versiones de la app y no aísla el efecto de Google Play. Los pares:

  • org.mozilla.firefox: R8 9.4.14, SourceFile «nombre real» y mediana 10, igual en Google Play y en la web del autor.
  • com.brave.browser: R8 9.5.15-dev, SourceFile «nombre real» y mediana 1, igual en las dos.
  • com.whatsapp: sin marcador, SourceFile «vacío» y mediana 3, igual en las dos.
  • com.viber.voip: en Google Play, R8 9.3.16, SourceFile «SourceFile» y mediana 4; en la web, sin marcador, SourceFile «SourceFile» y mediana 6.
  • com.dywx.larkplayer: R8 8.13.19 y SourceFile «SourceFile» en las dos; mediana 3 en Google Play y 6 en la web.
  • com.noprestige.kanaquiz: R8 8.3.36, SourceFile «SourceFile» y mediana 1, igual en las dos.

Lo que no podemos decir es si los .apkm de APKMirror y las carpetas de adb difieren entre sí: las dos listas de Google Play no comparten ningún paquete. Las apps de Google Play nos llegaron en seis formatos: 365 carpetas de adb, 388 .apkm de APKMirror, 71 .xapk de APKPure, 23 .apk sueltos de APKPure, 179 .apk de descarga manual y 1 .xapk de APKCombo.

10. Medición propia: la fracción de identificadores cortos

10.1 Definición de la métrica

Una forma habitual de caracterizar la ofuscación es la «fracción de identificadores de uno o dos caracteres en el primer DEX». Esa métrica la reimplementamos desde cero —un lector de DEX en Python que abre el base.apk del contenedor, lee su classes.dex y recorre class_defs, class_data_item, field_ids, method_ids y string_ids— con esta definición precisa:

  • Universo: los identificadores definidos en el primer DEX, no los referenciados. Es decir, para los miembros se recorre el class_data_item de cada class_def_item y se siguen los field_idx_diff/method_idx_diff, no se toman las tablas enteras: las tablas incluyen referencias a java.lang.String.length y a medio framework, que no ofusca nadie.
  • Clases: el nombre simple de la clase de nivel superior, deduplicado. De Lcom/foo/Bar$Baz$1; se toma Bar. Los sufijos $1, $2 de clases anónimas los pone el compilador esté ofuscado el código o no, y contarlos como identificadores cortos sube la proporción. En una muestra de 20 apps sin ofuscar de F-Droid (con un solo DEX de menos de 4 MB), contar también las clases internas sube la proporción de nombres de uno a tres caracteres una mediana de 1,3 puntos porcentuales (0,8 en el percentil 10 y 3,6 en el 90; mínimo 0,4 y máximo 5,3), un 60 % más en relación (20 % y 77 %; mínimo 8 % y máximo 163 %). Por ejemplo, ru.zxalexis.ugaday pasa del 1,77 % al 2,90 %. Son 20 apps, no el censo.
  • Métodos: se excluyen <init> y <clinit>, que nunca se renombran.
  • Longitud: en unidades UTF-16, leída del utf16_size del string_data_item, lo que evita tener que decodificar MUTF-8 para contar.

Un punto ciego: los diccionarios de ofuscación. Las opciones -obfuscationdictionary, -classobfuscationdictionary y -packageobfuscationdictionary sustituyen los nombres cortos de R8 por palabras de una lista, por caracteres que se confunden entre sí (IlIlIl, O0oO0) o por caracteres que no son ASCII. La métrica de longitud los toma por «sin ofuscar», porque los nombres son largos. Buscamos, entre los paquetes más poblados de cada app, componentes de tres o más caracteres hechos solo de I, l y 1, solo de O, 0 y o, o no ASCII. Los hay en 12 de 658 apps (2 %) de las más instaladas de Google Play y en 8 de 100 del mercado chino; en F-Droid (0 de 4.765), IzzyOnDroid (0 de 1.402), el sorteo (0 de 369) y las webs de autores (0 de 7), en ninguna. Los componentes de dos caracteres (il, oo) no cuentan como prueba: R8 los genera por sí solo, y los tienen 473 de 4.765 apps de F-Droid (10 %), todas con R8 propio. Ejemplos:

  • Zepp Life (com.xiaomi.hm.health, mercado chino): 1.814.613 de sus 2.236.902 identificadores (81 %) están hechos solo con O, 0 y o, y la métrica la clasifica «sin ofuscar» (3,8 % de nombres de uno a tres caracteres, mediana 7).
  • CamScanner 7.27.0 (más instaladas de Google Play): 254.438 de sus 1.439.934 identificadores (18 %) no son ASCII, y también sale «sin ofuscar».
  • BeautyPlus 7.48.1, con un paquete Il1 (parcial).
  • Baidu (com.baidu.searchbox), con Il1, mediana 3, ofuscada.
  • Un juego de Tencent, Ace Racer (com.tencent.tmgp.aceracer), con O0o.

10.2 El resultado, y por qué el umbral de dos caracteres es el instrumento equivocado

Cada fila es un APK concreto de Google Play (el de la web del autor, en la fila marcada). Miramos su classes.dex, el de la pieza base si es un contenedor. La columna «≤ 3» ordena la tabla: es la proporción de identificadores con uno a tres caracteres. Las dos últimas columnas repiten esa proporción y la mediana con todos los DEX de la app, porque en las apps con varios DEX el primero puede dar otra lectura («sección 10.6 · Qué no ve la métrica»). Los identificadores son los del classes.dex.

App Identificadores ≤ 1 ≤ 2 ≤ 3 Mediana SourceFile más frecuente Valores distintos de SourceFile ≤ 3 con todos los DEX Mediana con todos los DEX
YouTube 70.539 61,6 % 85,2 % 91,8 % 1 PG 1 79,8 % 1
Gmail 62.554 69,1 % 81,7 % 90,0 % 1 PG 1 81,4 % 1
Photos 64.100 61,4 % 80,3 % 89,3 % 1 PG 1 80,0 % 1
Snapchat 97.641 50,9 % 81,1 % 85,8 % 1 r8-map-id-… 1 71,5 % 1
Drive 88.767 71,3 % 75,5 % 85,8 % 1 PG 2 79,0 % 1
WhatsApp (web) 66.326 0,0 % 0,3 % 80,1 % 3 (vacío) 1 78,7 % 3
WhatsApp 66.634 0,0 % 0,3 % 78,7 % 3 (vacío) 1 78,5 % 3
Netflix 91.288 58,4 % 68,3 % 76,2 % 1 (vacío) 2 61,0 % 2
Shazam 90.340 49,0 % 53,1 % 72,0 % 2 SourceFile 1 65,4 % 1
Twitch (beta 31.8.0) 76.205 53,5 % 59,3 % 66,9 % 1 r8-map-id-… 1 54,7 % 3
Spotify 71.990 52,7 % 58,7 % 65,0 % 1 SourceFile 1 57,3 % 2
Duolingo 85.638 45,1 % 55,7 % 64,7 % 2 SourceFile 1 59,7 % 3
My Talking Tom 87.520 51,2 % 54,9 % 56,0 % 1 SourceFile 1 52,9 % 3
Telegram 100.000 40,3 % 47,7 % 53,7 % 3 r8-map-id-… 1 62,9 % 2
Clash Royale 110.812 32,2 % 36,1 % 52,5 % 3 r8-map-id-… 2 41,7 % 7
Coin Master 100.660 7,8 % 8,8 % 19,1 % 13 R8$$SyntheticClass 1.908 28,8 % 9
LinkedIn 83.498 0,8 % 1,1 % 7,5 % 12 SourceFile 1 5,0 % 13
Candy Crush 109.584 0,6 % 0,8 % 3,8 % 16 R8$$SyntheticClass 2.595 29,9 % 9

Y por origen, esta es la proporción de nombres de uno a tres caracteres en el classes.dex, entre las apps con al menos 200 identificadores. Mira la mediana de cada fila: en F-Droid la mitad de las apps tiene el 10,5 % o menos, y en IzzyOnDroid el 55,8 % o menos.

Origen Apps medibles Percentil 10 Mediana Percentil 90
F-Droid 4.668 2,3 % 10,5 % 85,5 %
IzzyOnDroid 1.348 2,8 % 55,8 % 86,3 %
Google Play, más instaladas 657 6,0 % 47,4 % 83,0 %
Google Play, sorteo 369 3,9 % 21,8 % 82,0 %
Mercado chino 78 4,2 % 18,4 % 65,7 %
Webs de autores 7 12,6 % 52,1 % 81,1 %

Cuatro filas pueden medir otra cosa. Coin Master 3.5.2755 y My Talking Tom 26.5.3.9614 son juegos de Unity con IL2CPP (el motor compila el código del juego a nativo), y Clash Royale 160402020 usa Flutter (libflutter.so y libapp.so, Dart 3.9.2). En los tres, la lógica está en código nativo y el DEX solo lleva la parte de Java y Kotlin, así que su mediana describe esa parte, no la ofuscación del código del juego. Candy Crush Saga 1.339.0.2 no lleva ningún motor reconocible: 5 DEX con 43.263 clases y tres bibliotecas nativas (libapplovin-native-crash-reporter.so, libcandycrushsaga.so y libdatastore_shared_counter.so); no sabemos dónde está su lógica («Ofuscadores comerciales → §2.12 · Fuera del DEX: código nativo y motores multiplataforma», sobre los motores).

No son casos raros: la mayoría de los juegos lleva un motor de este tipo. Son 139 de 180 en las más instaladas de Google Play (77 %) y 100 de 141 en el sorteo (71 %). Juego es el género GAME_* de la ficha de Google Play; los motores contados son Unity, Unreal, Cocos, Godot, SDL, GameMaker, Solar2D y Adobe AIR (libGDX no cuenta porque compila a DEX). En las más instaladas, esos juegos están menos renombrados: con todos los DEX, su mediana de nombres de uno a tres caracteres es del 31,4 % (139 juegos), frente al 49,8 % de las apps que no son juegos (477). En el sorteo no hay diferencia (34,0 % con 100 juegos y 32,7 % con 228 apps que no lo son).

La fila de WhatsApp es la que enseña algo. Con el umbral de dos caracteres da 0,3 %: «sin ofuscar». Con tres da 78,7 % (80,1 % en el APK de la web del autor). Mirando los nombres se ve por qué: sus clases se llaman LX/000;, LX/001;, LX/002;, exactamente tres caracteres, dentro de un paquete de uno. Es una app claramente ofuscada y el umbral de dos la declara limpia. Las dos copias se comportan igual: sin marcador, SourceFile vacío y mediana 3. La de Google Play tiene 66.634 identificadores y 5.837 clases en su classes.dex, y 41.086 nombres (name removed) en resources.arsc. La de la web del autor tiene 66.326 identificadores y 5.855 clases, con LX/000; a LX/004; y, después, Lcom/whatsapp/AppShell;.

La causa es estructural: R8 genera nombres por orden lexicográfico creciente, a, b, …, z, aa, ab, …, aaa, así que cuando el espacio de nombres de un ámbito se llena, los nombres crecen. Cuanto más se llena el paquete raíz, más nombres de tres y cuatro caracteres hay. Entre las 2.868 apps ofuscadas con R8 propio (de todos los orígenes, medidas juntas), la mediana de la fracción de nombres de tres o cuatro caracteres es del 1,3 % (1.576 apps) si no tienen clases en el paquete raíz, del 1,7 % (293) si tienen de 1 a 999, del 9,3 % (925) si tienen de 1.000 a 9.999 y del 11,4 % (74) si tienen 10.000 o más. El umbral fijo no mide «cuánto está ofuscada la app», mide «cuántos identificadores caben en el ámbito antes de desbordar», que depende del tamaño y del esquema de repaquetado.

La mediana de la longitud es el indicador más robusto, y deja ver dos formas de repartirse la ofuscación. Entre las apps de F-Droid y de IzzyOnDroid la distribución es bimodal: casi todas tienen la mediana de longitud en 1 o 2 (renombradas) o en 8 o más (sin renombrar), y caen en medio, entre 4 y 7, solo 93 de 4.668 (2 %) y 33 de 1.348 (2 %). En Google Play no: en las más instaladas, 139 de 657 (21 %) tienen la mediana entre 4 y 7 (59 de 657, el 9 %, si solo se mira el classes.dex de la base) y en el sorteo, 55 de 369 (15 %). Entre ellas hay ofuscación parcial: renombran una parte del código y dejan el resto. En la tabla de arriba no aparece ninguna porque contiene solo apps de los extremos. Así se reparten las apps por mediana de longitud (todos los DEX, apps con al menos 200 identificadores):

Origen Mediana 1 Mediana 2 Mediana 3 Mediana 4 a 7 Mediana 8 o más
F-Droid 1.947 61 37 93 2.530
IzzyOnDroid 663 21 16 33 615
Google Play, más instaladas 135 41 95 139 247
Google Play, sorteo 71 27 40 55 176

La mediana 3 no es solo de WhatsApp: la tienen 95 apps de las más instaladas (14,5 % de 657). Seis ejemplos de F-Droid con la mediana entre 4 y 7:

  • app.cbdm.qrcodedisplayer 4: mediana 6, 38 % de nombres de uno a tres caracteres.
  • app.cleartray 342: mediana 7, 38 %.
  • app.taskdav 2: mediana 5, 48 %.
  • be.ugent.zeus.hydra.open 37400: mediana 5, 48 %.
  • btools.routingapp 56: mediana 6, 48 %.
  • cash.p.terminal 259: mediana 6, 40 %.

10.3 El grupo de control de F-Droid

F-Droid compila desde el fuente las apps que distribuye, así que sirve de grupo de control: apps que salen de la configuración de Gradle de cada proyecto, sin protectores añadidos por una tienda. Es el censo completo de F-Droid, no una muestra, y algo más de la mitad está sin ofuscar. De sus 4.668 apps con al menos 200 identificadores (otras 97 definen menos y una no tiene DEX), 2.447 (52 %) están sin ofuscar (menos del 20 % de nombres de uno a tres caracteres), 176 (4 %) a medias y 2.045 (44 %) ofuscadas. En IzzyOnDroid se invierte: de 1.348 apps con al menos 200 identificadores (otras 54 sin datos), 594 (44 %) están sin ofuscar, 54 (4 %) a medias y 700 (52 %) ofuscadas. Las 4.766 apps de F-Droid son de F-Droid; de las 1.402 de IzzyOnDroid, 1.140 son de IzzyOnDroid y 262 de F-Droid (ficheros que están también en la primera lista). com.termux.styling 1000 queda fuera de la medida: define solo 155 identificadores.

Dicho de otra forma: la premisa de que F-Droid es un grupo de control «mayoritariamente sin ofuscar» solo vale para F-Droid (52 % sin ofuscar). En IzzyOnDroid las ofuscadas ya son mayoría (52 %). F-Droid compila desde el fuente con la configuración Gradle del propio proyecto, y si el proyecto pone minifyEnabled = true, entrega un APK ofuscado. Como grupo de control real quedan apps como estas, sin ofuscar:

App Nombres de uno a tres caracteres en classes.dex Mediana de longitud
Termux 1022 2,3 % 14
osmdroid 55 2,6 % 15
AntennaPod 3120395 4,0 % 17
F-Droid 2000052 9,3 % 13
VLC 13070206 3,7 % 15
NewPipe 1015 4,8 % 13
Briar 10522 6,1 % 13
SimpleX Chat 385 3,7 % 13
K-9 Mail 39046 6,1 % 11
Thunderbird 33 6,1 % 11
Wikipedia 50611 7,5 % 11

Y estas otras, medidas de la misma manera, están tan ofuscadas como cualquiera de Google Play:

App Nombres de uno a tres caracteres en classes.dex Mediana de longitud
AnkiDroid 22502300 63,5 % 1
Aurora Store 76 64,9 % 1
My Expenses 887 58,9 % 1
Pachli 56 59,1 % 1
Material Files 40 68,6 % 2
Shelter 445 75,7 % 1
OCR 61 84,7 % 1

Aurora Store y My Expenses salen «parciales» si miras todos sus DEX (49,8 % y 42,8 %, medianas 4 y 5), aunque su classes.dex las lea ofuscadas. De las 16 apps de Fossify de F-Droid, 14 están ofuscadas y 2 son parciales; Fossify Gallery y Fossify Documents salen en la «sección 9.2 · El atributo SourceFile».

Que F-Droid tenga tantas apps ofuscadas no es un defecto del muestrario, sino una ventaja: solo distribuye software libre que compila él mismo, así que las 2.045 apps ofuscadas de F-Droid tienen su código fuente publicado, y se puede comparar la salida de un deofuscador con los nombres reales. Si sumas las 700 ofuscadas de IzzyOnDroid, son 2.469 paquetes distintos entre las dos tiendas; de los de IzzyOnDroid no hemos comprobado app a app que el código fuente esté publicado.

F-Droid frente a IzzyOnDroid: el mismo código compilado por dos manos. Casi siempre sale lo mismo. Hay 218 paquetes que están en las dos tiendas con ficheros distintos (los 262 ficheros idénticos no entran). De esos 218 pares, 211 (97 %) caen en la misma clase de ofuscación y 187 (86 %) usan la misma versión de R8 o D8. Ojo: solo 134 (62 %) comparten versionCode, así que el «misma clase» mezcla versiones distintas de la app en 84 pares. Las herramientas coinciden en 168 pares con R8 en los dos lados y 47 con D8. Son pocos los casos en que el autor y F-Droid compilan distinto: 7 de 218 (3 %). Por ejemplo, com.app.openlib sale ofuscada de F-Droid (versión 14) y sin ofuscar de IzzyOnDroid (versión 2014).

10.4 Qué indicador usar, y la sorpresa de Google

De la medición salen dos conclusiones que conviene dejar dichas, porque ninguna se ve de un vistazo en la tabla.

El indicador principal es la mediana de longitud, no un umbral fijo. Un umbral no ordena las aplicaciones, las baraja, y cuál elegir cambia el resultado más que la ofuscación que pretende medir. Ya lo viste con WhatsApp: su classes.dex pasa del 0,3 % con dos caracteres al 78,7 % con tres. En Telegram 13.1.0 el classes.dex da el 47,7 % con dos caracteres y el 53,7 % con tres, con mediana 3. La mediana de la longitud es el indicador más estable, aunque en Google Play depende algo del tamaño del ámbito de nombres. Entre las apps ofuscadas, su correlación de Spearman con el número de identificadores (0 es ninguna relación y 1, una relación perfecta) es débil en F-Droid (0,16; 2.045 apps) y en IzzyOnDroid (0,18; 700), y mayor en el sorteo (0,36; 138) y en las más instaladas de Google Play (0,50; 271). Con el umbral de dos caracteres, en esos dos últimos casos la correlación tiene signo contrario (−0,36 en el sorteo y −0,48 en las más instaladas; en F-Droid e IzzyOnDroid, 0,00 y −0,04).

Las aplicaciones de Google están entre las más ofuscadas del muestrario, no entre las menos. De las 657 apps medibles de las más instaladas de Google Play, 70 son de Google. De ellas, 62 (89 %) están entre el 25 % de apps más ofuscadas y 41 (59 %) entre el 10 % más ofuscado. Con todos los DEX, su mediana de nombres de uno a tres caracteres es del 80,4 %, frente al 41,7 % del resto. En la tabla de la «sección 10.2 · El resultado, y por qué el umbral de dos caracteres es el instrumento equivocado», YouTube, Gmail, Photos y Drive están entre las cinco primeras filas. Gmail 2026.10.12 lo confirma de primera mano: la primera clase de su classes.dex es La;, seguida de Laav; y Laaw;; su SourceFile es PG en 5.628 de sus 5.630 clases; su proporción de nombres de uno a tres caracteres es del 90,0 % y su mediana de longitud, 1.

Además, el muestrario sirve como gradiente: entre las filas con nombre de la tabla de la «sección 10.2 · El resultado, y por qué el umbral de dos caracteres es el instrumento equivocado» va del 3,8 % de Candy Crush al 91,8 % de YouTube (classes.dex), y entre las 657 apps medibles de las más instaladas de Google Play, del 1,7 % al 92,8 %, con una mediana del 47,4 %. En F-Droid (4.668 apps medibles) va del 0,1 % al 95,3 %, con una mediana del 10,5 %. Hay dónde elegir para probar una herramienta contra grados distintos de ofuscación. Con un sesgo: en el extremo bajo hay juegos cuyo código, si es nativo, no está en el DEX («sección 10.2 · El resultado, y por qué el umbral de dos caracteres es el instrumento equivocado»), así que el 3,8 % de Candy Crush describe su classes.dex, no necesariamente su ofuscación; con todos sus DEX sube al 29,9 %.

10.5 Qué fracción del ecosistema pasa por R8 y cuánto renombra

Dos tablas. La primera dice qué compilador dejó su marcador propio en la app: R8, solo D8, o ninguno. La segunda, cuánto renombra: «ofuscada» es el 50 % o más de los nombres con uno a tres caracteres, «parcial» del 20 % al 50 % y «sin ofuscar» menos del 20 %. Esta clasificación mira todos los DEX de la app y sigue la definición común del muestrario, en «El muestrario».

Marcador propio F-Droid IzzyOnDroid Google Play, más instaladas Google Play, sorteo Mercado chino
R8 58 % (2.763 de 4.765) 66 % (926 de 1.402) 62 % (409 de 658) 43 % (158 de 369) 28 de 100
Solo D8 39 % (1.851 de 4.765) 32 % (453 de 1.402) 26 % (169 de 658) 52 % (192 de 369) 5 de 100
Sin marcador propio 3 % (151 de 4.765) 2 % (23 de 1.402) 12 % (80 de 658) 5 % (19 de 369) 67 de 100

Los denominadores son todas las apps con DEX de cada origen (F-Droid 4.765, IzzyOnDroid 1.402, Google Play más instaladas 658, sorteo 369, mercado chino 100).

Origen Ofuscada Parcial Sin ofuscar
F-Droid 44 % (2.045 de 4.668) 4 % (176 de 4.668) 52 % (2.447 de 4.668)
IzzyOnDroid 52 % (700 de 1.348) 4 % (54 de 1.348) 44 % (594 de 1.348)
Google Play, más instaladas 41 % (271 de 657) 45 % (298 de 657) 13 % (88 de 657)
Google Play, sorteo 37 % (138 de 369) 35 % (129 de 369) 28 % (102 de 369)
Mercado chino 13 de 78 38 de 78 27 de 78
Webs de autores 3 de 7 3 de 7 1 de 7

Aquí los denominadores son las apps medibles, con al menos 200 identificadores (F-Droid 4.668, IzzyOnDroid 1.348, Google Play más instaladas 657, sorteo 369, mercado chino 78, webs de autores 7). No se clasifican 97 de 4.765 apps de F-Droid, 54 de 1.402 de IzzyOnDroid, 1 de las más instaladas y 22 de las 100 del mercado chino. En F-Droid y en IzzyOnDroid, la ofuscación o está o no está: casi nada queda en medio (4 % de parciales en las dos). En Google Play lo habitual es el término medio: 298 de las 657 apps más instaladas son «parciales».

10.6 Qué no ve la métrica

La medida de la «sección 10 · Medición propia: la fracción de identificadores cortos» cuenta nombres cortos en el DEX. En cuatro casos eso no describe la ofuscación de la app.

Cuando la lógica está fuera del DEX. En una app hecha con Flutter, React Native o Unity, R8 solo toca la envoltura de Java y Kotlin: la lógica está en una biblioteca nativa, en un paquete de JavaScript o en ensamblados. Llevan algún marco así 814 de 4.766 apps de F-Droid (17 %), 222 de 1.402 de IzzyOnDroid (16 %), 236 de 658 de las más instaladas de Google Play (36 %) y 222 de 369 del sorteo (60 %); en el mercado chino, 67 de 100, y en las webs de autores, 1 de 7.

Y no es poco entre las ofuscadas: tienen el código principal fuera del DEX 516 de 2.045 en F-Droid (25 %), 141 de 700 en IzzyOnDroid (20 %), 67 de 271 en las más instaladas (25 %) y 83 de 138 en el sorteo (60 %). En todas ellas la medida describe la envoltura, no la ofuscación del código. El desglose por marco y los motores de juegos están en la «sección 2.12 de Ofuscadores comerciales · Fuera del DEX: código nativo y motores multiplataforma». Ejemplos: Clash Royale, con Flutter; Coin Master, con Unity IL2CPP; y Duolingo, con libil2cpp.so y libunity.so además de Jetpack Compose.

Cuando la app está empaquetada, sobre todo en el mercado chino. Un empaquetador o protector esconde el código real detrás de un programa de arranque (un lanzador o stub), y la métrica mide ese programa, no la app. Las cifras de ofuscación del mercado chino no son comparables con las de F-Droid o Google Play. Allí conviven R8, ProGuard con un dx antiguo y empaquetadores. De sus 100 apps, 38 están empaquetadas (más un lanzador sin familia conocida), 67 no llevan ningún marcador, 79 tienen DEX 035 y 67 tienen la lógica fuera del DEX; 28 llevan R8 propio. Por eso 22 de las 100 no se clasifican (menos de 200 identificadores, todas empaquetadas). De las 78 que sí, 27 salen sin ofuscar, 38 parciales y 13 ofuscadas. En las más instaladas de Google Play, en cambio, el empaquetador o protector es raro: 12 de 658 apps (2 %). PairIP, que va aparte, está en 45 de 658 (7 %). Ejemplos: Baidu, sin marcador y con mediana 3, y dos juegos de Tencent con clases cuyo SourceFile es «ProGuard»: 1.970 en com.tencent.tmgp.cod y 2.193 en com.tencent.tmgp.sgame.

Cuando la app tiene varios DEX. La definición de la «sección 10.1 · Definición de la métrica» mira el primer DEX de la pieza base. Eso es fiel a la métrica de la sección, pero en las apps con varios DEX puede dar otra lectura que el conjunto. En las más instaladas de Google Play, 211 de 614 apps con varios DEX (34 %) cambian de clase si se miran todos; en F-Droid, 16 de 1.438 (1 %); en IzzyOnDroid, 7 de 462 (2 %); en el sorteo, 91 de 294 (31 %). Las medidas de «El muestrario» y las tablas de la «sección 10.5 · Qué fracción del ecosistema pasa por R8 y cuánto renombra» usan todos los DEX; la tabla de la «sección 10.2 · El resultado, y por qué el umbral de dos caracteres es el instrumento equivocado» da las dos lecturas. Ejemplos: Netflix 9.88.0 tiene mediana 1 y 76,2 % en el classes.dex, y mediana 2 y 61,0 % con sus 9 DEX; Candy Crush Saga, 3,8 % frente a 29,9 % con sus 5 DEX; y Twitch 31.8.0, mediana 1 en el classes.dex y 3 con todos. Las piezas con código en splits de función también cuentan, y el muestrario no separa cuántas apps las tienen.

Cuando los nombres son largos a propósito. Los diccionarios de ofuscación («sección 10.1 · Definición de la métrica») hacen que una app muy ofuscada salga «sin ofuscar».

11. Recetas

11.1 Sobre un APK cualquiera (ejecutadas)

BT=~/Library/Android/sdk/build-tools/37.0.0
MUESTRARIO=<carpeta del muestrario descargado>
Objetivo Orden
Marcador de compilador unzip -p "$MUESTRARIO/fdroid/com.termux_1022.apk" classes.dex | strings | grep '~~'
Valores de SourceFile $BT/dexdump -h classes.dex | grep source_file_idx | sort | uniq -c
Nombres de clase definidos $BT/dexdump -h classes.dex | grep 'Class descriptor'
Módulos Kotlin supervivientes unzip -l app.apk 'META-INF/*.kotlin_module'

La primera orden se prueba con Termux 1022; su marcador está en la «sección 9.1 · El marcador ~~R8{…} dentro del DEX».

11.2 Generar un mapping.txt real (ejecutada)

R8 y retrace vienen en build-tools 37.0.0, dentro de lib/d8.jar, aunque no aparezcan como binarios sueltos. Es la forma de obtener salida real del formato sin instalar nada. Ejecutado el 18 de octubre de 2026, con javac 21.0.10 y el android.jar de platforms/android-35.

Las fuentes son seis ficheros del paquete com.ejemplo, bajo src/com/ejemplo/. Los números de línea de las secciones «6» y «7» son los de estos ficheros tal cual, contando desde la línea del package.

Main.java:

package com.ejemplo;

public class Main {
    public static void main(String[] args) {
        String modo = args.length > 0 ? args[0] : "demo";
        Calculadora c = new Calculadora(modo);
        int total = c.suma(2, 3) + c.resta(7, 4);
        Punto p = new Punto(0, 0);
        double d = p.distancia(new Punto(3, 4));
        Figura f = new Cuadrado(d);
        System.out.println(total + " " + f.area() + " " + c.cuentaDeOperaciones());
        System.out.println(new Lambdas().cuenta(args));
    }
}

Calculadora.java:

package com.ejemplo;

public class Calculadora {
    private int acumulador;
    private String etiqueta;

    public Calculadora(String etiqueta) {
        this.etiqueta = etiqueta;
        this.acumulador = 0;
        Auxiliar.avisa(etiqueta);
    }

    public int suma(int a, int b) {
        registrar("suma");
        return a + b;
    }

    public int resta(int a, int b) {
        registrar("resta");
        return a - b;
    }

    private void registrar(String operacion) {
        acumulador++;
        if (etiqueta.equals("fallo")) {
            throw new IllegalStateException(etiqueta + ":" + operacion);
        }
    }

    public int cuentaDeOperaciones() {
        return acumulador;
    }

    static class Auxiliar {
        static void avisa(String s) {
            if (s.isEmpty()) {
                System.out.println("sin etiqueta");
            }
        }
    }
}

Punto.java:

package com.ejemplo;

class Punto {
    private final double x;
    private final double y;

    Punto(double x, double y) { this.x = x; this.y = y; }

    double distancia(Punto otro) {
        double dx = x - otro.x;
        double dy = y - otro.y;
        return Math.sqrt(dx * dx + dy * dy);
    }
}

Figura.java y Cuadrado.java:

package com.ejemplo;

interface Figura {
    double area();
}
package com.ejemplo;

class Cuadrado implements Figura {
    private final double lado;

    Cuadrado(double lado) { this.lado = lado; }

    public double area() { return lado * lado; }
}

Lambdas.java:

package com.ejemplo;

class Lambdas {
    interface Filtro<T> {
        boolean acepta(T t);
    }

    int cuenta(String[] valores) {
        int minimo = valores.length;
        int maximo = 10;
        Filtro<String> f = s -> s.length() >= minimo && s.length() <= maximo;
        return filtra(f, valores);
    }

    private int filtra(Filtro<String> f, String[] valores) {
        int n = 0;
        for (String v : valores) {
            if (f.acepta(v)) n++;
        }
        return n;
    }
}

Los dos ficheros de reglas. reglas-sin-optimizar.pro:

-keep class com.ejemplo.Main { public static void main(java.lang.String[]); }
-keepattributes SourceFile,LineNumberTable
-dontoptimize
-dontshrink

reglas-optimizadas.pro, el mismo sin las dos últimas líneas:

-keep class com.ejemplo.Main { public static void main(java.lang.String[]); }
-keepattributes SourceFile,LineNumberTable

Y las cuatro compilaciones, cada una con y sin --pg-compat:

BT=~/Library/Android/sdk/build-tools/37.0.0
LIB=~/Library/Android/sdk/platforms/android-35/android.jar
java -cp $BT/lib/d8.jar com.android.tools.r8.R8 --version
# R8 9.2.4-dev (build 084a89126ae0596c599143df57a654646af28313 from go/r8bot …)

javac -g -d cls $(find src -name '*.java')
for r in sin-optimizar optimizadas; do
  mkdir -p $r-full $r-compat
  java -cp $BT/lib/d8.jar com.android.tools.r8.R8 --release --min-api 21 --lib $LIB \
    --pg-conf reglas-$r.pro --pg-map-output $r-full/mapping.txt --output $r-full cls/com/ejemplo/*.class
  java -cp $BT/lib/d8.jar com.android.tools.r8.R8 --release --min-api 21 --lib $LIB --pg-compat \
    --pg-conf reglas-$r.pro --pg-map-output $r-compat/mapping.txt --output $r-compat cls/com/ejemplo/*.class
done

--output debe ser un directorio que ya exista o un .zip/.jar; si no, R8 falla con Invalid output. --pg-compat selecciona el modo compatibilidad; sin él, R8 compila en full mode, que es lo que confirma la «sección 8 · R8 full mode» y lo que dice el marcador de cada DEX ("r8-mode":"full" o "compatibility"). Lo que sale:

Directorio pg_map_id SourceFile en el DEX De aquí salen
sin-optimizar-full 9261bef2… r8-map-id-9261bef2… en las nueve clases Las «secciones 6.1 · El preámbulo de metadatos» a 6.4, la lambda de la 6.6, la primera traza de la 7, el marcador de la 9.1 y la 11.3
sin-optimizar-compat 9261bef2…: el mismo mapping.txt El nombre real de cada fichero, y R8$$SyntheticClass en la clase de la lambda El SourceFile de la clase sintética de la 6.6
optimizadas-full f990d001… r8-map-id-f990d001… en sus dos clases La clase eliminada de la 6.2, las reglas 1 y 2 de la 6.4, la 6.5 y la segunda traza de la 7
optimizadas-compat aa897b88… El nombre real de cada fichero La firma residual de la 6.6

Sin optimizar, --pg-compat no cambia el mapping.txt: los dos ficheros son idénticos, con el mismo pg_map_id. Lo que cambia es el DEX: el modo del marcador y el atributo SourceFile, que en modo compatibilidad conserva el nombre de cada fichero porque -keepattributes SourceFile está en las reglas («sección 9.2 · El atributo SourceFile»). Y el repaquetado al paquete raíz de la «sección 6.2 · Mapeo de clase» aparece en las cuatro sin que las reglas lo pidan.

Las trazas de la «sección 7 · retrace» salen de ejecutar los binarios en ART, con dalvikvm, en un emulador de Android 14 (sdk_phone64_arm64, compilación UE1A.230829.036.A1). Sin argumentos el programa imprime 8 25.0 2 y 0; con fallo, registrar lanza la excepción:

cd sin-optimizar-full && zip -q app.jar classes.dex && cd ..
adb push sin-optimizar-full/app.jar /data/local/tmp/app.jar
adb shell dalvikvm -cp /data/local/tmp/app.jar com.ejemplo.Main fallo > sin-optimizar-full/traza.txt 2>&1

11.3 retrace, y los dos programas que se llaman igual

Hay dos retrace y hacen lo mismo con implementaciones distintas: el de Guardsquare, que viene con ProGuard, y el de Google, que viene con cmdline-tools y es el que documenta el formato extendido de R8. Con los mapping.txt de la «sección 11.2 · Generar un mapping.txt real (ejecutada)» los dos dan la misma traza, marcos inlineados incluidos. Si están los dos instalados colisionan en el PATH, así que conviene invocarlos por ruta absoluta. Verificado el 13 de agosto de 2026 con ProGuard 7.9.1 (Homebrew) y Retrace 8.9.27 (cmdline-tools), y de nuevo el 18 de octubre: con ProGuard instalado con Homebrew y cmdline-tools/latest/bin fuera del PATH, retrace a secas es el de Guardsquare (which -a retrace solo devuelve /opt/homebrew/bin/retrace).

Con la traza y el mapping.txt de la compilación sin optimizar:

~/Library/Android/sdk/cmdline-tools/latest/bin/retrace sin-optimizar-full/mapping.txt sin-optimizar-full/traza.txt
Exception in thread "main" java.lang.IllegalStateException: fallo:suma
	at com.ejemplo.Calculadora.registrar(Calculadora.java:26)
	at com.ejemplo.Calculadora.suma(Calculadora.java:14)
	at com.ejemplo.Main.main(Main.java:7)

Deshace las dos cosas a la vez: el nombre del método —b vuelve a ser registrar— y el del fichero fuente: el r8-map-id-… de la entrada pasa a Calculadora.java porque R8 escribió el nombre real en el comentario # {"id":"sourceFile","fileName":"Calculadora.java"} («sección 6.3 · Mapeo de campo»). Para eso no hace falta -keepattributes SourceFile: desde R8 8.2 el nombre original va siempre al mapping (compatibility FAQ), y con el R8 9.2.4 de build-tools 37 el comentario sale igual con la regla y sin ella: con unas reglas como reglas-sin-optimizar.pro sin la línea -keepattributes, las nueve clases lo siguen llevando. Si el mapping no lo trae, retrace deduce el nombre del de la clase («Deofuscación → §3.1 · El algoritmo»).

ProGuard independiente también se ejecuta, con la sintaxis de fichero de configuración. Sobre las mismas clases, con este config.pro:

-injars cls
-outjars proguard/app.jar
-libraryjars <java.home>/jmods/java.base.jmod(!**.jar;!module-info.class)
-keep class com.ejemplo.Main { public static void main(java.lang.String[]); }
-keepattributes SourceFile,LineNumberTable
-dontoptimize
-dontshrink
-printmapping proguard/mapping.txt
mkdir -p proguard && proguard @config.pro
ProGuard, version 7.9.1

Su mapping.txt no repaqueta —com.ejemplo.Calculadora -> com.ejemplo.a:— y también escribe el comentario sourceFile, con las claves en otro orden: # {"fileName":"Calculadora.java","id":"sourceFile"}.

El mapping.txt tiene que ser el del binario del que salió la traza. Aplicando el mapa que produjo ProGuard a la traza del binario de R8, el retrace de Guardsquare no falla: devuelve una traza que parece traducida y no lo está.

/opt/homebrew/bin/retrace proguard/mapping.txt sin-optimizar-full/traza.txt
Exception in thread "main" java.lang.IllegalStateException: fallo:suma
	at b.b(b.java:42)
	at b.d(b.java:3)
	at com.ejemplo.Main.main(Main.java:3)

Las clases b no están en ese mapa y se quedan como estaban, pero con un fichero b.java inventado en lugar del r8-map-id-…; y Main.main(Main.java:3) parece resuelto, porque Main y main existen en los dos mapas, pero la línea 3 es la del binario, no la del fuente, que es la 7. Con el retrace de Google y el mapping.txt de otra compilación de R8 —el de la optimizada, aplicado a la traza de la sin optimizar— es peor:

~/Library/Android/sdk/cmdline-tools/latest/bin/retrace optimizadas-full/mapping.txt sin-optimizar-full/traza.txt
Exception in thread "main" java.lang.IllegalStateException: fallo:suma
	at b.b(r8-map-id-9261bef2…:42)
	at b.d(r8-map-id-9261bef2…:3)
	at com.ejemplo.Calculadora.<init>(Calculadora.java:7)
	at com.ejemplo.Main.main(Main.java:6)

El último marco se convierte en dos, con nombres y líneas plausibles y falsos: la excepción no salió del constructor. En los dos casos el código de salida es 0.

La única defensa es comparar identificadores antes de traducir. En full mode, la propia traza lleva el del mapa en cada marco (r8-map-id-9261bef2…), y el mapping.txt equivocado empieza por # pg_map_id: f990d001…. Con --pg-compat, que deja en la traza el nombre real del fichero, hay que comparar el pg-map-id del marcador del DEX («sección 9.1 · El marcador ~~R8{…} dentro del DEX») con el pg_map_id del mapping («sección 6.1 · El preámbulo de metadatos»). Una automatización que no compare se lo traga entero.

Fuentes

  1. Enable app optimization with R8 — https://developer.android.com/build/shrink-code Consultado el 12 de agosto de 2026. De aquí salen la separación entre shrinking, optimización y ofuscación («sección 3 · Los tres trabajos, que no son el mismo»), las dos DSL y el source set keepRules («sección 4 · Cómo se enciende y dónde viven las reglas»), y el estado de full mode por versión de AGP («sección 8 · R8 full mode»). Consultado de nuevo el 18 de octubre de 2026: de aquí sale que en AGP 8.12 y 8.13 la optimización de recursos de R8 hay que activarla con android.r8.optimizedResourceShrinking=true («sección 3 · Los tres trabajos, que no son el mismo»).
  2. Troubleshoot app optimization — https://developer.android.com/topic/performance/app-optimization/troubleshoot-the-optimization Consultado el 12 de agosto de 2026. De aquí salen la ruta de mapping.txt, su empaquetado en el AAB, configuration.txt y la invocación de retrace (secciones «4» y «7»). Consultado de nuevo el 25 de septiembre de 2026: sigue dando la ruta de configuration.txt sin la variante («sección 4 · Cómo se enciende y dónde viven las reglas»).
  3. Add keep rules / Keep rules overview / Optimize your library — https://developer.android.com/topic/performance/app-optimization/add-keep-rules, .../keep-rules-overview y .../library-optimization Consultados el 12 de agosto de 2026. Del primero, la tabla de opciones, modificadores y comodines de la «sección 5 · Keep rules» y la regla del constructor por defecto implícito; del segundo, las citas sobre reflexión y JNI de la «sección 5.3 · Qué se conserva siempre, y qué rompe»; del tercero, consumerProguardFiles, META-INF/proguard/ y la distinción de la «sección 5.1 · Los ficheros y su procedencia».
  4. Analyze your build with APK Analyzer — https://developer.android.com/studio/debug/apk-analyzer Consultado el 12 de agosto de 2026. De aquí salen seeds.txt y usage.txt y la discrepancia de ruta señalada en la «sección 4 · Cómo se enciende y dónde viven las reglas». Consultado de nuevo el 25 de septiembre de 2026: sigue escribiendo mappings, en plural.
  5. Retrace — https://developer.android.com/tools/retrace Consultado el 12 de agosto de 2026. De aquí salen la definición, la sintaxis y las opciones de retrace de la «sección 7 · retrace».
  6. Android Gradle plugin 8.0.0 release notes — https://developer.android.com/build/releases/past-releases/agp-8-0-0-release-notes Consultado el 12 de agosto de 2026. De aquí sale que android.enableR8.fullMode pasa a true por defecto («sección 8 · R8 full mode»).
  7. Android Gradle plugin 3.4.0 release notes — https://developer.android.com/build/releases/past-releases/agp-3-4-0-release-notes Consultado el 12 de agosto de 2026. De aquí sale el relevo de ProGuard por R8 («sección 2 · Historia y relevo»).
  8. R8 — compatibility FAQ — https://r8.googlesource.com/r8/+/refs/heads/main/compatibility-faq.md Consultado el 12 de agosto de 2026. De aquí salen las siete diferencias del full mode y la discrepancia señalada al final de la «sección 8 · R8 full mode». Consultado de nuevo el 25 de septiembre de 2026: de aquí sale también que desde R8 8.2 no hace falta -keepattributes SourceFile para conservar el nombre del fichero fuente en el mapping («sección 11.3 · retrace, y los dos programas que se llaman igual»). Consultado de nuevo el 18 de octubre de 2026: sigue diciendo «R8 compatibility mode is default in Android Studio» («sección 8 · R8 full mode»).
  9. R8 — doc/retrace.md — https://r8.googlesource.com/r8/+/refs/heads/main/doc/retrace.md Consultado el 12 de agosto de 2026. De aquí salen el versionado del formato, el rango catch-all 0:65535, y la semántica de sourceFile, synthesized, rewriteFrame, outline, outlineCallsite y residualsignature (secciones «6.1», «6.4» y «6.6»). Consultado de nuevo el 18 de octubre de 2026: sus ejemplos de synthesized usan comillas simples en el JSON y los de sourceFile y la versión, dobles («sección 6.6 · Los comentarios de metadatos por elemento»).
  10. R8 — código fuente — https://r8.googlesource.com/r8/ Consultado el 12 de agosto de 2026. Ficheros leídos: src/main/java/com/android/tools/r8/naming/ProguardMapReader.java (gramática del javadoc), ClassNamingForNameMapper.java y Range.java (serialización exacta de la «sección 6.4 · Mapeo de método y los rangos de línea»), ProguardMapMarkerInfo.java y MapVersion.java (preámbulo y versión estable de la «sección 6.1 · El preámbulo de metadatos»), SourceFileRewriter.java y graph/DexItemFactory.java (valores centinela SourceFile, PG y r8-map-id- de la «sección 9.2 · El atributo SourceFile»), dex/Marker.java (valores de # compiler:) y naming/mappinginformation/*.java (los id de la «sección 6.6 · Los comentarios de metadatos por elemento»).
  11. Reglas por defecto que empaqueta AGP — https://android.googlesource.com/platform/tools/base/+/refs/heads/mirror-goog-studio-main/build-system/gradle-core/src/main/resources/com/android/build/gradle/ Consultado el 12 de agosto de 2026. De aquí salen proguard-header.txt, proguard-optimizations.txt y las reglas de proguard-common.txt de la «sección 5.2 · Las reglas que AGP empaqueta de verdad». Consultado de nuevo el 18 de octubre de 2026, proguard-common.txt?format=TEXT: sus reglas -keep* y -keepattributes son las del bloque de la «sección 5.2 · Las reglas que AGP empaqueta de verdad», con las tres de ILicensingService y las tres -keepclasseswithmembers de @android.support.annotation.Keep; el resto son comentarios y reglas -dontnote y -dontwarn.
  12. ProGuard manual — Retrace — https://www.guardsquare.com/manual/tools/retrace Consultado el 12 de agosto de 2026. De aquí sale la gramática formal de la «sección 6 · mapping.txt: la gramática exacta» y la sintaxis de comodines de retrace.jar de la «sección 7 · retrace».
  13. ProGuard manual — Usage / Home — https://www.guardsquare.com/manual/configuration/usage y https://www.guardsquare.com/manual/home Consultados el 12 de agosto de 2026. De aquí salen -renamesourcefileattribute, -keepattributes, -printmapping, -applymapping, -printseeds, -printusage, y los cuatro pasos de ProGuard de la «sección 2 · Historia y relevo».
  14. The ProGuard story: 20 years of innovation — https://www.guardsquare.com/blog/the-proguard-story-20-years-of-innovation-in-java-optimization-guardsquare Consultado el 12 de agosto de 2026. De aquí salen Eric Lafortune, el primer commit del 1 de mayo de 2002, Gingerbread, 2012 y 2014 («sección 2 · Historia y relevo»).
  15. Guardsquare/proguard — https://github.com/Guardsquare/proguard Consultado el 12 de agosto de 2026. De aquí salen la licencia GPL-2.0 con excepciones y el tag v7.9.1 («sección 2 · Historia y relevo»). La fecha de esa release sale de la fuente 20.
  16. Dalvik executable format — https://source.android.com/docs/core/runtime/dex-format Consultado el 12 de agosto de 2026. De aquí sale source_file_idx del class_def_item y el papel de dalvik.annotation.Signature (secciones «8» y «9.2»).
  17. ProGuard 7.9.1 y Retrace 8.9.27 ejecutados localmente — ProGuard instalado con Homebrew y retrace de cmdline-tools, el 13 de agosto de 2026. Ejecutados de nuevo el 18 de octubre de 2026 sobre el experimento de la «sección 11.2 · Generar un mapping.txt real (ejecutada)» (fuente 31): de ahí salen ahora las ejecuciones de la «sección 11.3 · retrace, y los dos programas que se llaman igual», incluida la traza que parece traducida y no lo está al aplicar un mapping.txt que no corresponde al binario.
  18. Android Gradle Plugin 9.0.0 release notes — https://developer.android.com/build/releases/agp-9-0-0-release-notes Consultado el 24 de septiembre de 2026. De aquí sale android.r8.strictFullModeForKeepRules y el fin del constructor implícito de las reglas -keep («sección 5 · Keep rules»). Consultado de nuevo el 25 de septiembre de 2026: de aquí salen también la optimización de recursos por defecto («sección 3 · Los tres trabajos, que no son el mismo»), el rechazo de opciones globales en las consumer rules («sección 5.1 · Los ficheros y su procedencia») y la ruta de configuration.txt con la variante («sección 4 · Cómo se enciende y dónde viven las reglas»).
  19. R8 9.2.4-dev de build-tools 37 ejecutado localmente — java -cp build-tools/37.0.0/lib/d8.jar com.android.tools.r8.R8, con dexdump y un lector de code_item en Python Consultado el 25 de septiembre de 2026. De aquí salen el método sin rango de la «sección 6.4 · Mapeo de método y los rangos de línea», la clase inlineada R8$$REMOVED$$CLASS$$0 frente a la inalcanzable, que solo va a usage.txt («sección 6.2 · Mapeo de clase»), los debug_info_item compartidos de la «sección 9.3 · Otras huellas» y el comentario sourceFile sin -keepattributes SourceFile de la «sección 11.3 · retrace, y los dos programas que se llaman igual».
  20. API de GitHub, repos/Guardsquare/proguard/releases — https://api.github.com/repos/Guardsquare/proguard/releases Consultado el 25 de septiembre de 2026. De aquí salen la v7.10.0, del 24 de agosto de 2026, y la fecha de la v7.9.1, el 9 de abril de 2026 («sección 2 · Historia y relevo»).
  21. retrace --help de cmdline-tools 19.0, ejecutado localmente — ~/Library/Android/sdk/cmdline-tools/latest/bin/retrace --help Consultado el 25 de septiembre de 2026. De aquí sale que Retrace 8.9.27 lista exactamente --regex, --verbose, --info, --quiet y --verify-mapping-file-hash («sección 7 · retrace»).
  22. R8 9.2.4-dev de build-tools 37, SourceFile por modo y por regla, ejecutado localmente — java -cp build-tools/37.0.0/lib/d8.jar com.android.tools.r8.R8, con y sin --pg-compat, -keepattributes SourceFile, -renamesourcefileattribute SourceFile y -Dcom.android.tools.r8.enableMapIdInSourceFile=false, leído con dexdump Consultado el 25 de septiembre de 2026. De aquí sale que en full mode el valor por defecto es r8-map-id-<hash> y en modo compatibilidad SourceFile, y que la propiedad de sistema lo devuelve a SourceFile (secciones «8» y «9.2»).
  23. Use rules to troubleshoot optimization — https://developer.android.com/topic/performance/app-optimization/troubleshooting-rules Consultado el 25 de septiembre de 2026 (actualizada el 19 de mayo de 2026). De aquí salen las «rules generated by AAPT» entre los orígenes de reglas, el ejemplo de -whyareyoukeeping con aapt_rules.txt:4:1 y el aviso de que esas reglas no existen con la reducción optimizada de recursos («sección 5.1 · Los ficheros y su procedencia»).
  24. AGP — código fuente, etiqueta studio-2026.1.2 — https://android.googlesource.com/platform/tools/base/+/refs/tags/studio-2026.1.2/build-system/gradle-core/ Consultado el 25 de septiembre de 2026. Ficheros leídos: internal/scope/InternalArtifactType.kt, ArtifactTypeUtil.kt y internal/tasks/R8Task.kt (la ruta de configuration.txt, «sección 4 · Cómo se enciende y dónde viven las reglas»); LinkApplicationAndroidResourcesTask.kt, ProguardConfigurableTask.kt, R8ResourceShrinkingParameters.kt y BooleanOption.kt (cuándo llega aapt_rules.txt a R8, «sección 5.1 · Los ficheros y su procedencia»).
  25. R8 — código fuente, etiqueta 9.4.23 — https://r8.googlesource.com/r8/+/refs/tags/9.4.23/ Consultado el 25 de septiembre de 2026. Ficheros leídos: src/resourceshrinker/java/com/android/tools/r8/resourceshrinker/ResourceShrinkerState.java (los elementos del manifiesto que traza R8 y la poda de componentes no exportados) y src/main/java/com/android/tools/r8/utils/InternalOptions.java (enableManifestPruning, apagada por defecto). Secciones «5.1» y «5.3». Consultado de nuevo el 18 de octubre de 2026, en la etiqueta y en main: ResourceShrinkerState.java traza además, en application, los atributos backupAgent, appComponentFactory y zygotePreloadName (SPECIAL_APPLICATION_ATTRIBUTES, «sección 5.1 · Los ficheros y su procedencia»).
  26. aapt2 link --proguard, ejecutado localmente — aapt2 2.20-15087165 de build-tools 37.0.0; opción documentada en https://developer.android.com/tools/aapt2 Consultado el 25 de septiembre de 2026. De aquí sale el aapt_rules.txt de un manifiesto mínimo, con una regla y su línea de origen por componente («sección 5.1 · Los ficheros y su procedencia»).
  27. androidx.annotation:annotation-jvm:1.11.0 y AGP 9.4.1 en Google Maven — https://dl.google.com/android/maven2/androidx/annotation/annotation-jvm/1.11.0/ y https://dl.google.com/android/maven2/com/android/tools/build/gradle/9.4.1/ Consultado el 25 de septiembre de 2026; los dos JAR coinciden con el .sha1 publicado. Del primero, META-INF/proguard/androidx-annotations.pro; del segundo, com/android/build/gradle/proguard-common.txt («sección 5.2 · Las reglas que AGP empaqueta de verdad»).
  28. Android Gradle plugin 3.2.0 y 3.3.0 release notes — https://developer.android.com/build/releases/past-releases/agp-3-2-0-release-notes y https://developer.android.com/build/releases/past-releases/agp-3-3-0-release-notes Consultado el 18 de octubre de 2026. Del primero, R8 como vista previa que se activa con android.enableR8=true; del segundo, que con useProguard false el plugin usa R8 en lugar de ProGuard («sección 2 · Historia y relevo»).
  29. ProGuard manual — Release notes y Gradle plugin — https://github.com/Guardsquare/proguard/blob/master/docs/md/manual/releasenotes.md y https://www.guardsquare.com/manual/setup/gradleplugin Consultado el 18 de octubre de 2026. De aquí salen el plugin com.guardsquare.proguard de ProGuard 7.1 (junio de 2021), su motivo —«AGP 7 will no longer allow developers to disable R8 with the android.enableR8 Gradle property»— y el rango «AGP version 4.x - AGP 7.x» de su manual («sección 2 · Historia y relevo»). Del manual de la etiqueta v7.10.0, configuration/usage.md, sale que -renamesourcefileattribute escribe la cadena constante que se le indique (secciones «2» y «9.2»).
  30. R8 y AGP — código fuente, rama principal — https://r8.googlesource.com/r8/+/refs/heads/main/src/main/java/com/android/tools/r8/ y https://android.googlesource.com/platform/tools/base/+/refs/heads/mirror-goog-studio-main/build-system/gradle-core/src/main/java/com/android/build/gradle/options/BooleanOption.kt Consultado el 18 de octubre de 2026. Ficheros leídos: shaking/ProguardConfigurationParser.java y shaking/ProguardConfigurationParserOptions.java (la conversión de un -keep sin miembros en una regla con <init>() y la propiedad com.android.tools.r8.enableLegacyFullModeForKeepRules, «sección 8 · R8 full mode»); naming/SourceFileRewriter.java (isDefaultOrEmpty, que trata PG como el valor por defecto, «sección 9.2 · El atributo SourceFile»); y, de AGP, BooleanOption.kt (legacy y strict full mode for keep rules, «sección 8 · R8 full mode»).
  31. R8 9.2.4-dev de build-tools 37, el experimento de la «sección 11.2 · Generar un mapping.txt real (ejecutada)», ejecutado localmente — javac 21.0.10, java -cp build-tools/37.0.0/lib/d8.jar com.android.tools.r8.R8 con las reglas, las fuentes y las órdenes publicadas en la «sección 11.2 · Generar un mapping.txt real (ejecutada)», contra platforms/android-35/android.jar; com.android.tools.r8.ExtractMarker; com.android.tools.r8.retrace.Retrace de d8.jar y retrace 8.9.27 de cmdline-tools; dalvikvm en un emulador de Android 14 (sdk_phone64_arm64, UE1A.230829.036.A1); y ProGuard 7.9.1 con el config.pro de la «sección 11.3 · retrace, y los dos programas que se llaman igual» Ejecutado el 18 de octubre de 2026; repetido en un directorio limpio, los cuatro mapping.txt y los cuatro classes.dex salen idénticos byte a byte. De aquí salen todos los ejemplos de las «secciones 6.1 · El preámbulo de metadatos» a 6.6, las trazas de la «sección 7 · retrace», el marcador y la salida de ExtractMarker de la «sección 9.1 · El marcador ~~R8{…} dentro del DEX», la propagación de un marcador ~~D8 de un .class pasado por D8 --classfile al DEX de R8 («sección 9.1 · El marcador ~~R8{…} dentro del DEX») y todo el contenido de las secciones «11.2» y «11.3».
  32. R8 — código fuente en el commit del d8.jar de build-tools 37 — https://r8.googlesource.com/r8/+/084a89126ae0596c599143df57a654646af28313/src/main/java/com/android/tools/r8/ y la misma ruta en refs/heads/main, leídos con ?format=TEXT Consultado el 18 de octubre de 2026. Ficheros leídos: utils/InternalOptions.java (getPackageObfuscationMode() devuelve REPACKAGE cuando la configuración no fija modo y la salida es DEX; en el commit, tras enableRepackagingByDefault = true, y en main sin esa opción), repackaging/RepackagingConstraintGraph.java (qué clases no se pueden mover) («sección 6.2 · Mapeo de clase»); utils/positions/MappedPositionToClassNameMapperBuilder.java (cuándo se escribe residualsignature, «sección 6.6 · Los comentarios de metadatos por elemento»); dex/ApplicationWriter.java (computeMarkerStrings), jar/CfApplicationClassWriter.java (MARKER_STRING_CONSTANT_POOL_INDEX), graph/JarClassFileReader.java y dex/DexParser.java (cómo pasan los marcadores de las entradas a la salida, «sección 9.1 · El marcador ~~R8{…} dentro del DEX»); y, de main, retrace/StringRetrace.java (el <OR> de las líneas ambiguas, «sección 7 · retrace»).
  33. Redex — https://github.com/facebook/redex, ficheros README.md, liblocator/locator.h y opt/renameclasses/RenameClassesV2.cpp, y https://api.github.com/repos/facebook/redex Consultado el 18 de octubre de 2026. De aquí salen que Redex es un optimizador de DEX con licencia MIT, que el pase RenameClassesPassV2 da a las clases nombres de la forma LX/nnnnnn; con el índice global en base 62 y que el número de cifras depende del número de clases («sección 9.1 · El marcador ~~R8{…} dentro del DEX»).
  34. Muestrario de octubre de 2026 — descrito en «El muestrario». Las cifras de las «secciones 1 · Qué es y por qué existe» a 4 y 8 a 10 salen de un script que lee las medidas estáticas del muestrario, sin ejecutar ninguna app. Para repetirlas: MUESTRARIO_RAIZ=<carpeta del muestrario> python3 -I scripts/muestrario/cifras/ofuscacion_y_protectores_1.py --salida cifras.json. Tres grupos de cifras piden leer un DEX entero y, por eso, copias locales de unas pocas piezas: las clases de Netflix, la variante de la métrica con las clases internas y los diccionarios de ofuscación; para ellas se añade --copias <carpeta vacía> --copiar. Las cifras derivadas de varias celdas (por ejemplo, las 148 de 1.993 apps con R8 8.x en modo compatibility) son aritmética sobre la tabla de versiones de R8. Las primeras clases de Gmail salen del dexdump de la «sección 6.2 · Mapeo de clase». Medidas hechas con el muestrario descargado entre el 19 y el 27 de octubre de 2026.