Руководство по переходу на Android SDK 3.0.0

Руководство содержит примеры, демонстрирующие различия между версиями SDK версий 2.80 и 3.0.0. В разделе рассматриваются только те методы, в которых нарушена обратная совместимость.

  1. Добавлено
  2. Переименовано
  3. Удалено

Добавлено

Активация репортеров
Вызывается до первого обращения к репортеру. Если обращение к репортеру уже было, активация не изменит параметры. Пример:
YandexMetrica.activateReporter(this, ReporterConfig.newConfigBuilder(API_KEY)
              .withSessionTimeout(100)
              .build());
Профили
Добавлены следующие классы для работы с пользовательскими профилями:

В класс YandexMetrica добавлены следующие методы по работе с профилями:

В интерфейс IReporter добавлены следующие методы по работе с профилями:

Revenue
Добавлены следующие классы для трекинга выручки:

В класс YandexMetrica добавлен следующий метод:

В протокол IReporter добавлен следующий метод:

Переименовано

Класс YandexMetrica.

Версия 2.80 Версия 3.0.0
onResumeActivity(Activity activity)
// Возобновляет сессию.
resumeSession(Activity activity)
onPauseActivity(Activity activity)
// Приостанавливает сессию.
pauseSession(Activity activity)
setTrackLocationEnabled(boolean enabled)
// Включает отправку данных о местоположении устройства.
setLocationTracking(boolean enabled)

Класс YandexMetricaConfig.

Версия 2.80 Версия 3.0.0
getApiKey()
// API-ключ приложения.
public final String apiKey;
getAppVersion()
// Версия приложения.
public final String appVersion
getSessionTimeout()
// Тайм-аут сессии.
public final Integer sessionTimeout
isReportCrashEnabled()
// Отслеживание аварийных остановок приложений.
public final Boolean crashReporting;
isReportNativeCrashEnabled()
// Отслеживание нативных аварийных остановок приложений.
public final Boolean nativeCrashReporting;
getLocation()
// Задаваемые пользователем данные о местоположении устройства.
public final Location location;
isTrackLocationEnabled()
// Отправка данных о местоположении устройства.
public final Boolean locationTracking;
isCollectInstalledApps()
// Отправка сведений об установленных приложениях.
public final Boolean installedAppCollecting;
isLogEnabled
// Вывод логов библиотекой.
public final Boolean logs;
getPreloadInfo()
// Сведения для отслеживания предустановленных приложений.
public final PreloadInfo preloadInfo;
handleFirstActivationAsUpdate()
// Первый запуск приложения с AppMetrica SDK следует трактовать как первый запуск обновленной версии приложения, а не как установку.
public final Boolean firstActivationAsUpdate;

Класс YandexMetricaConfig.Builder.

Версия 2.80 Версия 3.0.0
setAppVersion()
// Задает версию приложения.
withAppVersion()
setSessionTimeout()
// Задает тайм-аут сессии.
withSessionTimeout()
setReportCrashEnabled()
// Включает отслеживание аварийных остановок приложений.
withCrashReporting()
setReportNativeCrashesEnabled()
// Включает отслеживание нативных аварийных остановок приложений.
withNativeCrashReporting()
setLocation()
// Задает данные о местоположении устройства.
withLocation()
setTrackLocationEnabled()
// Включает отправку данных о местоположении устройства.
withLocationTracking()
setCollectInstalledApps()
// Включает отправку сведений об установленных приложениях.
withInstalledAppCollecting()
setLogEnabled
// Включает вывод логов библиотекой.
withLogs()
setPreloadInfo()
// Устанавливает сведения для отслеживания предустановленных приложений.
withPreloadInfo()

Удалено

Версия 2.80 Версия 3.0.0
Активация библиотеки с API-ключом.
YandexMetrica.activate(getApplicationContext(), API_KEY);
YandexMetricaConfig.Builder configBuilder = YandexMetricaConfig.newConfigBuilder(API_KEY);
YandexMetrica.activate(getApplicationContext(), сonfigBuilder.build());

Активировать библиотеку можно только через расширенную конфигурацию YandexMetricaConfig.

Установка продолжительности сессии.
YandexMetrica.setSessionTimeout(30);
Настроить таймаут сессии можно только через расширенную конфигурацию YandexMetricaConfig.
Включение сбора аварийных остановок приложения.
YandexMetrica.setReportCrashesEnabled(true);
YandexMetrica.setReportNativeCrashesEnabled(true);
Включить сбор крэшей (аварийных остановок приложения) можно только через расширенную конфигурацию YandexMetricaConfig.
Установка версии приложения
YandexMetrica.setCustomAppVersion("1.0.5");
Установить пользовательскую версию приложения можно только через расширенную конфигурацию YandexMetricaConfig.
Включение логирования
YandexMetrica.setLogEnabled();
Включить логирование можно только через расширенную конфигурацию YandexMetricaConfig.
Включение отправки сведений об установленных на устройстве приложениях.
YandexMetrica.setCollectInstalledApps(boolean collect);
YandexMetrica.isCollectInstalledApps();
Включить отправка сведений об установленных на устройстве приложениях можно только через расширенную конфигурацию YandexMetricaConfig.
Установка параметров окружения событий.
YandexMetrica.setEnvironmentValue(String key, String value);
Удален.