Save the date - Google I/O returns May 18-20. Register to get the most out of the digital experience: Build your schedule, reserve space, participate in Q&As, earn Google Developer profile badges, and more. Register now

Disabilita il monitoraggio delle prestazioni di Firebase

Durante lo sviluppo e il test delle app, potrebbe essere utile disabilitare il monitoraggio delle prestazioni.

Ad esempio, disabilitando il monitoraggio delle prestazioni durante il processo di creazione dell'app , puoi:

  • Disattiva alcune funzionalità di monitoraggio delle prestazioni (come quelle fornite dal plug-in Gradle monitoraggio delle prestazioni ) nelle build di debug, ma riattiva le funzionalità per la build di rilascio.

  • Disattiva il monitoraggio delle prestazioni durante la creazione della tua app, ma consenti all'app di riattivarla in fase di esecuzione.

  • Disabilita il monitoraggio delle prestazioni durante la creazione della tua app e non consentire alla tua app di riabilitarla in fase di esecuzione.

Puoi anche creare la tua app con il monitoraggio delle prestazioni abilitato , ma usa Firebase Remote Config per darti la flessibilità di disabilitare (e riattivare) il monitoraggio delle prestazioni nella tua app di produzione. Con questa opzione, puoi persino configurare la tua app per consentire agli utenti di attivare o disattivare l'utilizzo del monitoraggio delle prestazioni.

Disattiva il monitoraggio delle prestazioni durante il processo di creazione dell'app

È possibile disabilitare il monitoraggio delle prestazioni durante il processo di compilazione disabilitando il plug-in Gradle di monitoraggio delle prestazioni e / o disabilitando la libreria Android di monitoraggio delle prestazioni .

Durante lo sviluppo e il debug, disabilitare il plug-in è utile perché la strumentazione del plug-in può contribuire ad aumentare il tempo di compilazione. Tuttavia, potresti considerare di mantenere la libreria abilitata in modo da poter ancora visualizzare i dati sulle prestazioni dall'avvio dell'app, tracce di app in primo piano e app in background , nonché eventuali tracce di codice personalizzate nella tua app.

Disabilita il plug-in Gradle per il monitoraggio delle prestazioni

È possibile disabilitare il plug-in Monitoraggio delle prestazioni aggiungendo un flag instrumentationEnabled utilizzando le seguenti opzioni:

  • Proprietà estensione : disabilita il plug-in per una variante di build specifica in fase di compilazione

  • Proprietà progetto : disabilita il plug-in per tutte le varianti di build in fase di compilazione

Disabilita il plug-in tramite un flag di proprietà di estensione

Utilizzando un flag di proprietà delle estensioni , è possibile disabilitare il plug-in di monitoraggio delle prestazioni per una variante di build specifica in fase di compilazione.

  1. Nel tuo file build.gradle a livello di root (a livello di progetto), assicurati che la dipendenza del plugin Android Gradle sia specificata come v3.4.0 o successiva.

    Per le versioni precedenti del plug-in Android Gradle, puoi comunque disabilitare il plug-in di monitoraggio delle prestazioni per una variante di build specifica, ma il contributo in termini di tempo di compilazione per quella variante non verrà completamente eliminato.

  2. Aggiungi il seguente flag al file build.gradle tuo modulo (a livello di app), quindi build.gradle su false per disabilitare il plug-in di monitoraggio delle prestazioni.

    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
          }
        }
      }
    }
    

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

Utilizzando un flag di proprietà del progetto , è possibile disabilitare il plug-in Monitoraggio delle prestazioni per tutte le varianti di build in fase di compilazione.

Aggiungi il seguente flag al tuo file gradle.properties , quindi gradle.properties su false per disabilitare il plug-in di monitoraggio delle prestazioni.

// ...

// 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

Disabilita la libreria Android di monitoraggio delle prestazioni

Se disabiliti la libreria di monitoraggio delle prestazioni in fase di compilazione, puoi scegliere se consentire alla tua app di abilitare la libreria in fase di runtime.

Disabilita la libreria in fase di compilazione, ma consenti all'app di abilitarla in fase di runtime

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

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

Disabilita la libreria in fase di compilazione, ma non consentire alla tua app di abilitarla in fase di runtime

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

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

Disabilita la tua app in fase di esecuzione utilizzando Remote Config

Firebase Remote Config ti consente di apportare modifiche al comportamento e all'aspetto della tua app, quindi fornisce un modo ideale per disabilitare il monitoraggio delle prestazioni nelle istanze distribuite della tua app.

Per disabilitare la raccolta dei dati di monitoraggio delle prestazioni al successivo avvio dell'app Android, utilizzare il codice di esempio mostrato di seguito. Per ulteriori informazioni sull'utilizzo di Remote Config in un'app Android, consulta Utilizzare Firebase Remote Config su Android .

  1. Assicurati che Remote Config sia nella sezione delle dependencies del tuo file Gradle del modulo (solitamente app/build.gradle ):

    implementation 'com.google.firebase:firebase-config:21.0.0'
    
  2. Imposta Remote Config e disabilita il monitoraggio delle prestazioni se perf_disable è impostato su true :

    Giava

    // 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
                    }
                }
            });

    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
                }
            }
  3. Aggiungere il codice seguente a MainActivity.java per recuperare e attivare i valori di Remote Config:

    Giava

    //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
                    }
                }
            });

    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
                }
            }
  4. Per disabilitare il monitoraggio delle prestazioni nella console Firebase, crea un parametro perf_disable nel progetto della tua app, quindi imposta il suo valore su true .

    Questa modifica effettuerà chiamate alle chiamate NOOP (Performance Monitoring SDK), eliminando qualsiasi effetto significativo sulle prestazioni dell'app dall'utilizzo dell'SDK Performance Monitoring nella tua app.

    Se si imposta il valore di perf_disable su false , il monitoraggio delle prestazioni rimane abilitato.