Disattiva Firebase Performance Monitoring

Durante lo sviluppo e la prova dell'app, potresti trovare utile disattivarePerformance Monitoring.

Ad esempio, per disattivando Performance Monitoring durante il processo di creazione dell'app, puoi:

• Disattiva alcune funzionalità di Performance Monitoring (ad esempio quelle fornite dai plug-in Gradle Performance Monitoring) nelle build di debug, ma riabilita le funzionalità per build di release.

• Disattiva Performance Monitoring durante la creazione dell'app, ma consenti all'app di riattivarlo in fase di esecuzione.

• Disattiva Performance Monitoring durante la creazione della tua app e non consentire all'app di e riattivarla in fase di runtime.

Puoi anche creare la tua app con Performance Monitoring attivato, ma usa Firebase Remote Config per ottenere possibilità di disattivare (e riattivare) Performance Monitoring nella tua app di produzione. Con puoi anche configurare l'app in modo che gli utenti possano attivare o disattivare utilizzando Performance Monitoring.

Disattiva Performance Monitoring durante il processo di compilazione dell'app

Puoi disabilitare Performance Monitoring durante il processo di compilazione disattivando il plug-in Gradle Performance Monitoring e/o tramite Disattivazione della libreria Android Performance Monitoring.

Durante lo sviluppo e il debug, disattivare il plug-in è utile perché strumentazione da parte del plug-in possono contribuire ad aumentare i tempi di compilazione. Potresti, però, considerare di conservare libreria attivata per continuare a visualizzare i dati sul rendimento tracce avvio app, app in primo piano e app in background così come qualsiasi tracce di codice personalizzate all'interno dell'app.

Disattiva il plug-in Gradle di Performance Monitoring

Puoi disattivare il plug-in Performance Monitoring aggiungendo un flag instrumentationEnabled utilizzando le seguenti opzioni:

• Proprietà estensione: disattiva il plug-in per una variante di build specifica al momento della compilazione

• Project Property: disattiva il plug-in per tutte le varianti di build al momento della compilazione

Disattiva il plug-in tramite un flag Extension Property

Se utilizzi un flag extensions Property, puoi disattivare il plug-in Performance Monitoring per una variante di build specifica al momento della compilazione.

1. Nel file Gradle a livello di root (a livello di progetto) (<project>/build.gradle.kts o <project>/build.gradle), assicurati che la dipendenza del plug-in Android per Gradle sia specificata come v3.4.0 o successiva.

   Per le versioni precedenti del plug-in Android Gradle, puoi comunque disabilitarlo il plug-in Performance Monitoring per una variante di build specifica, ma il tempo di compilazione per quella variante non verrà eliminato completamente.

2. Aggiungi il flag seguente al file Gradle del modulo (a livello di app) (di solito <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle), quindi impostalo su false per disattivarlo il plug-in Performance Monitoring.

   Kotlin

   import com.google.firebase.perf.plugin.FirebasePerfExtension
   
   // ...
   
   android {
     // ...
     buildTypes {
       getByName("debug") {
         configure<FirebasePerfExtension> {
           // Set this flag to 'false' to disable @AddTrace annotation processing and
           // automatic monitoring of HTTP/S network requests
           // for a specific build variant at compile time.
           setInstrumentationEnabled(false)
         }
       }
     }
   }

   Groovy

   android {
     // ...
     buildTypes {
       debug {
         FirebasePerformance {
           // Set this flag to 'false' to disable @AddTrace annotation processing and
           // automatic monitoring of HTTP/S network requests
           // for a specific build variant at compile time.
           instrumentationEnabled false
         }
       }
     }
   }

Disattiva il plug-in tramite un flag di proprietà del progetto

Se utilizzi un flag Project Property, puoi disattivare il plug-in Performance Monitoring per tutte le varianti di build al momento della compilazione.

Aggiungi il seguente flag al file gradle.properties, quindi impostalo su false per disattivare il plug-in Performance Monitoring.

// ...

// Set this flag to 'false' to disable @AddTrace annotation processing and
// automatic monitoring of HTTP/S network requests
// for all build variants at compile time.
firebasePerformanceInstrumentationEnabled=false

Disattivare la libreria Android Performance Monitoring

Se disattivi la libreria Performance Monitoring in fase di compilazione, puoi scegliere se per consentire alla tua app di attivare la libreria in fase di runtime.

Disattiva la libreria in fase di compilazione, ma consenti alla tua app di abilitarla in fase di runtime

Aggiungi il seguente elemento <meta-data> a AndroidManifest.xml della tua app file:

  <application>
    <meta-data
      android:name="firebase_performance_collection_enabled"
      android:value="false" />
  </application>

Disattiva la libreria in fase di compilazione, ma non consentire all'app di abilitarla in fase di runtime

Aggiungi il seguente elemento <meta-data> a AndroidManifest.xml della tua app file:

  <application>
    <meta-data
      android:name="firebase_performance_collection_deactivated"
      android:value="true" />
  </application>

Disattiva la tua app in fase di runtime utilizzando Remote Config

Firebase Remote Config ti consente di modificare il comportamento e l'aspetto della tua app, quindi è il modo ideale per consentirti di disattivare Performance Monitoring di cui è stato eseguito il deployment della tua app.

Per disattivare la raccolta dei dati di Performance Monitoring alla successiva avviata dell'app Android, utilizza il codice di esempio riportato di seguito. Per ulteriori informazioni sull'utilizzo Remote Config in un'app per Android, consulta Utilizza Firebase Remote Config su Android.

1. Assicurati che Remote Config si trovi nella sezione dependencies di File Gradle del modulo (a livello di app) (di solito <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle):

   Kotlin+KTX

     implementation("com.google.firebase:firebase-config-ktx:22.0.0")
   

   Java

     implementation("com.google.firebase:firebase-config:22.0.0")
   

2. Configura Remote Config e disabilita Performance Monitoring se perf_disable è impostato su true:

   Kotlin+KTX

   // Setup remote config
   val config = Firebase.remoteConfig
   
   // You can uncomment the following two statements to permit more fetches when
   // validating your app, but you should comment out or delete these lines before
   // distributing your app in production.
   // val configSettings = remoteConfigSettings {
   //     minimumFetchIntervalInSeconds = 3600
   // }
   // config.setConfigSettingsAsync(configSettings)
   // Load in-app defaults from an XML file that sets perf_disable to false until you update
   // values in the Firebase Console
   
   // Observe the remote config parameter "perf_disable" and disable Performance Monitoring if true
   config.setDefaultsAsync(R.xml.remote_config_defaults)
       .addOnCompleteListener { task ->
           if (task.isSuccessful) {
               Firebase.performance.isPerformanceCollectionEnabled = !config.getBoolean("perf_disable")
           } else {
               // An error occurred while setting default parameters
           }
       }
   MainActivity.kt

   Java

   // Setup remote config
   final FirebaseRemoteConfig config = FirebaseRemoteConfig.getInstance();
   
   // You can uncomment the following two statements to permit more fetches when
   // validating your app, but you should comment out or delete these lines before
   // distributing your app in production.
   // FirebaseRemoteConfigSettings configSettings = new FirebaseRemoteConfigSettings.Builder()
   //       .setMinimumFetchIntervalInSeconds(3600)
   //       .build();
   // config.setConfigSettingsAsync(configSettings);
   // Load in-app defaults from an XML file that sets perf_disable to false until you update
   // values in the Firebase Console
   
   //Observe the remote config parameter "perf_disable" and disable Performance Monitoring if true
   config.setDefaultsAsync(R.xml.remote_config_defaults)
           .addOnCompleteListener(new OnCompleteListener<Void>() {
               @Override
               public void onComplete(@NonNull Task<Void> task) {
                   if (task.isSuccessful()) {
                       if (config.getBoolean("perf_disable")) {
                           FirebasePerformance.getInstance().setPerformanceCollectionEnabled(false);
                       } else {
                           FirebasePerformance.getInstance().setPerformanceCollectionEnabled(true);
                       }
                   } else {
                       // An error occurred while setting default parameters
                   }
               }
           });
   MainActivity.java

3. Aggiungi il seguente codice a MainActivity.java per recuperarlo e attivarlo Valori di Remote Config:

   Kotlin+KTX

   // Remote Config fetches and activates parameter values from the service
   val config = Firebase.remoteConfig
   config.fetch(3600)
       .continueWithTask { task ->
           if (!task.isSuccessful) {
               task.exception?.let {
                   throw it
               }
           }
           config.activate()
       }
       .addOnCompleteListener(this) { task ->
           if (task.isSuccessful) {
               // Parameter values successfully activated
               // ...
           } else {
               // Handle errors
           }
       }
   MainActivity.kt

   Java

   //Remote Config fetches and activates parameter values from the service
   final FirebaseRemoteConfig config = FirebaseRemoteConfig.getInstance();
   config.fetch(3600)
           .continueWithTask(new Continuation<Void, Task<Boolean>>() {
               @Override
               public Task<Boolean> then(@NonNull Task<Void> task) throws Exception {
                   if (!task.isSuccessful()) {
                       throw task.getException();
                   }
                   return config.activate();
               }
           })
           .addOnCompleteListener(new OnCompleteListener<Boolean>() {
               @Override
               public void onComplete(@NonNull Task<Boolean> task) {
                   if (task.isSuccessful()) {
                       // Parameter values successfully activated
                       // ...
                   } else {
                       // Handle errors
                   }
               }
           });
   MainActivity.java

4. Per disabilitare Performance Monitoring nella console Firebase, crea una richiesta perf_disable nel progetto dell'app, poi imposta il valore su true.

   Questa modifica comporterà l'assenza di operazioni per le chiamate all'SDK Performance Monitoring chiamate (NOOP), eliminando gli effetti significativi sulle prestazioni dell'app derivanti dall'uso l'SDK Performance Monitoring nella tua app.

   Se imposti il valore di perf_disable su false, Performance Monitoring rimane in un bucket con il controllo delle versioni attivo.