Apple প্ল্যাটফর্মের জন্য পারফরম্যান্স মনিটরিং দিয়ে শুরু করুন

আপনি শুরু করার আগে

যদি আপনি ইতিমধ্যেই না করে থাকেন, তাহলে আপনার Apple প্রকল্পে Firebase যোগ করুন ।

দ্রষ্টব্য: Firebase CocoPods এবং Swift Package Manager উভয়কেই সমর্থন করে। আপনি যদি Swift Package Manager ব্যবহার করে Firebase ইন্সটল করতে চান, তাহলে আপনি CocoaPods-সম্পর্কিত ধাপগুলি এড়িয়ে যেতে পারেন, যেমন Podfiles পরিবর্তন করা এবং pod কমান্ড চালানো।

ধাপ 1 : আপনার অ্যাপে Performance Monitoring যোগ করুন

আপনি Performance Monitoring SDK যোগ করার পরে, Firebase স্বয়ংক্রিয়ভাবে আপনার অ্যাপের স্ক্রিন রেন্ডারিংয়ের জন্য ডেটা সংগ্রহ করা শুরু করে, আপনার অ্যাপের জীবনচক্রের সাথে সম্পর্কিত ডেটা (যেমন অ্যাপ শুরুর সময় ) এবং HTTP/S নেটওয়ার্ক অনুরোধের ডেটা।

ফায়ারবেস নির্ভরতা ইনস্টল এবং পরিচালনা করতে সুইফট প্যাকেজ ম্যানেজার ব্যবহার করুন।

সরাসরি ফ্রেমওয়ার্ক আমদানি করা এবং CocoaPods ব্যবহার করা সহ আপনার Apple প্রকল্পে Firebase SDK যোগ করার বিভিন্ন উপায় সম্পর্কে জানতে আমাদের ইনস্টলেশন গাইড দেখুন।

1. Xcode-এ, আপনার অ্যাপ প্রকল্প খোলার সাথে, ফাইল > প্যাকেজ যোগ করুন- এ নেভিগেট করুন।
2. অনুরোধ করা হলে, Firebase Apple প্ল্যাটফর্ম SDK সংগ্রহস্থল যোগ করুন:

  https://github.com/firebase/firebase-ios-sdk.git

দ্রষ্টব্য: নতুন প্রকল্পগুলির ডিফল্ট (সর্বশেষ) SDK সংস্করণ ব্যবহার করা উচিত, তবে প্রয়োজনে আপনি একটি পুরানো সংস্করণ চয়ন করতে পারেন৷
3. Performance Monitoring লাইব্রেরি বেছে নিন।
4. আপনার লক্ষ্যের বিল্ড সেটিংসের অন্যান্য লিঙ্কার ফ্ল্যাগ বিভাগে -ObjC পতাকা যোগ করুন।
5. শেষ হয়ে গেলে, Xcode স্বয়ংক্রিয়ভাবে পটভূমিতে আপনার নির্ভরতাগুলি সমাধান এবং ডাউনলোড করা শুরু করবে।

এর পরে, Firebase মডিউল কনফিগার করুন:

1. আপনার UIApplicationDelegate এ FirebaseCore মডিউল আমদানি করুন, সেইসাথে আপনার অ্যাপ প্রতিনিধি যে কোনো Firebase মডিউল ব্যবহার করেন। উদাহরণস্বরূপ, Cloud Firestore এবং Authentication ব্যবহার করতে:

   সুইফটইউআই

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

   সুইফট

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   উদ্দেশ্য-C

   @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()

   উদ্দেশ্য-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. আপনার অ্যাপ্লিকেশন পুনরায় কম্পাইল.

দ্রষ্টব্য: আপনি যখন আপনার অ্যাপে Performance Monitoring যোগ করেন, তখন Remote Config SDK নির্ভরতা হিসেবে অন্তর্ভুক্ত করা হয়। আপনি যদি আগে থেকেই Remote Config ব্যবহার করেন তাহলে আপনি কোনো পার্থক্য দেখতে পাবেন না। যাইহোক, আপনি যদি Remote Config এ নতুন হয়ে থাকেন, তাহলে আপনার অ্যাপে অ্যাক্সেস করতে পারবেন এমন বিভিন্ন বৈশিষ্ট্য সম্পর্কে আরও জানতে Remote Config ডকুমেন্টেশনটি অন্বেষণ করুন।

ধাপ 2 : প্রাথমিক তথ্য প্রদর্শনের জন্য কর্মক্ষমতা ইভেন্ট তৈরি করুন

আপনি সফলভাবে আপনার অ্যাপে SDK যোগ করলে Firebase ইভেন্টগুলি প্রক্রিয়া করা শুরু করে। আপনি যদি এখনও স্থানীয়ভাবে বিকাশ করছেন, প্রাথমিক ডেটা সংগ্রহ এবং প্রক্রিয়াকরণের জন্য ইভেন্ট তৈরি করতে আপনার অ্যাপের সাথে যোগাযোগ করুন।

দ্রষ্টব্য: Performance Monitoring SDK স্থানীয়ভাবে ইভেন্টগুলি ব্যাচ করে তারপর সেগুলিকে পর্যায়ক্রমে (প্রতি 30 সেকেন্ডে) Firebase-এ পাঠায় বা যখন অ্যাপটি ফোরগ্রাউন্ডে ফিরে আসে। সুতরাং, একটি অ্যাপ ইন্টারঅ্যাকশন এবং Firebase আপনার অ্যাপ থেকে ইভেন্টের তথ্য গ্রহণ করার মধ্যে একটি বিলম্ব আছে।

1. একটি সিমুলেটর বা টেস্ট ডিভাইস ব্যবহার করে আপনার অ্যাপ ডেভেলপ করা চালিয়ে যান।

2. আপনার অ্যাপকে ব্যাকগ্রাউন্ড এবং ফোরগ্রাউন্ডের মধ্যে বেশ কয়েকবার স্যুইচ করে, স্ক্রিন জুড়ে নেভিগেট করে আপনার অ্যাপের সাথে ইন্টারঅ্যাক্ট করে এবং/অথবা নেটওয়ার্ক অনুরোধগুলি ট্রিগার করে ইভেন্ট তৈরি করুন।

3. Firebase কনসোলের পারফরম্যান্স ড্যাশবোর্ডে যান। আপনি কয়েক মিনিটের মধ্যে আপনার প্রাথমিক তথ্য প্রদর্শন দেখতে হবে.

   আপনি যদি আপনার প্রাথমিক ডেটার একটি প্রদর্শন দেখতে না পান, তাহলে সমস্যা সমাধানের টিপস পর্যালোচনা করুন৷

ধাপ 3 : (ঐচ্ছিক) কর্মক্ষমতা ইভেন্টের জন্য লগ বার্তা দেখুন

1. ডিবাগ লগিং সক্ষম করুন, নিম্নরূপ:

   1. Xcode (সর্বনিম্ন v15.2) এ, পণ্য > স্কিম > স্কিম সম্পাদনা করুন নির্বাচন করুন।
   2. বাম মেনু থেকে রান নির্বাচন করুন, তারপর আর্গুমেন্ট ট্যাব নির্বাচন করুন।
   3. আর্গুমেন্ট পাসড অন লঞ্চ বিভাগে, -FIRDebugEnabled যোগ করুন।

2. কোনো ত্রুটি বার্তা জন্য আপনার লগ বার্তা পরীক্ষা করুন.

3. Performance Monitoring এর লগ বার্তাগুলিকে Firebase/Performance দিয়ে ট্যাগ করে যাতে আপনি আপনার লগ বার্তাগুলিকে ফিল্টার করতে পারেন।

4. নিম্নলিখিত ধরনের লগগুলির জন্য পরীক্ষা করুন যা নির্দেশ করে যে Performance Monitoring পারফরম্যান্স ইভেন্টগুলি লগিং করছে:

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

5. Firebase কনসোলে আপনার ডেটা দেখতে URL-এ ক্লিক করুন। ড্যাশবোর্ডে ডেটা আপডেট হতে কয়েক মুহূর্ত সময় লাগতে পারে।

যদি আপনার অ্যাপ পারফরম্যান্স ইভেন্টগুলি লগিং না করে, তাহলে সমস্যা সমাধানের টিপস পর্যালোচনা করুন৷

ধাপ 4 : (ঐচ্ছিক) নির্দিষ্ট কোডের জন্য কাস্টম মনিটরিং যোগ করুন

আপনার অ্যাপে নির্দিষ্ট কোডের সাথে যুক্ত কর্মক্ষমতা ডেটা নিরীক্ষণ করতে, আপনি কাস্টম কোড ট্রেস যন্ত্র করতে পারেন।

একটি কাস্টম কোড ট্রেস দিয়ে, আপনি পরিমাপ করতে পারেন যে আপনার অ্যাপটি একটি নির্দিষ্ট কাজ বা কাজের সেট সম্পূর্ণ করতে কতক্ষণ সময় নেয়, যেমন ছবির একটি সেট লোড করা বা আপনার ডাটাবেস অনুসন্ধান করা। একটি কাস্টম কোড ট্রেসের জন্য ডিফল্ট মেট্রিক হল এর সময়কাল, তবে আপনি কাস্টম মেট্রিক্সও যোগ করতে পারেন, যেমন ক্যাশে হিট এবং মেমরি সতর্কতা।

আপনার কোডে, আপনি Performance Monitoring SDK দ্বারা প্রদত্ত API ব্যবহার করে একটি কাস্টম কোড ট্রেসের শুরু এবং শেষ (এবং যেকোনো পছন্দসই কাস্টম মেট্রিক্স যোগ করুন) সংজ্ঞায়িত করেন।

এই বৈশিষ্ট্যগুলি সম্পর্কে আরও জানতে এবং কীভাবে সেগুলিকে আপনার অ্যাপে যুক্ত করবেন তা জানতে নির্দিষ্ট কোডের জন্য নিরীক্ষণ যোগ করুন- এ যান৷

ধাপ 5 : আপনার অ্যাপ স্থাপন করুন তারপর ফলাফল পর্যালোচনা করুন

আপনি Xcode সিমুলেটর এবং এক বা একাধিক পরীক্ষা ডিভাইস ব্যবহার করে Performance Monitoring যাচাই করার পরে, আপনি আপনার ব্যবহারকারীদের কাছে আপনার অ্যাপের আপডেট করা সংস্করণ স্থাপন করতে পারেন।

আপনি Firebase কনসোলের পারফরম্যান্স ড্যাশবোর্ডে কর্মক্ষমতা ডেটা নিরীক্ষণ করতে পারেন।

পরিচিত সমস্যা

• GTMSQLite-এর সাথে Performance Monitoring সামঞ্জস্যপূর্ণ সমস্যা রয়েছে। আমরা 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 কনসোলে আপনার কর্মক্ষমতা ডেটা দেখুন, ট্র্যাক করুন এবং ফিল্টার করুন ।

• কাস্টম কোড ট্রেস ইনস্ট্রুমেন্ট করে আপনার অ্যাপে নির্দিষ্ট কাজ বা কর্মপ্রবাহের জন্য মনিটরিং যোগ করুন।

• কর্মক্ষমতা ডেটা ফিল্টার করতে বৈশিষ্ট্যগুলি ব্যবহার করুন ৷