// post · caprini.dev

Reglas keep de R8: cuáles frenan la optimización de tu app

Regla keep amplia de R8 con el paquete com.google.android.gms en un bloque de código
2026-11-18·Caprini Dev
#android

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 -keepnames para 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.

Nuestra opinión

Esto es opinión nuestra, no del artículo: en una app propia, el primer paso útil no es escribir reglas nuevas sino mirar cuáles te llegan ya. Antes de nada, prueba la build de release en tus recorridos críticos, como contamos en qué es R8 y qué logró Grab con él, y después revisa el informe de reglas de tus dependencias. Más guías de este tipo están en Android en español: la guía.

Fuente: Ship smarter keep rules: How library providers can unblock app-level DEX code optimization, Android Developers Blog, 17 de noviembre de 2026.

Más del día a día en el diario de MOFA Labs #1: qué probamos, qué falló y cuánto dio.

Recibe la versión PDF y un aviso cuando cambie una norma de Google Play

Te apuntamos al boletín semanal de caprini.dev (Android en español, una vez a la semana, sin publicidad). Te mandamos un correo para confirmar. Baja con un clic cuando quieras. Responsable: Asociación de Amigos del Yoga y la Botánica (MOFA Labs). Más información en la política de privacidad.

O descárgalo sin dejar tu correo