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

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

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

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

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

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

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

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

  1. अपने इसमें FirebaseCore मॉड्यूल को इंपोर्ट करें UIApplicationDelegate और अन्य वे 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. कॉन्फ़िगर करें FirebaseApp आपके ऐप्लिकेशन डेलिगेट के शेयर किए गए इंस्टेंस में application(_:didFinishLaunchingWithOptions:) तरीका:

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

    // 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 के ज़रिए अपने App निर्देश को या NSApplicationDelegateAdaptor. आपको ऐप्लिकेशन सौंपने की सुविधा को स्वाइप करने की सुविधा भी बंद करनी होगी. इसके लिए ज़्यादा जानकारी के लिए, 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. परफ़ॉर्मेंस डैशबोर्ड पर जाएं के विकल्प का इस्तेमाल करना चाहिए. आपको अपना शुरुआती डेटा यहां दिखेगा कुछ मिनट.

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

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

  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 सिम्युलेटर और एक या एक से ज़्यादा टूल का इस्तेमाल करके, परफ़ॉर्मेंस मॉनिटर करने की सुविधा की पुष्टि करने के बाद टेस्ट डिवाइस हैं, तो आप अपने ऐप्लिकेशन के अपडेट किए गए वर्शन को अपने उपयोगकर्ताओं के लिए डिप्लॉय कर सकते हैं.

परफ़ॉर्मेंस डेटा की निगरानी परफ़ॉर्मेंस डैशबोर्ड के विकल्प का इस्तेमाल करना चाहिए.

ज्ञात समस्याएं

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

अगले चरण