Catch up on highlights from Firebase at Google I/O 2023. Learn more

Apple प्लेटफ़ॉर्म के लिए प्रदर्शन निगरानी के साथ आरंभ करें

शुरू करने से पहले

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

चरण 1 : अपने ऐप में प्रदर्शन निगरानी जोड़ें

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

फायरबेस निर्भरताओं को स्थापित और प्रबंधित करने के लिए स्विफ्ट पैकेज मैनेजर का उपयोग करें।

  1. Xcode में, अपने ऐप प्रोजेक्ट को खोलने के साथ, File > Add Packages पर नेविगेट करें।
  2. संकेत दिए जाने पर, Firebase Apple प्लेटफ़ॉर्म SDK रिपॉजिटरी जोड़ें:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. प्रदर्शन निगरानी पुस्तकालय चुनें।
  5. समाप्त होने पर, Xcode स्वचालित रूप से पृष्ठभूमि में आपकी निर्भरताओं को हल करना और डाउनलोड करना शुरू कर देगा।

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

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

    स्विफ्टयूआई

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

    तीव्र

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    उद्देश्य सी

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. अपने ऐप प्रतिनिधि के application(_:didFinishLaunchingWithOptions:) विधि में FirebaseApp साझा उदाहरण कॉन्फ़िगर करें:

    स्विफ्टयूआई

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

    तीव्र

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

    उद्देश्य सी

    // 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. अपने ऐप को दोबारा कंपाइल करें।

चरण 2 : आरंभिक डेटा प्रदर्शन के लिए प्रदर्शन ईवेंट उत्पन्न करें

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

  1. एक सिम्युलेटर या टेस्ट डिवाइस का उपयोग करके अपने ऐप को विकसित करना जारी रखें।

  2. अपने ऐप को पृष्ठभूमि और अग्रभूमि के बीच कई बार स्विच करके, स्क्रीन पर नेविगेट करके और/या नेटवर्क अनुरोधों को ट्रिगर करके अपने ऐप के साथ इंटरैक्ट करके ईवेंट बनाएं।

  3. फायरबेस कंसोल के प्रदर्शन डैशबोर्ड पर जाएं। आपको अपना आरंभिक डेटा कुछ ही मिनटों में दिखाई देना चाहिए।

    यदि आप अपने प्रारंभिक डेटा का प्रदर्शन नहीं देखते हैं, तो समस्या निवारण युक्तियों की समीक्षा करें।

चरण 3 : (वैकल्पिक) प्रदर्शन घटनाओं के लिए लॉग संदेश देखें

  1. डिबग लॉगिंग सक्षम करें, निम्नानुसार:

    1. Xcode (न्यूनतम v14.1) में, उत्पाद > योजना > योजना संपादित करें चुनें।
    2. बाएं मेनू से चलाएँ चुनें, फिर तर्क टैब चुनें।
    3. लॉन्च सेक्शन में दिए गए तर्कों में -FIRDebugEnabled जोड़ें।
  2. किसी भी त्रुटि संदेश के लिए अपने लॉग संदेशों की जाँच करें।

  3. प्रदर्शन मॉनिटरिंग अपने लॉग संदेशों को Firebase/Performance के साथ टैग करता है ताकि आप अपने लॉग संदेशों को फ़िल्टर कर सकें।

  4. निम्न प्रकार के लॉग की जाँच करें जो इंगित करते हैं कि प्रदर्शन मॉनिटरिंग प्रदर्शन इवेंट लॉग कर रहा है:

    • Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
    • Logging network request trace: URL
  5. Firebase कंसोल में अपना डेटा देखने के लिए URL पर क्लिक करें। डैशबोर्ड में डेटा को अपडेट होने में कुछ समय लग सकता है।

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

चरण 4 : (वैकल्पिक) विशिष्ट कोड के लिए कस्टम मॉनिटरिंग जोड़ें

अपने ऐप में विशिष्ट कोड से जुड़े प्रदर्शन डेटा की निगरानी करने के लिए, आप कस्टम कोड ट्रेस लिख सकते हैं।

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

अपने कोड में, आप प्रदर्शन निगरानी एसडीके द्वारा प्रदान की गई एपीआई का उपयोग करके कस्टम कोड ट्रेस (और कोई वांछित कस्टम मेट्रिक्स जोड़ें) की शुरुआत और अंत को परिभाषित करते हैं।

इन सुविधाओं के बारे में और उन्हें अपने ऐप में जोड़ने के तरीके के बारे में अधिक जानने के लिए विशिष्ट कोड के लिए निगरानी जोड़ें पर जाएं।

चरण 5 : अपना ऐप तैनात करें और फिर परिणामों की समीक्षा करें

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

आप फायरबेस कंसोल के प्रदर्शन डैशबोर्ड में प्रदर्शन डेटा की निगरानी कर सकते हैं।

ज्ञात पहलु

  • प्रदर्शन मॉनिटरिंग में GTMSQLite के साथ ज्ञात संगतता समस्याएँ हैं। हम अनुशंसा करते हैं कि GTMSQLite का उपयोग करने वाले ऐप्स के साथ प्रदर्शन निगरानी का उपयोग न करें।
  • FirebaseApp.configure() को कॉल करने के बाद विधि स्विजलिंग प्रदर्शन निगरानी SDK के साथ हस्तक्षेप कर सकती है।
  • IOS 8.0-8.2 सिम्युलेटर के साथ ज्ञात समस्याएँ प्रदर्शन मॉनिटरिंग को प्रदर्शन घटनाओं को कैप्चर करने से रोकती हैं। ये मुद्दे iOS 8.3 सिम्युलेटर और बाद के संस्करणों में तय किए गए हैं।
  • NSURLSession के backgroundSessionConfiguration का उपयोग करके स्थापित किए गए कनेक्शन अपेक्षित कनेक्शन समय से अधिक प्रदर्शित होंगे। इन कनेक्शनों को आउट-ऑफ़-प्रोसेस निष्पादित किया जाता है और समय-समय पर कॉलबैक ईवेंट को प्रतिबिंबित करता है।

अगले कदम