R8 y ProGuard
Antes conviene leer «Anatomía de un APK», «Formato DEX»
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:
- «Lógica fuera del
DEX»: la app usa un marco como Flutter, Unity o React Native, y su código vive en una biblioteca nativa o en un paquete de JavaScript. - «Empaquetador o protector»: un programa esconde el código real y lo descifra al arrancar («sección 10.6 · Qué no ve la métrica»).
- PairIP: la protección que Google Play puede añadir a un
APK(«sección 9.5 · ¿Cambia Google Play el DEX?»).
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
R8son sintaxis deProGuard, y los ficheros se siguen llamandoproguard-rules.pro. - El formato de
mapping.txt.R8produce un superconjunto compatible («sección 6 · mapping.txt: la gramática exacta»). - La cadena
PGen el atributoSourceFile(«sección 9.2 · El atributo SourceFile»), queR8trata igual que el valor por defecto aunqueProGuardno la escriba salvo que se le pida con-renamesourcefileattribute PG. - Quien sigue usándolo. Proyectos antiguos y builds no-Android que invocan
ProGuarddirectamente. Proyectos Android con el plugin de Gradlecom.guardsquare.proguard, que Guardsquare publica desdeProGuard7.1 porqueAGP7 ya no deja desactivarR8conandroid.enableR8: se apaga la minificación deAGPy el plugin ejecutaProGuard(su manual lo documenta paraAGP4.x a 7.x). YDexGuard, que es «compatible hacia atrás conProGuard» 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
DEX035 (el formato anterior aD8), con el 58 % de los nombres de uno a tres caracteres:com.davidshewitt.admincontrol5. - Candidata en F-Droid con
D81.3.49 yDEX035, 58 %:com.gbeatty.arxiv39. - Mercado chino, 1.970 clases con
SourceFile«ProGuard» y sin marcador:com.tencent.tmgp.cod3153. - Mercado chino, sin marcador,
DEX038, 70 %:com.baidu.searchbox513934592.
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.
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-namesdeaapt2, 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
R89.2.37: suclasses.dexdefine 83.498 identificadores, el 7,5 % con uno a tres caracteres, con mediana de longitud 12 ySourceFile«SourceFile» (con todos susDEX: 5,0 % y mediana 13). - Termux 1022, con
R82.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 deSourceFile). Con sus 5DEXsube 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:
R8omiteoriginalRangecuando es igual aminifiedRange. La condición literal es!originalRange.equals(minifiedRange). Así que1:3:void <init>(java.lang.String):7:7y1:8:void main(java.lang.String[]):5:12conviven con líneas sin la segunda mitad, como11:11:void main(java.lang.String[]) -> mainde la compilación optimizada: línea 11 del binario, línea 11 del fuente.- Un
Range«cardinal» se serializa como un solo número, no comofrom:to. De ahí la tercera forma que documenta el javadoc deProguardMapReader:range COLON signature COLON number ARROW name. Salida real, de la compilación optimizada:3:5:void main(java.lang.String[]):6 -> main. - 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:
- El constructor por defecto
<init>()no se conserva implícitamente al conservar una clase. - Tampoco se conserva para tipos que solo se usan con
ldc,instanceofocheckcast. - Las clases que contienen campos o métodos casados por una
-keepclassmembersno se consideran implícitamente instanciadas. - Los métodos
defaultno se conservan implícitamente como métodos abstractos. - 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. - Al optimizar o minificar, el atributo
SourceFilesiempre se reescribe aSourceFilesalvo que se use-renamesourcefileattribute. En elR89.2.4-dev de build-tools 37 el valor por defecto en full mode esr8-map-id-<hash>(«sección 9.2 · El atributo SourceFile»). - 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:
~~R82.2.71,r8-modecompatibility. - Droid-ify 780:
~~R89.4.14,r8-modefull.
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) ycom.whatsapp.w4b. - De ByteDance:
com.ss.android.ugc.aweme,com.ss.android.ugc.aweme.lite,com.ss.android.ugc.trill,com.zhiliaoapp.musicallyycom.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-iden 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:
PGen 71.849 de las 72.661 clases de todos susDEX, con~~D89.6.0-alpha02. - YouTube 21.41.531: 55.621 de 56.360 clases,
~~D89.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,
~~D89.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.gmssin renombrar junto a clasesLa;,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, tienencom.google.*entre los 40 paquetes más poblados de algúnDEX1.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 (enclasses3.dexy enlib/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 9DEX(83,6 %) están en un paquete llamadoo, y de sus 298 clases decom/google/android/gms, 271 tienen un nombre de más de tres caracteres y solo 14 están eninternal/cast. Su compilador es un~~D8«main» en los 9DEX, sin~~R8.- Clases sintéticas con nombres reconocibles:
$$ExternalSyntheticLambda<n>,$$InternalSyntheticLambda$<n>$<sha256>$<m>,$$ExternalSyntheticApiModelOutline.R8yD8los generan y no los renombran. Su presencia identifica la herramienta que compiló las bibliotecas o el paso inicial, no necesariamente la última que tocó elDEX. 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
R8hace por defecto («sección 6.2 · Mapeo de clase»), o-repackageclasses/-flattenpackagehierarchy. Elclasses.dexde Gmail 2026.10.12 empieza literalmente porLa;,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 yR8propio, 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 %). ConD8la 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ónkotlin.Metadata: en las apps con el plugin de Kotlin yR8, elDEXla conserva en 179 de 240 (75 %) en las más instaladas y en 146 de 1.320 (11 %) en las de F-Droid, y conD8en 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 deR8. Shazam 16.64.0, por ejemplo, conserva 17 entradas.kotlin_moduleconR88.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_itempara muchos métodos:R8codifica las líneas por PC y hace que muchoscode_itemcompartan el mismodebug_info_item. No es ausencia de información de depuración: en una compilación de prueba con elR89.2.4 de build-tools 37, los 48code_itemtienendebug_info_off != 0y apuntan a solo 3debug_info_itemdistintos, con-keepattributes LineNumberTabley sin ella. En elclasses.dexde Droid-ify 780 (R89.4.14), 30.460code_itemapuntan a 1.190debug_info_itemdistintos, 29.441 de ellos a un item que comparten con otros, y solo 25 tienendebug_info_off == 0. Como huella separa bienR8deD8: tienen cinco o máscode_itempor cadadebug_info_item2.038 de 2.763 apps de F-Droid conR8propio (74 %), y 0 de 1.851 de las que solo llevanD8. En Google Play la separación se rompe por las apps de Google: lo cumplen 68 de 169 de las más instaladas con soloD8(40 %), y 67 de esas 68 son de Google. Lo que hay que contar son esoscode_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:R89.4.14,SourceFile«nombre real» y mediana 10, igual en Google Play y en la web del autor.com.brave.browser:R89.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,R89.3.16,SourceFile«SourceFile» y mediana 4; en la web, sin marcador,SourceFile«SourceFile» y mediana 6.com.dywx.larkplayer:R88.13.19 ySourceFile«SourceFile» en las dos; mediana 3 en Google Play y 6 en la web.com.noprestige.kanaquiz:R88.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 elclass_data_itemde cadaclass_def_itemy se siguen losfield_idx_diff/method_idx_diff, no se toman las tablas enteras: las tablas incluyen referencias ajava.lang.String.lengthy 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 tomaBar. Los sufijos$1,$2de 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 soloDEXde 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.ugadaypasa 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_sizedelstring_data_item, lo que evita tener que decodificarMUTF-8para 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 conO,0yo, 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), conIl1, mediana 3, ofuscada. - Un juego de Tencent, Ace Racer (
com.tencent.tmgp.aceracer), conO0o.
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 |
| 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 |
| 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.qrcodedisplayer4: mediana 6, 38 % de nombres de uno a tres caracteres.app.cleartray342: mediana 7, 38 %.app.taskdav2: mediana 5, 48 %.be.ugent.zeus.hydra.open37400: mediana 5, 48 %.btools.routingapp56: mediana 6, 48 %.cash.p.terminal259: 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
- 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 deAGP(«sección 8 · R8 full mode»). Consultado de nuevo el 18 de octubre de 2026: de aquí sale que enAGP8.12 y 8.13 la optimización de recursos deR8hay que activarla conandroid.r8.optimizedResourceShrinking=true(«sección 3 · Los tres trabajos, que no son el mismo»). - 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 elAAB,configuration.txty la invocación deretrace(secciones «4» y «7»). Consultado de nuevo el 25 de septiembre de 2026: sigue dando la ruta deconfiguration.txtsin la variante («sección 4 · Cómo se enciende y dónde viven las reglas»). - Add keep rules / Keep rules overview / Optimize your library —
https://developer.android.com/topic/performance/app-optimization/add-keep-rules,
.../keep-rules-overviewy.../library-optimizationConsultados 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 yJNIde 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». - 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.txtyusage.txty 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 escribiendomappings, en plural. - 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
retracede la «sección 7 · retrace». - 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.fullModepasa atruepor defecto («sección 8 · R8 full mode»). - 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
ProGuardporR8(«sección 2 · Historia y relevo»). - 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
R88.2 no hace falta-keepattributes SourceFilepara 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»). - 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-all0:65535, y la semántica desourceFile,synthesized,rewriteFrame,outline,outlineCallsiteyresidualsignature(secciones «6.1», «6.4» y «6.6»). Consultado de nuevo el 18 de octubre de 2026: sus ejemplos desynthesizedusan comillas simples en el JSON y los desourceFiley la versión, dobles («sección 6.6 · Los comentarios de metadatos por elemento»). - 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.javayRange.java(serialización exacta de la «sección 6.4 · Mapeo de método y los rangos de línea»),ProguardMapMarkerInfo.javayMapVersion.java(preámbulo y versión estable de la «sección 6.1 · El preámbulo de metadatos»),SourceFileRewriter.javaygraph/DexItemFactory.java(valores centinelaSourceFile,PGyr8-map-id-de la «sección 9.2 · El atributo SourceFile»),dex/Marker.java(valores de# compiler:) ynaming/mappinginformation/*.java(losidde la «sección 6.6 · Los comentarios de metadatos por elemento»). - 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.txty las reglas deproguard-common.txtde 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-keepattributesson las del bloque de la «sección 5.2 · Las reglas que AGP empaqueta de verdad», con las tres deILicensingServicey las tres-keepclasseswithmembersde@android.support.annotation.Keep; el resto son comentarios y reglas-dontnotey-dontwarn. - 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.jarde la «sección 7 · retrace». - 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 deProGuardde la «sección 2 · Historia y relevo». - 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»).
- 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. - Dalvik executable format — https://source.android.com/docs/core/runtime/dex-format
Consultado el 12 de agosto de 2026. De aquí sale
source_file_idxdelclass_def_itemy el papel dedalvik.annotation.Signature(secciones «8» y «9.2»). - ProGuard 7.9.1 y Retrace 8.9.27 ejecutados localmente — ProGuard instalado con
Homebrew y
retracedecmdline-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 unmapping.txtque no corresponde al binario. - 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.strictFullModeForKeepRulesy 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 deconfiguration.txtcon la variante («sección 4 · Cómo se enciende y dónde viven las reglas»). - 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, condexdumpy un lector decode_itemen 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 inlineadaR8$$REMOVED$$CLASS$$0frente a la inalcanzable, que solo va ausage.txt(«sección 6.2 · Mapeo de clase»), losdebug_info_itemcompartidos de la «sección 9.3 · Otras huellas» y el comentariosourceFilesin-keepattributes SourceFilede la «sección 11.3 · retrace, y los dos programas que se llaman igual». - 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 lav7.10.0, del 24 de agosto de 2026, y la fecha de lav7.9.1, el 9 de abril de 2026 («sección 2 · Historia y relevo»). retrace --helpdecmdline-tools19.0, ejecutado localmente —~/Library/Android/sdk/cmdline-tools/latest/bin/retrace --helpConsultado el 25 de septiembre de 2026. De aquí sale que Retrace 8.9.27 lista exactamente--regex,--verbose,--info,--quiety--verify-mapping-file-hash(«sección 7 · retrace»).- R8 9.2.4-dev de build-tools 37,
SourceFilepor 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 SourceFiley-Dcom.android.tools.r8.enableMapIdInSourceFile=false, leído condexdumpConsultado el 25 de septiembre de 2026. De aquí sale que en full mode el valor por defecto esr8-map-id-<hash>y en modo compatibilidadSourceFile, y que la propiedad de sistema lo devuelve aSourceFile(secciones «8» y «9.2»). - 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
-whyareyoukeepingconaapt_rules.txt:4:1y el aviso de que esas reglas no existen con la reducción optimizada de recursos («sección 5.1 · Los ficheros y su procedencia»). AGP— código fuente, etiquetastudio-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.ktyinternal/tasks/R8Task.kt(la ruta deconfiguration.txt, «sección 4 · Cómo se enciende y dónde viven las reglas»);LinkApplicationAndroidResourcesTask.kt,ProguardConfigurableTask.kt,R8ResourceShrinkingParameters.ktyBooleanOption.kt(cuándo llegaaapt_rules.txtaR8, «sección 5.1 · Los ficheros y su procedencia»).R8— código fuente, etiqueta9.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 trazaR8y la poda de componentes no exportados) ysrc/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 enmain:ResourceShrinkerState.javatraza además, enapplication, los atributosbackupAgent,appComponentFactoryyzygotePreloadName(SPECIAL_APPLICATION_ATTRIBUTES, «sección 5.1 · Los ficheros y su procedencia»).aapt2 link --proguard, ejecutado localmente —aapt22.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 elaapt_rules.txtde un manifiesto mínimo, con una regla y su línea de origen por componente («sección 5.1 · Los ficheros y su procedencia»).androidx.annotation:annotation-jvm:1.11.0yAGP9.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 dosJARcoinciden con el.sha1publicado. 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»).- 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,
R8como vista previa que se activa conandroid.enableR8=true; del segundo, que conuseProguard falseel plugin usaR8en lugar deProGuard(«sección 2 · Historia y relevo»). - 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.proguarddeProGuard7.1 (junio de 2021), su motivo —«AGP 7 will no longer allow developers to disable R8 with theandroid.enableR8Gradle property»— y el rango «AGP version 4.x - AGP 7.x» de su manual («sección 2 · Historia y relevo»). Del manual de la etiquetav7.10.0,configuration/usage.md, sale que-renamesourcefileattributeescribe la cadena constante que se le indique (secciones «2» y «9.2»). R8yAGP— 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.javayshaking/ProguardConfigurationParserOptions.java(la conversión de un-keepsin miembros en una regla con<init>()y la propiedadcom.android.tools.r8.enableLegacyFullModeForKeepRules, «sección 8 · R8 full mode»);naming/SourceFileRewriter.java(isDefaultOrEmpty, que trataPGcomo el valor por defecto, «sección 9.2 · El atributo SourceFile»); y, deAGP,BooleanOption.kt(legacy y strict full mode for keep rules, «sección 8 · R8 full mode»).- 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 —
javac21.0.10,java -cp build-tools/37.0.0/lib/d8.jar com.android.tools.r8.R8con las reglas, las fuentes y las órdenes publicadas en la «sección 11.2 · Generar un mapping.txt real (ejecutada)», contraplatforms/android-35/android.jar;com.android.tools.r8.ExtractMarker;com.android.tools.r8.retrace.Retraceded8.jaryretrace8.9.27 decmdline-tools;dalvikvmen un emulador de Android 14 (sdk_phone64_arm64,UE1A.230829.036.A1); yProGuard7.9.1 con elconfig.prode 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 cuatromapping.txty los cuatroclasses.dexsalen 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 deExtractMarkerde la «sección 9.1 · El marcador ~~R8{…} dentro del DEX», la propagación de un marcador~~D8de un.classpasado porD8 --classfilealDEXdeR8(«sección 9.1 · El marcador ~~R8{…} dentro del DEX») y todo el contenido de las secciones «11.2» y «11.3». R8— código fuente en el commit deld8.jarde build-tools 37 — https://r8.googlesource.com/r8/+/084a89126ae0596c599143df57a654646af28313/src/main/java/com/android/tools/r8/ y la misma ruta enrefs/heads/main, leídos con?format=TEXTConsultado el 18 de octubre de 2026. Ficheros leídos:utils/InternalOptions.java(getPackageObfuscationMode()devuelveREPACKAGEcuando la configuración no fija modo y la salida esDEX; en el commit, trasenableRepackagingByDefault = true, y enmainsin 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 escriberesidualsignature, «sección 6.6 · Los comentarios de metadatos por elemento»);dex/ApplicationWriter.java(computeMarkerStrings),jar/CfApplicationClassWriter.java(MARKER_STRING_CONSTANT_POOL_INDEX),graph/JarClassFileReader.javaydex/DexParser.java(cómo pasan los marcadores de las entradas a la salida, «sección 9.1 · El marcador ~~R8{…} dentro del DEX»); y, demain,retrace/StringRetrace.java(el<OR>de las líneas ambiguas, «sección 7 · retrace»).- Redex — https://github.com/facebook/redex, ficheros
README.md,liblocator/locator.hyopt/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 deDEXcon licencia MIT, que el paseRenameClassesPassV2da a las clases nombres de la formaLX/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»). - 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 unDEXentero 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 conR88.x en modocompatibility) son aritmética sobre la tabla de versiones deR8. Las primeras clases de Gmail salen deldexdumpde la «sección 6.2 · Mapeo de clase». Medidas hechas con el muestrario descargado entre el 19 y el 27 de octubre de 2026.