Протокол AMAAppMetricaCrashReporting
Протокол AMAAppMetricaCrashReporting
содержит методы, которые используются для кастомизации сообщений об ошибках и сбоях.
Методы экземпляра
Отправляет сообщение об ошибке типа |
|
Отправляет сообщение об ошибке типа |
|
Отправляет сообщение об ошибке, соответствующей протоколу |
|
Отправляет сообщение об ошибке, соответствующей протоколу |
|
Устанавливает пару «ключ-значение», которая будет связана с ошибками и сбоями. |
|
Создает |
Описание методов
-reportNSError:onFailure:
- (void)reportNSError:(NSError *)error
onFailure:(nullable void (^)(NSError *error))onFailure report(nserror:onFailure:);
Отправляет сообщение об ошибке типа NSError
, которые соответствуют определенным ограничениям на domain
, userInfo
и другие свойства.
Можно включить обратную трассировку в NSError
, используя константу AMABacktraceErrorKey
в userInfo
.
Ограничения:
domain
— не более 200 символов.userInfo
— Не более 50 пар «ключ-значение», длина ключа — не более 100 символов, длина значения — не более 2000 символов.NSUnderlyingErrorKey
— Используя этот ключ вuserInfo
, можно включить не более 10 ошибок.AMABacktraceErrorKey
— Используя этот ключ вuserInfo
, можно включить максимум 200 стековых кадров в обратную трассировку.
Если значение превысит указанное ограничение, AppMetrica обрежет его.
Параметры:
|
Объект |
|
Callback-метод, который будет вызван при сбое передачи сообщения. Ошибка |
-reportNSError:options:onFailure:
- (void)reportNSError:(NSError *)error
options:(AMAErrorReportingOptions)options
onFailure:(nullable void (^)(NSError *error))onFailure report(nserror:options:onFailure:);
Отправляет кастомизированное сообщение об ошибке типа NSError
, соблюдая ограничения для свойств domain
, userInfo
и других.
Можно включить обратную трассировку в NSError
, используя константу AMABacktraceErrorKey
в userInfo
.
Ограничения:
domain
— не более 200 символов.userInfo
— Не более 50 пар «ключ-значение», длина ключа — не более 100 символов, длина значения — не более 2000 символов.NSUnderlyingErrorKey
— Используя этот ключ вuserInfo
, можно включить не более 10 ошибок.AMABacktraceErrorKey
— Используя этот ключ вuserInfo
, можно включить максимум 200 стековых кадров в обратную трассировку.
Если значение превысит любое из этих ограничений, AppMetrica обрежет его.
Параметры:
|
Объект |
|
Дополнительные опции AMAErrorReportingOptions, которые определяют, как должно быть передано сообщение об ошибке. |
|
Callback-метод, который будет вызван при сбое передачи сообщения. Ошибка |
-reportError:onFailure:
- (void)reportError:(id<AMAErrorRepresentable>)error
onFailure:(nullable void (^)(NSError *error))onFailure report(error:onFailure:);
Отправляет сообщение об ошибке, соответствующей протоколу AMAErrorRepresentable.
Параметры:
|
Ошибка, соответствующая протоколу |
|
Callback-метод, который будет вызван при сбое передачи сообщения. Ошибка |
-reportError:options:onFailure:
- (void)reportError:(id<AMAErrorRepresentable>)error
options:(AMAErrorReportingOptions)options
onFailure:(nullable void (^)(NSError *error))onFailure report(error:options:onFailure:);
Отправляет сообщение об ошибке, соответствующей протоколу AMAErrorRepresentable, с дополнительными возможностями кастомизации сообщения.
Параметры:
|
Ошибка, соответствующая протоколу |
|
Дополнительные опции AMAErrorReportingOptions, которые определяют, как должно быть передано сообщение об ошибке. |
|
Callback-метод, который будет вызван при сбое передачи сообщения. Ошибка |
-setErrorEnvironmentValue:forKey:
- (void)setErrorEnvironmentValue:(nullable NSString *)value
forKey:(NSString *)key set(errorEnvironmentValue:forKey:);
Устанавливает пару «ключ-значение», которая будет связана с ошибками и сбоями. AppMetrica использует ее как дополнительную информацию для необработанных исключений.
Параметры:
|
Значение, которое нужно связать с ключом. Если передать |
|
Ключ, с которым должно быть связано значение. |
-pluginExtension:
- (id<AMAAppMetricaPlugins>)pluginExtension;
Создает экземпляр AMAAppMetricaPlugins
, который может отправлять события плагина на основной ключ API. Можно запрашивать его каждый раз по необходимости или сохранить ссылку на него для повторного использования. Для использования этого расширения нужно сначала активировать AppMetrica с помощью [AMAAppMetrica activateWithConfiguration:]
.
Возвращает:
Экземпляр расширения плагина.