फायरबेस प्रदर्शन निगरानी अक्षम करें

ऐप विकास और परीक्षण के दौरान, आपको प्रदर्शन मॉनिटरिंग को अक्षम करना उपयोगी हो सकता है।

उदाहरण के लिए, अपनी ऐप निर्माण प्रक्रिया के दौरान प्रदर्शन मॉनिटरिंग को अक्षम करके, आप यह कर सकते हैं:

  • अपने डिबग बिल्ड में प्रदर्शन मॉनिटरिंग की कुछ कार्यक्षमताओं को अक्षम करें (जैसे कि प्रदर्शन मॉनिटरिंग ग्रैडल प्लगइन द्वारा प्रदान की गई), लेकिन अपने रिलीज़ बिल्ड के लिए कार्यक्षमताओं को फिर से सक्षम करें।

  • अपना ऐप बनाते समय प्रदर्शन मॉनिटरिंग अक्षम करें, लेकिन अपने ऐप को रनटाइम पर इसे फिर से सक्षम करने की अनुमति दें।

  • अपना ऐप बनाते समय प्रदर्शन मॉनिटरिंग अक्षम करें, और अपने ऐप को रनटाइम पर इसे फिर से सक्षम करने की अनुमति न दें।

आप प्रदर्शन मॉनिटरिंग सक्षम करके भी अपना ऐप बना सकते हैं, लेकिन अपने प्रोडक्शन ऐप में प्रदर्शन मॉनिटरिंग को अक्षम (और पुनः सक्षम) करने की सुविधा देने के लिए फायरबेस रिमोट कॉन्फिग का उपयोग करें । इस विकल्प के साथ, आप उपयोगकर्ताओं को प्रदर्शन मॉनिटरिंग का उपयोग करने के लिए ऑप्ट-इन या ऑप्ट-आउट करने देने के लिए अपने ऐप को कॉन्फ़िगर भी कर सकते हैं।

अपनी ऐप निर्माण प्रक्रिया के दौरान प्रदर्शन निगरानी अक्षम करें

आप परफॉरमेंस मॉनिटरिंग ग्रैडल प्लगइन को अक्षम करके और/या परफॉरमेंस मॉनिटरिंग एंड्रॉइड लाइब्रेरी को अक्षम करके अपनी निर्माण प्रक्रिया के दौरान प्रदर्शन मॉनिटरिंग को अक्षम कर सकते हैं।

विकास और डिबगिंग के दौरान, प्लगइन को अक्षम करना उपयोगी होता है क्योंकि प्लगइन द्वारा उपकरण निर्माण समय को बढ़ाने में योगदान कर सकता है। हालाँकि, आप लाइब्रेरी को सक्षम रखने पर विचार कर सकते हैं ताकि आप अभी भी ऐप स्टार्ट, ऐप-इन-फोरग्राउंड और ऐप-इन-बैकग्राउंड ट्रेस के साथ-साथ अपने ऐप में किसी भी कस्टम कोड ट्रेस से प्रदर्शन डेटा देख सकें।

प्रदर्शन मॉनिटरिंग ग्रैडल प्लगइन को अक्षम करें

आप निम्नलिखित विकल्पों का उपयोग करके एक instrumentationEnabled ध्वज जोड़कर प्रदर्शन मॉनिटरिंग प्लगइन को अक्षम कर सकते हैं:

एक्सटेंशन प्रॉपर्टी फ़्लैग के माध्यम से प्लगइन को अक्षम करें

एक्सटेंशन प्रॉपर्टी फ़्लैग का उपयोग करके, आप संकलन समय पर एक विशिष्ट बिल्ड वैरिएंट के लिए प्रदर्शन मॉनिटरिंग प्लगइन को अक्षम कर सकते हैं।

  1. आपकी रूट-लेवल (प्रोजेक्ट-लेवल) ग्रैडल फ़ाइल ( <project>/build.gradle.kts या <project>/build.gradle ) में, सुनिश्चित करें कि आपकी एंड्रॉइड ग्रैडल प्लगइन निर्भरता v3.4.0 या बाद के संस्करण के रूप में निर्दिष्ट है।

    एंड्रॉइड ग्रैडल प्लगइन के पुराने संस्करणों के लिए, आप अभी भी एक विशिष्ट बिल्ड वेरिएंट के लिए प्रदर्शन मॉनिटरिंग प्लगइन को अक्षम कर सकते हैं, लेकिन उस वेरिएंट के लिए बिल्ड समय योगदान पूरी तरह से समाप्त नहीं किया जाएगा।

  2. अपने मॉड्यूल (ऐप-स्तर) ग्रैडल फ़ाइल में निम्नलिखित ध्वज जोड़ें (आमतौर पर <project>/<app-module>/build.gradle.kts या <project>/<app-module>/build.gradle ), फिर इसे सेट करें प्रदर्शन मॉनिटरिंग प्लगइन को अक्षम करने के लिए false पर क्लिक करें।

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

प्रोजेक्ट प्रॉपर्टी फ़्लैग के माध्यम से प्लगइन को अक्षम करें

प्रोजेक्ट प्रॉपर्टी फ़्लैग का उपयोग करके, आप संकलन समय पर सभी बिल्ड वेरिएंट के लिए प्रदर्शन मॉनिटरिंग प्लगइन को अक्षम कर सकते हैं।

अपनी gradle.properties फ़ाइल में निम्न ध्वज जोड़ें, फिर प्रदर्शन मॉनिटरिंग प्लगइन को अक्षम करने के लिए इसे false पर सेट करें।

// ...

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

प्रदर्शन मॉनिटरिंग एंड्रॉइड लाइब्रेरी को अक्षम करें

यदि आप संकलन समय पर प्रदर्शन मॉनिटरिंग लाइब्रेरी को अक्षम करते हैं, तो आप चुन सकते हैं कि आपके ऐप को रनटाइम पर लाइब्रेरी को सक्षम करने की अनुमति देनी है या नहीं।

संकलन समय पर लाइब्रेरी को अक्षम करें, लेकिन अपने ऐप को रनटाइम पर इसे सक्षम करने की अनुमति दें

अपने ऐप की AndroidManifest.xml फ़ाइल में निम्नलिखित <meta-data> तत्व जोड़ें:

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

संकलन समय पर लाइब्रेरी को अक्षम करें, लेकिन अपने ऐप को रनटाइम पर इसे सक्षम करने की अनुमति न दें

अपने ऐप की AndroidManifest.xml फ़ाइल में निम्नलिखित <meta-data> तत्व जोड़ें:

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

रिमोट कॉन्फिग का उपयोग करके रनटाइम पर अपने ऐप को अक्षम करें

फायरबेस रिमोट कॉन्फिग आपको अपने ऐप के व्यवहार और स्वरूप में बदलाव करने की सुविधा देता है, इसलिए यह आपको आपके ऐप के तैनात इंस्टेंसेस में प्रदर्शन मॉनिटरिंग को अक्षम करने का एक आदर्श तरीका प्रदान करता है।

अगली बार जब आपका एंड्रॉइड ऐप शुरू हो तो प्रदर्शन मॉनिटरिंग डेटा संग्रह को अक्षम करने के लिए, नीचे दिखाए गए उदाहरण कोड का उपयोग करें। एंड्रॉइड ऐप में रिमोट कॉन्फिग का उपयोग करने के बारे में अधिक जानकारी के लिए, एंड्रॉइड पर फायरबेस रिमोट कॉन्फिग का उपयोग करें देखें।

  1. सुनिश्चित करें कि रिमोट कॉन्फ़िगरेशन आपके मॉड्यूल (ऐप-स्तर) ग्रैडल फ़ाइल (आमतौर पर <project>/<app-module>/build.gradle.kts या <project>/<app-module>/build.gradle के dependencies अनुभाग में है ):

    Kotlin+KTX

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

    Java

      implementation("com.google.firebase:firebase-config:21.6.3")
    
  2. यदि perf_disable 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
            }
        }

    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
                    }
                }
            });
  3. रिमोट कॉन्फिग मान लाने और सक्रिय करने के लिए MainActivity.java में निम्नलिखित कोड जोड़ें:

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

    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
                    }
                }
            });
  4. फायरबेस कंसोल में प्रदर्शन मॉनिटरिंग को अक्षम करने के लिए, अपने ऐप के प्रोजेक्ट में एक perf_disable पैरामीटर बनाएं, फिर उसका मान true पर सेट करें।

    यह परिवर्तन प्रदर्शन मॉनिटरिंग एसडीके को "नो ऑपरेशन" कॉल (एनओओपी) देगा, जिससे आपके ऐप में प्रदर्शन मॉनिटरिंग एसडीके का उपयोग करने से ऐप के प्रदर्शन पर कोई भी महत्वपूर्ण प्रभाव समाप्त हो जाएगा।

    यदि आप perf_disable का मान false पर सेट करते हैं, तो प्रदर्शन निगरानी सक्षम रहती है।