查看 2022 年 Google I/O 大会上介绍的 Firebase 新动态。了解详情

Disabilita il monitoraggio delle prestazioni di Firebase

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

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

  • Disabilita alcune funzionalità di Performance Monitoring (come quelle fornite dal plug-in Performance Monitoring Gradle ) nelle build di debug, ma riattiva le funzionalità per la build di rilascio.

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

  • Disattiva il monitoraggio delle prestazioni durante la creazione dell'app e non consentire all'app di riattivarla 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 nell'app di produzione. Con questa opzione, puoi persino configurare la tua app per consentire agli utenti di accettare o rifiutare l'utilizzo del monitoraggio delle prestazioni.

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

Puoi 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, la disabilitazione del plug-in è utile perché la strumentazione del plug- in può contribuire ad aumentare i tempi di compilazione. Tuttavia, potresti considerare di mantenere abilitata la libreria in modo da poter comunque visualizzare i dati sulle prestazioni dalle tracce di avvio dell'app, app in primo piano e in background , nonché eventuali tracce di codice personalizzate nell'app.

Disabilita il plug-in Gradle per il monitoraggio delle prestazioni

È possibile disabilitare il plug-in Performance Monitoring aggiungendo un flag instrumentationEnabled utilizzando le seguenti opzioni:

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

  • Project Property : disabilita il plug-in per tutte le varianti di build in fase di compilazione

Disabilita il plug-in tramite un flag Proprietà estensione

Usando un flag della proprietà delle estensioni , puoi 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 tua dipendenza Android Gradle Plugin sia specificata come v3.4.0 o successiva.

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

  2. Aggiungi il seguente flag al file build.gradle del tuo modulo (a livello di app), quindi impostalo 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 , puoi disabilitare il plug-in di monitoraggio delle prestazioni per tutte le varianti di build in fase di compilazione.

Aggiungi il seguente flag al tuo file gradle.properties , quindi impostalo 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 all'app di abilitare la libreria in fase di esecuzione.

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

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 all'app di abilitarla in fase di esecuzione

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 usando 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 del monitoraggio delle prestazioni al successivo avvio dell'app Android, utilizza il codice di esempio mostrato di seguito. Per ulteriori informazioni sull'utilizzo di Remote Config in un'app Android, consulta Usare Firebase Remote Config su Android .

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

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

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

    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. Aggiungi il codice seguente a MainActivity.java per recuperare e attivare i valori di configurazione remota:

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

    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 "no operation" (NOOP) dell'SDK di monitoraggio delle prestazioni, eliminando eventuali effetti significativi sulle prestazioni dell'app dall'uso dell'SDK di monitoraggio delle prestazioni nell'app.

    Se imposti il ​​valore di perf_disable su false , il monitoraggio delle prestazioni rimane abilitato.