शुरू करने से पहले
अगर आपने पहले से ऐसा नहीं किया है, तो अपने Apple प्रोजेक्ट में Firebase जोड़ें.
पहला चरण: Performance Monitoring को अपने ऐप्लिकेशन में जोड़ें
Performance Monitoring SDK टूल जोड़ने के बाद, Firebase आपके ऐप्लिकेशन की स्क्रीन रेंडरिंग के लिए डेटा, आपके ऐप्लिकेशन के लाइफ़साइकल से जुड़ा डेटा (जैसे, ऐप्लिकेशन के शुरू होने का समय), और एचटीटीपी/एस नेटवर्क अनुरोधों के लिए डेटा अपने-आप इकट्ठा करना शुरू कर देता है.
Firebase की डिपेंडेंसी इंस्टॉल और मैनेज करने के लिए, Swift Package Manager का इस्तेमाल करें.
अपने Apple प्रोजेक्ट में Firebase SDK टूल जोड़ने के अलग-अलग तरीकों के बारे में जानने के लिए,- Xcode में, अपना ऐप्लिकेशन प्रोजेक्ट खोलने के लिए, फ़ाइल > पैकेज जोड़ें पर जाएं.
- जब कहा जाए, तब Firebase Apple प्लैटफ़ॉर्म SDK टूल का रिपॉज़िटरी जोड़ें:
- Performance Monitoring लाइब्रेरी चुनें.
- अपने टारगेट की बिल्ड सेटिंग के अन्य लिंकर फ़्लैग सेक्शन में
-ObjC
फ़्लैग जोड़ें. - यह काम पूरा होने के बाद, Xcode बैकग्राउंड में आपकी डिपेंडेंसी को अपने-आप रिज़ॉल्व और डाउनलोड करना शुरू कर देगा.
https://github.com/firebase/firebase-ios-sdk.git
इसके बाद, Firebase मॉड्यूल को कॉन्फ़िगर करें:
- अपने
UIApplicationDelegate
मेंFirebaseCore
मॉड्यूल के साथ-साथ, उन सभी Firebase मॉड्यूल को इंपोर्ट करें जिनका इस्तेमाल आपका ऐप्लिकेशन डेलीगेट करता है. उदाहरण के लिए, Cloud Firestore और Authentication का इस्तेमाल करने के लिए:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Swift
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Objective-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- अपने ऐप्लिकेशन का ऐक्सेस देने वाले व्यक्ति के
application(_:didFinishLaunchingWithOptions:)
तरीके में,FirebaseApp
शेयर किए गए इंस्टेंस को कॉन्फ़िगर करें:SwiftUI
// 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];
- अगर 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() } } } }
-
अपने ऐप्लिकेशन को फिर से कंपाइल करें.
दूसरा चरण: शुरुआती डेटा दिखाने के लिए परफ़ॉर्मेंस इवेंट जनरेट करना
जब ऐप्लिकेशन में SDK टूल जोड़ दिया जाता है, तो Firebase इवेंट को प्रोसेस करना शुरू कर देता है. अगर अब भी स्थानीय तौर पर डेवलप किया जा रहा है, तो अपने ऐप्लिकेशन से इंटरैक्ट करके, शुरुआती डेटा कलेक्शन और प्रोसेसिंग के लिए इवेंट जनरेट करें.
सिम्युलेटर या टेस्ट डिवाइस का इस्तेमाल करके, अपना ऐप्लिकेशन डेवलप करना जारी रखें.
अपने ऐप्लिकेशन को बैकग्राउंड और फ़ोरग्राउंड के बीच कई बार स्विच करके, अलग-अलग स्क्रीन पर नेविगेट करके और/या नेटवर्क के अनुरोध ट्रिगर करके अपने ऐप्लिकेशन से इंटरैक्ट करके इवेंट जनरेट करें.
Firebase कंसोल के परफ़ॉर्मेंस डैशबोर्ड पर जाएं. आपको कुछ ही मिनटों में अपना शुरुआती डेटा दिखेगा.
अगर आपको अपना शुरुआती डेटा नहीं दिखता है, तो समस्या हल करने की सलाह देखें.
तीसरा चरण: (ज़रूरी नहीं) परफ़ॉर्मेंस इवेंट के लिए लॉग मैसेज देखना
डीबग लॉग करने की प्रोसेस चालू करने के लिए, यह तरीका अपनाएं:
- Xcode (कम से कम वर्शन 15.2) में, प्रॉडक्ट > स्कीम > स्कीम में बदलाव करें चुनें.
- बाईं ओर मौजूद मेन्यू में जाकर, चालू करें चुनें. इसके बाद, आर्ग्युमेंट टैब चुनें.
- लॉन्च के बाद पास किए गए आर्ग्युमेंट सेक्शन में,
-FIRDebugEnabled
जोड़ें.
गड़बड़ी के किसी भी मैसेज के लिए अपने लॉग मैसेज देखें.
Performance Monitoring अपने लॉग मैसेज को
Firebase/Performance
से टैग करता है, ताकि आप अपने लॉग मैसेज फ़िल्टर कर सकें.इस तरह के लॉग देखें जिनसे पता चलता है कि Performance Monitoring परफ़ॉर्मेंस इवेंट को लॉग कर रहा है:
Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URL
Logging network request trace: URL
Firebase कंसोल में अपना डेटा देखने के लिए, यूआरएल पर क्लिक करें. डैशबोर्ड में डेटा को अपडेट होने में कुछ समय लग सकता है.
अगर आपका ऐप्लिकेशन परफ़ॉर्मेंस इवेंट को लॉग नहीं कर रहा है, तो समस्या हल करने के तरीकों के बारे में जानें.
चौथा चरण: (ज़रूरी नहीं) किसी खास कोड के लिए कस्टम मॉनिटरिंग जोड़ना
अपने ऐप्लिकेशन में किसी खास कोड से जुड़ी परफ़ॉर्मेंस का डेटा मॉनिटर करने के लिए, कस्टम कोड ट्रेस का इस्तेमाल किया जा सकता है.
कस्टम कोड ट्रेस की मदद से, यह मेज़र किया जा सकता है कि आपके ऐप्लिकेशन को किसी खास टास्क या टास्क के सेट को पूरा करने में कितना समय लगता है. जैसे, इमेज का सेट लोड करना या अपने डेटाबेस से क्वेरी करना. कस्टम कोड ट्रेस की डिफ़ॉल्ट मेट्रिक, उसकी अवधि होती है. हालांकि, आपके पास कैश मेमोरी में हिट और मेमोरी से जुड़ी चेतावनियां जैसी कस्टम मेट्रिक जोड़ने का विकल्प भी होता है.
अपने कोड में, Performance Monitoring SDK से मिले एपीआई का इस्तेमाल करके, कस्टम कोड ट्रेस के शुरू और आखिर में सेट किया जाता है (और अपनी पसंद की कोई भी कस्टम मेट्रिक जोड़ी जाती है).
इन सुविधाओं के बारे में ज़्यादा जानने और उन्हें अपने ऐप्लिकेशन में जोड़ने का तरीका जानने के लिए, किसी खास कोड के लिए मॉनिटरिंग जोड़ें पर जाएं.
पांचवां चरण: अपना ऐप्लिकेशन डिप्लॉय करें और फिर नतीजों की समीक्षा करें
Xcode सिम्युलेटर और एक या उससे ज़्यादा टेस्ट डिवाइसों का इस्तेमाल करके, Performance Monitoring की पुष्टि करने के बाद, अपने ऐप्लिकेशन का अपडेट किया गया वर्शन अपने उपयोगकर्ताओं के लिए डिप्लॉय किया जा सकता है.
Firebase कंसोल के परफ़ॉर्मेंस डैशबोर्ड में जाकर, परफ़ॉर्मेंस डेटा पर नज़र रखी जा सकती है.
ज्ञात समस्याएं
- Performance Monitoring में, GTMSQLite के साथ काम करने से जुड़ी समस्याओं के बारे में जानकारी मौजूद है. हमारा सुझाव है कि GTMSQLite का इस्तेमाल करने वाले ऐप्लिकेशन के साथ Performance Monitoring का इस्तेमाल न करें.
FirebaseApp.configure()
को कॉल करने के बाद, तेज़ी से घुमाने के तरीके से Performance Monitoring SDK टूल में रुकावट आ सकती है.- iOS 8.0-8.2 सिम्युलेटर से जुड़ी समस्याओं की वजह से, Performance Monitoring परफ़ॉर्मेंस इवेंट कैप्चर नहीं कर पाता. ये समस्याएं iOS 8.3 सिम्युलेटर और इसके बाद के वर्शन में ठीक की जाती हैं.
- NSURLSession के
backgroundSessionConfiguration
का इस्तेमाल करके बनाए गए कनेक्शन, कनेक्ट होने में ज़्यादा समय लेंगे. ये कनेक्शन, प्रोसेस के बाहर किए जाते हैं. साथ ही, इनके समय में प्रोसेस के दौरान होने वाले कॉलबैक इवेंट दिखते हैं.
अगले चरण
GitHub पर Performance Monitoring के iOS कोड के सैंपल की समीक्षा करें और उसे चलाएं.
Performance Monitoring अपने-आप इकट्ठा होने वाले डेटा के बारे में ज़्यादा जानें:
- आपके ऐप्लिकेशन के लाइफ़साइकल से जुड़ा डेटा, जैसे कि ऐप्लिकेशन शुरू होने का समय
- आपके ऐप्लिकेशन में स्क्रीन रेंडरिंग का डेटा
- आपके ऐप्लिकेशन से जारी किए गए HTTP/S नेटवर्क अनुरोधों का डेटा
Firebase कंसोल में अपना परफ़ॉर्मेंस डेटा देखें, ट्रैक करें, और फ़िल्टर करें.
कस्टम कोड ट्रेस को इंस्ट्रूमेंट करके, अपने ऐप्लिकेशन में खास टास्क या वर्कफ़्लो के लिए मॉनिटरिंग जोड़ें.
परफ़ॉर्मेंस डेटा को फ़िल्टर करने के लिए एट्रिब्यूट का इस्तेमाल करना.