Una regla keep es una línea de configuración que le dice a R8, el optimizador de Android, qué código no debe quitar ni renombrar al compilar la app. Cuando una librería trae reglas keep demasiado amplias, R8 pierde margen para optimizar tu app entera. Así lo explica el Android Developers Blog en una entrada del 17 de noviembre de 2026, firmada por Breana Tate.
Qué es una regla keep y de dónde salen
R8 recorre tu código, quita lo que no se usa y acorta nombres. Para no romper lo que se alcanza solo por reflexión o desde código nativo, existen las reglas keep. Algunas las escribes tú; otras vienen dentro de cada librería como consumer rules, empaquetadas en el AAR o el JAR. El resultado final es la suma de tus reglas y las de todas tus dependencias.
La regla amplia que frena la optimización
El artículo pone como ejemplo habitual una regla de paquete completo:
-keep public class com.google.android.gms.** { *; }Mantiene todo el paquete, se use o no, y R8 no puede optimizarlo. Según Google, una regla así puede incluso pisar reglas más estrechas que otra librería ya trae para el mismo código. Importa porque Google Play ha introducido umbrales de optimización de código DEX para apps y juegos, y las métricas de Play Console reflejan el efecto combinado de tus reglas y las de tus librerías. El artículo no cuantifica esos umbrales.
Cómo se escribe una regla estrecha
La alternativa es proteger solo lo que de verdad se alcanza por reflexión. Un ejemplo nuestro, no del artículo:
# solo el constructor que se instancia por reflexión
-keep class com.ejemplo.lib.Plugin { <init>(); }Indicas el punto de entrada y R8 construye el grafo de referencias y elimina el resto. Esto sigue valiendo para librerías ya ofuscadas, porque R8 puede optimizar más según lo que use tu app.
Qué recomienda Google a quien publica librerías
Las recomendaciones del artículo, resumidas:
- Preferir código generado en tiempo de compilación en lugar de reflexión. Hilt es el ejemplo que cita para serialización e inyección de dependencias.
- Cuando la reflexión es inevitable, como con dependencias opcionales, acompañarla de reglas estrechas que protejan solo los puntos de entrada.
- Para código nativo, dar reglas para todas las clases que usa JNI. En adaptadores de anuncios, usar reglas condicionales que solo se activan si la app incluye ese adaptador.
- Enviar las reglas dentro de la librería, en sus consumer rules, y no dejarlas solo en la documentación.
- No usar
-keepnamespara que las trazas sean legibles: Firebase Crashlytics, Play Console y Logcat desofuscan, y subir el archivo de mapeo a la SDK Console permite ver trazas legibles.
Cómo comprobar qué te traen tus dependencias
El artículo propone dos herramientas: el R8 Configuration Analyzer, para ver qué reglas vienen de cada librería, y el comando analyze de Android CLI, que revisa las clases, métodos y campos que mantiene un AAR o un JAR y permite comparar versiones. Si una librería te trae reglas de paquete completo, lo razonable es actualizarla antes de escribir tu propia regla que la sustituya.
Lo que el artículo no dice
No da ninguna cifra: no sabemos cuánto mejora el arranque, la memoria o el tamaño al estrechar las reglas, ni cuáles son los umbrales de Play. Las Keep annotations de Jetpack, que generan reglas en compilación, siguen en alfa. Y el propio texto insiste en que las reglas estrechas deben seguir cubriendo la reflexión real: la idea es mantener solo lo necesario, no quitar reglas sin probar.
