خرابی‌ها و استثناها - iOS SDK، خرابی‌ها و استثناها - iOS SDK، خرابی‌ها و استثناها - iOS SDK

این سند یک نمای کلی سطح بالا از اندازه‌گیری خرابی و استثنا با استفاده از Google Analytics SDK برای iOS نسخه 3 ارائه می‌کند.

بررسی اجمالی

اندازه‌گیری خرابی و استثنا به شما امکان می‌دهد تعداد و نوع خرابی‌ها و استثناهایی را که در برنامه شما رخ می‌دهد اندازه‌گیری کنید. یک استثنا دارای این فیلدها است:

نام زمینه	میدان ردیاب	تایپ کنید	ضروری	شرح
شرح	`kGAIExDescription`	`NSString`	خیر	شرح استثنا (حداکثر 100 کاراکتر). `nil` می پذیرد.
کشنده است	`kGAIExFatal`	`BOOL`	آره	نشان می دهد که آیا استثنا کشنده بوده است یا خیر. `YES` نشان دهنده کشنده است.

داده‌های خرابی و استثنا عمدتاً در گزارش خرابی و استثناء موجود است.

گرفتار استثنا

استثناهای کشف شده خطاهایی در برنامه شما هستند که کدهای مدیریت استثنا را برای آنها تعریف کرده اید، مانند وقفه زمانی اتصال شبکه در طول درخواست داده.

با تنظیم مقادیر فیلد استثنا در ردیاب و ارسال ضربه، مانند این مثال، یک استثنای گرفته شده را اندازه گیری کنید:

/*
 * An app tries to load a list of high scores from the cloud. If the request
 * times out, an exception is sent to Google Analytics
 */
@try {

  // Request some scores from the network.
  NSArray *highScores = [self getHighScoresFromCloud];

}
@catch (NSException *exception) {

    // May return nil if a tracker has not already been initialized with a
    // property ID.
    id tracker = [[GAI sharedInstance] defaultTracker];

    [tracker send:[[GAIDictionaryBuilder
        createExceptionWithDescription:@"Connection timeout"  // Exception description. May be truncated to 100 chars.
                             withFatal:@NO] build]];  // isFatal (required). NO indicates non-fatal exception.
}

اندازه‌گیری استثنای کشف نشده

استثناهای کشف نشده مواردی را نشان می‌دهند که برنامه شما در زمان اجرا با شرایط غیرمنتظره‌ای مواجه می‌شود و اغلب کشنده است و باعث از کار افتادن برنامه می‌شود. با تنظیم ویژگی trackUncaughtExceptions بر روی YES ، استثناهای کشف نشده را می توان به طور خودکار به Google Analytics ارسال کرد. به عنوان مثال:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  [[GAI sharedInstance] setTrackUncaughtExceptions:YES];
  return YES;
}

هنگام استفاده از اندازه گیری استثنای خودکار، موارد زیر را در نظر داشته باشید:

همه استثناهای ارسال شده با استفاده از اندازه گیری استثنای خودکار به عنوان مرگبار در Google Analytics گزارش می شوند.
به طور پیش فرض، فیلد توضیحات به طور خودکار با استفاده از نوع استثنا، نام کلاس، نام روش و نام رشته تنظیم می شود.

بررسی اجمالی

نام زمینه	میدان ردیاب	تایپ کنید	ضروری	شرح
شرح	`kGAIExDescription`	`NSString`	خیر	شرح استثنا (حداکثر 100 کاراکتر). `nil` می پذیرد.
کشنده است	`kGAIExFatal`	`BOOL`	آره	نشان می دهد که آیا استثنا کشنده بوده است یا خیر. `YES` نشان دهنده کشنده است.

داده‌های خرابی و استثنا عمدتاً در گزارش خرابی و استثناء موجود است.

گرفتار استثناها

با تنظیم مقادیر فیلد استثنا در ردیاب و ارسال ضربه، مانند این مثال، یک استثنای گرفته شده را اندازه گیری کنید:

/*
 * An app tries to load a list of high scores from the cloud. If the request
 * times out, an exception is sent to Google Analytics
 */
@try {

  // Request some scores from the network.
  NSArray *highScores = [self getHighScoresFromCloud];

}
@catch (NSException *exception) {

    // May return nil if a tracker has not already been initialized with a
    // property ID.
    id tracker = [[GAI sharedInstance] defaultTracker];

    [tracker send:[[GAIDictionaryBuilder
        createExceptionWithDescription:@"Connection timeout"  // Exception description. May be truncated to 100 chars.
                             withFatal:@NO] build]];  // isFatal (required). NO indicates non-fatal exception.
}

اندازه‌گیری استثنای کشف نشده

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  [[GAI sharedInstance] setTrackUncaughtExceptions:YES];
  return YES;
}

هنگام استفاده از اندازه گیری استثنای خودکار، موارد زیر را در نظر داشته باشید:

همه استثناهای ارسال شده با استفاده از اندازه گیری استثنای خودکار به عنوان مرگبار در Google Analytics گزارش می شوند.
به طور پیش فرض، فیلد توضیحات به طور خودکار با استفاده از نوع استثنا، نام کلاس، نام روش و نام رشته تنظیم می شود.

بررسی اجمالی

نام زمینه	میدان ردیاب	تایپ کنید	ضروری	شرح
شرح	`kGAIExDescription`	`NSString`	خیر	شرح استثنا (حداکثر 100 کاراکتر). `nil` می پذیرد.
کشنده است	`kGAIExFatal`	`BOOL`	آره	نشان می دهد که آیا استثنا کشنده بوده است یا خیر. `YES` نشان دهنده کشنده است.

داده‌های خرابی و استثنا عمدتاً در گزارش خرابی و استثناء موجود است.

گرفتار استثنا

با تنظیم مقادیر فیلد استثنا در ردیاب و ارسال ضربه، مانند این مثال، یک استثنای گرفته شده را اندازه گیری کنید:

/*
 * An app tries to load a list of high scores from the cloud. If the request
 * times out, an exception is sent to Google Analytics
 */
@try {

  // Request some scores from the network.
  NSArray *highScores = [self getHighScoresFromCloud];

}
@catch (NSException *exception) {

    // May return nil if a tracker has not already been initialized with a
    // property ID.
    id tracker = [[GAI sharedInstance] defaultTracker];

    [tracker send:[[GAIDictionaryBuilder
        createExceptionWithDescription:@"Connection timeout"  // Exception description. May be truncated to 100 chars.
                             withFatal:@NO] build]];  // isFatal (required). NO indicates non-fatal exception.
}

اندازه‌گیری استثنای کشف نشده

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  [[GAI sharedInstance] setTrackUncaughtExceptions:YES];
  return YES;
}

هنگام استفاده از اندازه گیری استثنای خودکار، موارد زیر را در نظر داشته باشید:

همه استثناهای ارسال شده با استفاده از اندازه گیری استثنای خودکار به عنوان مرگبار در Google Analytics گزارش می شوند.
به طور پیش فرض، فیلد توضیحات به طور خودکار با استفاده از نوع استثنا، نام کلاس، نام روش و نام رشته تنظیم می شود.