Configurar ProGuard o DexGuard para aplicaciones de Android

Siga estas instrucciones para admitir ProGuard o DexGuard con el agente de Android. Consulte nuestra compatibilidad y requisitos de Android y, si ha instalado previamente el SDK del agente de Android, siga los pasos antes de actualizar a la última versión con ProGuard o DexGuard.

Configurar ProGuard

Para agregar soporte para ProGuard:

Agregue una exclusión a su aplicación; Por ejemplo:
- Para admitir la instrumentación de New Relic, agregue keep class.
- Para desactivar las advertencias relacionadas con problemas no resueltos, agregue dont warn.
- Para conservar los números de línea para los informes de fallos, agregue LineNumberTable.
- Para conservar la información stack para las excepciones manejadas, agregue SourceFile y EnclosingMethod.
Agregue lo siguiente a su archivo de configuración de ProGuard (proguard.cfg, proguard-android.txt, proguard-rules.pro, etc.):
```
-keep class com.newrelic.** { *; }
-dontwarn com.newrelic.**
-keepattributes Exceptions, Signature, InnerClasses, LineNumberTable, SourceFile, EnclosingMethod

##
## NewRelic Gradle plugin 7.x may require the following additions:
##
# Retain generic signatures of TypeToken and its subclasses if R8 version 3.0 full-mode is enabled.
# https://r8.googlesource.com/r8/+/refs/heads/master/compatibility-faq.md#r8-full-mode
-keepattributes Signature
-keep class com.newrelic.com.google.gson.reflect.TypeToken { *; }
-keep class * extends com.newrelic.com.google.gson.reflect.TypeToken
# For using GSON @Expose annotation
-keepattributes *Annotation*
```
Limpia y reconstruye tu proyecto.
Ejecute su aplicación en un emulador o dispositivo para comenzar a ver datos en la páginaOverview de su aplicación móvil.
Opcional: utilice la página Settings para personalizar su aplicación móvil.

Si no aparece ningún dato, revise el resultado de logcat para detectar errores.

¿Te ha ayudado este documento con la instalación?

Soporte de biblioteca de red

La instrumentación de New Relic ocurre antes de que ProGuard ofusque su código. Para que estas bibliotecas estén correctamente instrumentadas, ProGuard no debe ofuscar sus clases.

A continuación se muestran ejemplos de reglas que se aplicarán para preservar estas clases. Esta no es una lista completa. Se necesitarán reglas diferentes según su biblioteca o versión.

Library	Rules
Apache http	`-keep class org.apache.http.** { ; } -dontwarn org.apache.http.*`
OkHttp 2	`-keep class com.squareup.okhttp.* { ; } -dontwarn com.squareup.okhttp.* -dontwarn okio.**`
OkHttp 3	`-keep class okhttp3.** { ; } -dontwarn okhttp3.* -dontwarn okio.**`
Reequipamiento 2	`-keep class retrofit2.** { ; } -dontwarn retrofit2.*`

Configurar DexGuard

DexGuard utiliza las mismas opciones de configuración que ProGuard y puede leer cualquier archivo de configuración de ProGuard preexistente. DexGuard también tiene su propio conjunto de opciones de configuración adicionales y proporciona configuraciones de muestra para muchos marcos de aplicaciones comunes.

Para agregar soporte para DexGuard:

Agregue DexGuard a su aplicación y configure el complemento Gradle de acuerdo con las instrucciones de DexGuard.
Cree un archivo dexguard-project.txt para contener opciones de configuración específicas de DexGuard y agregue:
```
-dontnote com.newrelic.agent.android.NewRelic
-dontnote com.newrelic.agent.android.harvest.crash.Crash
```

Una vez configurado el complemento DexGuard, verifique lo siguiente.

DexGuard 8.x: verifique que la configuración buildTypes de su aplicación sea similar a esta:

buildTypes {
    release {
        minifyEnabled false
        shrinkResources false
        proguardFile getDefaultDexGuardFile('dexguard-release.pro')
        proguardFile 'proguard-rules.pro'
        proguardFile 'dexguard-project.txt'
    } 
    ...

Limpia y reconstruye tu proyecto.
Ejecute su aplicación en un emulador o dispositivo para comenzar a ver datos en la páginaOverview de su aplicación móvil.
Opcional: utilice la página monitoreo de móviles Settings para personalizar su aplicación móvil.