Apple प्लैटफ़ॉर्म के लिए परफ़ॉर्मेंस मॉनिटर करने की सुविधा का इस्तेमाल शुरू करना

वेब कंटेनर इंस्टॉल करने से पहले

अगर आपने पहले से Firebase नहीं जोड़ा है, तो अपने Apple प्रोजेक्ट में Firebase जोड़ें.

पहला चरण: अपने ऐप्लिकेशन में परफ़ॉर्मेंस मॉनिटर करने की सुविधा जोड़ना

परफ़ॉर्मेंस मॉनिटर करने वाला SDK टूल जोड़ने के बाद, Firebase आपके ऐप्लिकेशन की स्क्रीन रेंडरिंग का डेटा, आपके ऐप्लिकेशन की लाइफ़साइकल से जुड़ा डेटा (जैसे, ऐप्लिकेशन शुरू होने का समय), और एचटीटीपी/एस नेटवर्क अनुरोधों का डेटा अपने-आप इकट्ठा करना शुरू कर देता है.

Firebase डिपेंडेंसी इंस्टॉल और मैनेज करने के लिए, Swift पैकेज मैनेजर का इस्तेमाल करें.

  1. Xcode में, अपना ऐप्लिकेशन प्रोजेक्ट खोलने के लिए, फ़ाइल > पैकेज जोड़ें पर जाएं.
  2. जब कहा जाए, तब Firebase Apple प्लैटफ़ॉर्म SDK टूल का रिपॉज़िटरी जोड़ें:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. परफ़ॉर्मेंस मॉनिटर करने की लाइब्रेरी चुनें.
  4. अपने टारगेट की बिल्ड सेटिंग के अन्य लिंकर फ़्लैग सेक्शन में -ObjC फ़्लैग जोड़ें.
  5. यह काम पूरा होने के बाद, Xcode बैकग्राउंड में आपकी डिपेंडेंसी को अपने-आप रिज़ॉल्व और डाउनलोड करना शुरू कर देगा.

इसके बाद, Firebase मॉड्यूल कॉन्फ़िगर करें:

  1. अपने UIApplicationDelegate में FirebaseCore मॉड्यूल को इंपोर्ट करें. साथ ही, ऐसे सभी Firebase मॉड्यूल को इंपोर्ट करें जिनका इस्तेमाल आपके ऐप्लिकेशन का ऐक्सेस मैनेज करता है. उदाहरण के लिए, Cloud Firestore और पुष्टि करने की सुविधा का इस्तेमाल करने के लिए:

    स्विफ़्टयूआई

    import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. अपने ऐप्लिकेशन का ऐक्सेस देने वाले व्यक्ति के application(_:didFinishLaunchingWithOptions:) तरीके में, FirebaseApp शेयर किए गए इंस्टेंस को कॉन्फ़िगर करें:

    स्विफ़्टयूआई

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Swift

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. अगर SwiftUI का इस्तेमाल किया जा रहा है, तो आपको ऐप्लिकेशन का ऐक्सेस देना होगा और उसे UIApplicationDelegateAdaptor या NSApplicationDelegateAdaptor की मदद से अपने App स्ट्रक्चर में अटैच करना होगा. आपको ऐप्लिकेशन सौंपने की सुविधा को स्वाइप करने की सुविधा भी बंद करनी होगी. ज़्यादा जानकारी के लिए, SwiftUI के निर्देश देखें.

    स्विफ़्टयूआई

    @main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}

  4. अपने ऐप्लिकेशन को फिर से कंपाइल करें.

दूसरा चरण: शुरुआती डेटा दिखाने के लिए परफ़ॉर्मेंस इवेंट जनरेट करना

जब ऐप्लिकेशन में SDK टूल जोड़ दिया जाता है, तो Firebase इवेंट को प्रोसेस करना शुरू कर देता है. अगर अब भी स्थानीय तौर पर डेटा डेवलप किया जा रहा है, तो अपने ऐप्लिकेशन से इंटरैक्ट करके, शुरुआती डेटा कलेक्शन और प्रोसेसिंग के लिए इवेंट जनरेट करें.

  1. सिम्युलेटर या टेस्ट डिवाइस का इस्तेमाल करके, अपना ऐप्लिकेशन डेवलप करना जारी रखें.

  2. अपने ऐप्लिकेशन को बैकग्राउंड और फ़ोरग्राउंड के बीच कई बार स्विच करके, अलग-अलग स्क्रीन पर नेविगेट करके और/या नेटवर्क के अनुरोधों को ट्रिगर करके, अपने ऐप्लिकेशन से इंटरैक्ट करके इवेंट जनरेट करें.

  3. Firebase कंसोल के परफ़ॉर्मेंस डैशबोर्ड पर जाएं. आपको कुछ ही मिनटों में अपना शुरुआती डेटा दिखेगा.

    अगर आपको अपना शुरुआती डेटा नहीं दिखता है, तो समस्या हल करने की सलाह देखें.

तीसरा चरण: (ज़रूरी नहीं) परफ़ॉर्मेंस इवेंट के लॉग मैसेज देखें

  1. डीबग लॉग करने की प्रोसेस चालू करने के लिए, यह तरीका अपनाएं:

    1. Xcode (कम से कम वर्शन 14.1) में, प्रॉडक्ट > स्कीम > स्कीम में बदलाव करें चुनें.
    2. बाईं ओर मौजूद मेन्यू में जाकर, Run चुनें. इसके बाद, आर्ग्युमेंट टैब चुनें.
    3. लॉन्च के बाद पास किए गए आर्ग्युमेंट सेक्शन में, -FIRDebugEnabled जोड़ें.

  2. गड़बड़ी के किसी भी मैसेज के लिए अपने लॉग मैसेज देखें.

  3. परफ़ॉर्मेंस मॉनिटर करने की सुविधा, अपने लॉग मैसेज को Firebase/Performance के साथ टैग करती है, ताकि आप लॉग मैसेज को फ़िल्टर कर सकें.

  4. इस तरह के लॉग देखें. इनसे पता चलता है कि परफ़ॉर्मेंस मॉनिटर करने की सुविधा, परफ़ॉर्मेंस इवेंट को लॉग कर रही है:

    • Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URL
    • Logging network request trace: URL

  5. Firebase कंसोल में अपना डेटा देखने के लिए, यूआरएल पर क्लिक करें. डैशबोर्ड में डेटा को अपडेट होने में कुछ समय लग सकता है.

अगर आपका ऐप्लिकेशन परफ़ॉर्मेंस से जुड़े इवेंट लॉग नहीं कर रहा है, तो समस्या को हल करने के बारे में सलाह देखें.

चौथा चरण: (ज़रूरी नहीं) किसी कोड के लिए, अपने हिसाब से मॉनिटरिंग की सुविधा चालू करें

अपने ऐप्लिकेशन में किसी खास कोड से जुड़े परफ़ॉर्मेंस डेटा की निगरानी करने के लिए, कस्टम कोड ट्रेस इंस्टॉल किए जा सकते हैं.

कस्टम कोड ट्रेस की मदद से, यह मेज़र किया जा सकता है कि आपके ऐप्लिकेशन को किसी खास टास्क या टास्क के सेट को पूरा करने में कितना समय लगता है. जैसे, इमेज का सेट लोड करना या आपके डेटाबेस से जुड़ी क्वेरी करना. कस्टम कोड ट्रेस की डिफ़ॉल्ट मेट्रिक उसकी अवधि होती है, लेकिन आपके पास कैश हिट और मेमोरी चेतावनियां जैसी कस्टम मेट्रिक भी जोड़ने का विकल्प होता है.

अपने कोड में, परफ़ॉर्मेंस मॉनिटर करने वाले SDK टूल से मिले एपीआई का इस्तेमाल करके, कस्टम कोड ट्रेस के शुरू और आखिरी हिस्से को तय किया जाता है. साथ ही, अपनी पसंद की कोई भी कस्टम मेट्रिक जोड़ी जाती है.

इन सुविधाओं और इन्हें अपने ऐप्लिकेशन में जोड़ने के तरीके के बारे में ज़्यादा जानने के लिए, खास कोड के लिए मॉनिटरिंग जोड़ना पर जाएं.

पांचवां चरण: अपना ऐप्लिकेशन डिप्लॉय करें और फिर नतीजों की समीक्षा करें

Xcode सिम्युलेटर और एक या उससे ज़्यादा टेस्ट डिवाइसों का इस्तेमाल करके, परफ़ॉर्मेंस मॉनिटर करने की सुविधा की पुष्टि करने के बाद, उपयोगकर्ताओं के लिए अपने ऐप्लिकेशन के अपडेट किए गए वर्शन को डिप्लॉय किया जा सकता है.

Firebase कंसोल के परफ़ॉर्मेंस डैशबोर्ड में जाकर, परफ़ॉर्मेंस डेटा की निगरानी की जा सकती है.

ऐसी समस्याएं जो पहले भी आ चुकी हैं

  • परफ़ॉर्मेंस मॉनिटर करने की सुविधा में, GTMSQLite के साथ काम करने से जुड़ी समस्याओं के बारे में जानकारी मौजूद है. हमारा सुझाव है कि GTMSQLite का इस्तेमाल करने वाले ऐप्लिकेशन के साथ, परफ़ॉर्मेंस मॉनिटर करने की सुविधा का इस्तेमाल न करें.
  • FirebaseApp.configure() को कॉल करने के बाद तेज़ी से बदलने से, परफ़ॉर्मेंस मॉनिटर करने वाले SDK टूल में रुकावट आ सकती है.
  • iOS 8.0-8.2 सिम्युलेटर की पहले से मालूम समस्याएं, परफ़ॉर्मेंस मॉनिटरिंग को परफ़ॉर्मेंस इवेंट कैप्चर करने से रोकती हैं. ये समस्याएं iOS 8.3 सिम्युलेटर और इसके बाद के वर्शन में ठीक की जाती हैं.
  • NSURLसेशन के backgroundSessionConfiguration का इस्तेमाल करके बनाए गए कनेक्शन, कनेक्शन के अनुमानित समय से ज़्यादा समय के लिए दिखेंगे. ये कनेक्शन, प्रोसेस से बाहर किए जाते हैं और समय से जुड़े कॉलबैक इवेंट प्रोसेस होते हैं.

अगले चरण