Протокол YMMYandexMetricaPlugins

Расширение для YMMYandexMetrica. Используется для отправки ошибок из плагинов.

Экземпляр объекта может быть получен с помощью вызова метода YMMYandexMetrica#getPluginExtension. Будет создан один экземпляр объекта.

Для использования протокола необходимо инициализировать библиотеку с помощью метода activateWithConfiguration.

Методы экземпляра

-reportUnhandledException:onFailure:

Отправляет необработанную ошибку.
-reportError:message:onFailure:

Отправляет произвольное сообщение об ошибке.
-reportErrorWithIdentifier:message:details:onFailure:

Отправляет произвольное сообщение об ошибке с идентификатором.
-handlePluginInitFinished

Уведомляет AppMetrica о завершении инициализации плагина.
-reportUnhandledException:onFailure:

Отправляет необработанную ошибку.
-reportError:message:onFailure:

Отправляет произвольное сообщение об ошибке.
-reportErrorWithIdentifier:message:details:onFailure:

Отправляет произвольное сообщение об ошибке с идентификатором.
-handlePluginInitFinished

Уведомляет AppMetrica о завершении инициализации плагина.

Описание методов

reportUnhandledException:onFailure:


- (void)reportUnhandledException:(YMMPluginErrorDetails *)errorDetails
                       onFailure:(nullable void (^)(NSError *error))onFailure

Отправляет необработанную ошибку.

Параметры:
errorDetails Объект с описанием ошибки.
onFailure Блок, который выполняется при возникновении ошибки. Ошибка передается как аргумент блока.
errorDetails Объект с описанием ошибки.
onFailure Блок, который выполняется при возникновении ошибки. Ошибка передается как аргумент блока.

reportError:message:onFailure:


- (void)reportUnhandledException:(YMMPluginErrorDetails *)errorDetails
                       onFailure:(nullable void (^)(NSError *error))onFailure

Отправляет произвольное сообщение об ошибке.

Ошибки будут сгруппированы по бэктрейсу.

Параметры:
errorDetails

Объект с описанием ошибки.
message

Описание или имя ошибки.
onFailure

Блок, который выполняется при возникновении ошибки. Ошибка передается как аргумент блока.
errorDetails

Объект с описанием ошибки.
message

Описание или имя ошибки.
onFailure

Блок, который выполняется при возникновении ошибки. Ошибка передается как аргумент блока.
Примечание. Чтобы ошибка была отправлена, стектрейс не должен быть пустым.

reportError:message:details:onFailure:


- (void)reportErrorWithIdentifier:(NSString *)identifier
                          message:(nullable NSString *)message
                          details:(nullable YMMPluginErrorDetails *)errorDetails
                        onFailure:(nullable void (^)(NSError *error))onFailure

Отправляет произвольное сообщение об ошибке с идентификатором. Идентификатор будет использоваться для группировки ошибок.

Параметры:
identifier

Идентификатор, используемый для группировки.

Максимальная длина — 300 символов.

Если значение превышает ограничение, AppMetrica обрезает его.
message

Описание или имя ошибки.

Максимальная длина — 1000 символов.

Если значение превышает ограничение, AppMetrica обрезает его.
errorDetails

Объект с описанием ошибки.
onFailure

Блок, который выполняется при возникновении ошибки. Ошибка передается как аргумент блока.
identifier

Идентификатор, используемый для группировки.

Максимальная длина — 300 символов.

Если значение превышает ограничение, AppMetrica обрезает его.
message

Описание или имя ошибки.

Максимальная длина — 1000 символов.

Если значение превышает ограничение, AppMetrica обрезает его.
errorDetails

Объект с описанием ошибки.
onFailure

Блок, который выполняется при возникновении ошибки. Ошибка передается как аргумент блока.

handlePluginInitFinished

- (void)handlePluginInitFinished

Уведомляет AppMetrica о завершении инициализации плагина.

Плагины должны вызывать этот метод, чтобы AppMetrica корректно обрабатывала сеансы.

Метод должен быть вызван сразу после инициализации, если приложение находится в foreground-сессии.