এই নির্দেশিকা বর্ণনা করে কিভাবে Firebase Crashlytics SDK ব্যবহার করে আপনার ক্র্যাশ রিপোর্ট কাস্টমাইজ করতে হয়। ডিফল্টরূপে, Crashlytics স্বয়ংক্রিয়ভাবে আপনার সমস্ত অ্যাপের ব্যবহারকারীদের জন্য ক্র্যাশ রিপোর্ট সংগ্রহ করে (আপনি স্বয়ংক্রিয় ক্র্যাশ রিপোর্টিং বন্ধ করতে পারেন এবং পরিবর্তে আপনার ব্যবহারকারীদের জন্য অপ্ট-ইন রিপোর্টিং সক্ষম করতে পারেন )। Crashlytics বাক্সের বাইরে চারটি লগিং প্রক্রিয়া সরবরাহ করে: কাস্টম কী , কাস্টম লগ , ব্যবহারকারী শনাক্তকারী এবং ধরা ব্যতিক্রম ।
কাস্টম কী যোগ করুন
কাস্টম কীগুলি আপনাকে আপনার অ্যাপের নির্দিষ্ট অবস্থা পেতে সাহায্য করে যা ক্র্যাশের দিকে নিয়ে যায়। আপনি আপনার ক্র্যাশ রিপোর্টের সাথে নির্বিচারে কী/মান জোড়া সংযুক্ত করতে পারেন, তারপর Firebase কনসোলে ক্র্যাশ রিপোর্টগুলি অনুসন্ধান এবং ফিল্টার করতে কাস্টম কীগুলি ব্যবহার করুন৷
- Crashlytics ড্যাশবোর্ডে , আপনি একটি কাস্টম কী মেলে এমন সমস্যাগুলি অনুসন্ধান করতে পারেন৷
- আপনি যখন কনসোলে একটি নির্দিষ্ট সমস্যা পর্যালোচনা করছেন, আপনি প্রতিটি ইভেন্টের জন্য সংশ্লিষ্ট কাস্টম কীগুলি দেখতে পারেন ( কী সাবট্যাব) এবং এমনকি কাস্টম কী (পৃষ্ঠার শীর্ষে ফিল্টার মেনু) দ্বারা ইভেন্টগুলি ফিল্টার করতে পারেন৷
কী/মান জোড়া সেট করতে setCustomValue পদ্ধতি ব্যবহার করুন। উদাহরণ স্বরূপ:
সুইফট
// Set int_key to 100.
Crashlytics.crashlytics().setCustomValue(100, forKey: "int_key")
// Set str_key to "hello".
Crashlytics.crashlytics().setCustomValue("hello", forKey: "str_key")উদ্দেশ্য গ
পূর্ণসংখ্যা, বুলিয়ান বা ফ্লোট সেট করার সময়, মানটিকে @( value ) হিসাবে বক্স করুন।
// Set int_key to 100. [[FIRCrashlytics crashlytics] setCustomValue:@(100) forKey:@"int_key"]; // Set str_key to "hello". [[FIRCrashlytics crashlytics] setCustomValue:@"hello" forKey:@"str_key"];
আপনি কী কল করে একটি বিদ্যমান কী-এর মান পরিবর্তন করতে পারেন এবং এটিকে একটি ভিন্ন মানতে সেট করতে পারেন। উদাহরণ স্বরূপ:
সুইফট
Crashlytics.crashlytics().setCustomValue(100, forKey: "int_key") // Set int_key to 50 from 100. Crashlytics.crashlytics().setCustomValue(50, forKey: "int_key")
উদ্দেশ্য গ
[[FIRCrashlytics crashlytics] setCustomValue:@(100) forKey:@"int_key"]; // Set int_key to 50 from 100. [[FIRCrashlytics crashlytics] setCustomValue:@(50) forKey:@"int_key"];
শুধুমাত্র পরামিতি হিসাবে NSD অভিধান সহ setCustomKeysAndValues পদ্ধতি ব্যবহার করে বাল্কে কী/মান জোড়া যোগ করুন:
সুইফট
let keysAndValues = [
"string key" : "string value",
"string key 2" : "string value 2",
"boolean key" : true,
"boolean key 2" : false,
"float key" : 1.01,
"float key 2" : 2.02
] as [String : Any]
Crashlytics.crashlytics().setCustomKeysAndValues(keysAndValues)উদ্দেশ্য গ
NSDictionary *keysAndValues =
@{@"string key" : @"string value",
@"string key 2" : @"string value 2",
@"boolean key" : @(YES),
@"boolean key 2" : @(NO),
@"float key" : @(1.01),
@"float key 2" : @(2.02)};
[[FIRCrashlytics crashlytics] setCustomKeysAndValues: keysAndValues];কাস্টম লগ বার্তা যোগ করুন
ক্র্যাশের দিকে পরিচালিত ইভেন্টগুলির জন্য নিজেকে আরও প্রসঙ্গ দিতে, আপনি আপনার অ্যাপে কাস্টম ক্র্যাশলিটিক্স লগ যোগ করতে পারেন। Crashlytics লগগুলিকে আপনার ক্র্যাশ ডেটার সাথে সংযুক্ত করে এবং লগ ট্যাবের অধীনে Firebase কনসোলের Crashlytics পৃষ্ঠায় প্রদর্শন করে।
সুইফট
log() বা log(format:, arguments:) ব্যবহার করুন সমস্যাগুলি চিহ্নিত করতে সাহায্য করুন৷ আপনি যদি বার্তা সহ একটি দরকারী লগ আউটপুট পেতে চান, তাহলে আপনি যে বস্তুটি log() এ পাস করবেন সেটি অবশ্যই CustomStringConvertible সম্পত্তির সাথে সঙ্গতিপূর্ণ হবে। log() আপনি অবজেক্টের জন্য সংজ্ঞায়িত বিবরণ সম্পত্তি প্রদান করে। উদাহরণ স্বরূপ:
Crashlytics.crashlytics().log("Higgs-Boson detected! Bailing out…, \(attributesDict)")
.log(format:, arguments:) ফরম্যাট মান getVaList() কলিং থেকে ফিরে আসে। উদাহরণ স্বরূপ:
Crashlytics.crashlytics().log(format: "%@, %@", arguments: getVaList(["Higgs-Boson detected! Bailing out…", attributesDict]))
কিভাবে log() বা log(format:, arguments:) ব্যবহার করবেন সে সম্পর্কে আরো বিস্তারিত জানার জন্য, Crashlytics রেফারেন্স ডকুমেন্টেশন দেখুন।
উদ্দেশ্য গ
সমস্যা চিহ্নিত করতে সাহায্য করতে log বা logWithFormat ব্যবহার করুন। মনে রাখবেন যে আপনি যদি বার্তা সহ একটি দরকারী লগ আউটপুট পেতে চান তবে যে বস্তুটি আপনি যেকোনও পদ্ধতিতে পাস করবেন তা অবশ্যই description উদাহরণ সম্পত্তিকে ওভাররাইড করবে। উদাহরণ স্বরূপ:
[[FIRCrashlytics crashlytics] log:@"Simple string message"]; [[FIRCrashlytics crashlytics] logWithFormat:@"Higgs-Boson detected! Bailing out... %@", attributesDict]; [[FIRCrashlytics crashlytics] logWithFormat:@"Logging a variable argument list %@" arguments:va_list_arg];
কিভাবে log এবং logWithFormat ব্যবহার করতে হয় সে সম্পর্কে আরো বিস্তারিত জানার জন্য, Crashlytics রেফারেন্স ডকুমেন্টেশন পড়ুন।
ব্যবহারকারী শনাক্তকারী সেট করুন
একটি সমস্যা নির্ণয় করতে, আপনার ব্যবহারকারীদের মধ্যে কোনটি প্রদত্ত ক্র্যাশের সম্মুখীন হয়েছে তা জানা প্রায়ই সহায়ক। Crashlytics আপনার ক্র্যাশ রিপোর্টে ব্যবহারকারীদের বেনামে সনাক্ত করার একটি উপায় অন্তর্ভুক্ত করে।
আপনার রিপোর্টে ব্যবহারকারীর আইডি যোগ করতে, প্রতিটি ব্যবহারকারীকে একটি আইডি নম্বর, টোকেন বা হ্যাশ করা মান আকারে একটি অনন্য শনাক্তকারী বরাদ্দ করুন:
সুইফট
Crashlytics.crashlytics().setUserID("123456789")উদ্দেশ্য গ
[[FIRCrashlytics crashlytics] setUserID:@"123456789"];
আপনি যদি এটি সেট করার পরে কখনও একটি ব্যবহারকারী শনাক্তকারী সাফ করতে চান, তাহলে মানটিকে একটি ফাঁকা স্ট্রিংয়ে পুনরায় সেট করুন। একটি ব্যবহারকারী শনাক্তকারী সাফ করা বিদ্যমান Crashlytics রেকর্ড মুছে ফেলা হয় না। আপনি যদি একটি ব্যবহারকারী আইডির সাথে যুক্ত রেকর্ড মুছে ফেলতে চান, Firebase সহায়তার সাথে যোগাযোগ করুন ।
অপ্ট-ইন রিপোর্টিং সক্ষম করুন
ডিফল্টরূপে, Crashlytics স্বয়ংক্রিয়ভাবে আপনার সমস্ত অ্যাপের ব্যবহারকারীদের জন্য ক্র্যাশ রিপোর্ট সংগ্রহ করে। ব্যবহারকারীদের তাদের পাঠানো ডেটার উপর আরও নিয়ন্ত্রণ দিতে, আপনি স্বয়ংক্রিয় রিপোর্টিং অক্ষম করে অপ্ট-ইন রিপোর্টিং সক্ষম করতে পারেন এবং যখন আপনি আপনার কোডে চয়ন করেন তখন শুধুমাত্র Crashlytics-এ ডেটা পাঠাতে পারেন:
আপনার
Info.plistফাইলে একটি নতুন কী যোগ করে স্বয়ংক্রিয় সংগ্রহ বন্ধ করুন:- কী:
FirebaseCrashlyticsCollectionEnabled - মান:
false
- কী:
রানটাইমে Crashlytics ডেটা সংগ্রহ ওভাররাইড কল করে নির্বাচিত ব্যবহারকারীদের জন্য সংগ্রহ সক্ষম করুন। আপনার অ্যাপের লঞ্চ জুড়ে ওভাররাইড মান বজায় থাকে যাতে Crashlytics স্বয়ংক্রিয়ভাবে রিপোর্ট সংগ্রহ করতে পারে।
স্বয়ংক্রিয় ক্র্যাশ রিপোর্টিং থেকে অপ্ট আউট করতে, ওভাররাইড মান হিসাবে
falseপাস করুন।falseসেট করা হলে, অ্যাপের পরবর্তী রান না হওয়া পর্যন্ত নতুন মান প্রযোজ্য হবে না।সুইফট
Crashlytics.crashlytics().setCrashlyticsCollectionEnabled(true)
উদ্দেশ্য গ
[[FIRCrashlytics crashlytics] setCrashlyticsCollectionEnabled:YES];
ক্র্যাশ ইনসাইট ডেটা পরিচালনা করুন
ক্র্যাশ ইনসাইট আপনাকে আপনার বেনামী স্ট্যাক ট্রেসগুলিকে অন্যান্য ফায়ারবেস অ্যাপের ট্রেসের সাথে তুলনা করে এবং আপনার সমস্যাটি একটি বৃহত্তর প্রবণতার অংশ কিনা তা আপনাকে জানিয়ে সমস্যার সমাধান করতে সহায়তা করে। অনেক সমস্যার জন্য, ক্র্যাশ ইনসাইট এমনকি আপনাকে ক্র্যাশ ডিবাগ করতে সহায়তা করার জন্য সংস্থান সরবরাহ করে।
ক্র্যাশ ইনসাইট সাধারণ স্থিতিশীলতার প্রবণতা সনাক্ত করতে সমষ্টিগত ক্র্যাশ ডেটা ব্যবহার করে। আপনি যদি আপনার অ্যাপের ডেটা শেয়ার না করতে চান, তাহলে Firebase কনসোলে আপনার Crashlytics সমস্যা তালিকার শীর্ষে থাকা ক্র্যাশ ইনসাইটস মেনু থেকে আপনি ক্র্যাশ ইনসাইটগুলি অপ্ট-আউট করতে পারেন৷