Руководство по миграции на версию 2.0.0

Одновременное использование двух версий AppMetrica Push SDK

В одном приложении могут использоваться сразу две версии AppMetrica Push SDK.

Руководство по миграции

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

Для миграции на новую версию выполните следующие шаги:

1. Удалите старую версию плагина.
2. Добавьте новую версию плагина используя UPM. Подробнее смотрите в разделе про подключение плагина.
3. Замените префаб на активацию через RuntimeInitializeOnLoadMethodAttribute. Подробнее смотрите в разделе про замену префаба.
4. В коде проекта замените те классы и методы, которые были переименованы или поменяли только пакет. Подробнее смотрите в разделе про переименования.

Подключение AppMetrica Push Unity Plugin 2.0.0

Для подключения плагина используется Unity Package Manager.

Добавьте зависимости в Packages/manifest.json:

{
  "dependencies": {
      "io.appmetrica.analytics.push": "https://github.com/appmetrica/push-unity-plugin.git#v2.0.0"
  }
}

Замена префаба

1. Создайте static метод с атрибутом [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)] и произведите активацию AppMetricaPush с помощью метода AppMetricaPush.Activate().

   Пример:

   using Io.AppMetrica;
   using Io.AppMetrica.Push;
   using UnityEngine;
   
   public static class AppMetricaActivator {
       [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)]
       private static void Activate() {
           AppMetrica.Activate(new AppMetricaConfig("APIKey"));
           AppMetricaPush.Activate();
       }
   }
   

   Примечание

   AppMetricaPush.Activate() должен вызываться после AppMetrica.Activate().

2. Удалите AppMetricaPush префаб с ваших сцен.

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

• Интерфейс IYandexMetricaPush удален, методы перенесены в класс AppMetricaPush.
  • Метод Initialize переименован в Activate.