Подключение и инициализация

Чтобы интегрировать AppMetrica Push SDK в приложение Flutter, используйте плагин AppMetrica Push SDK for Flutter:

  1. Установите плагин AppMetrica Push SDK в свой проект. Из корня проекта вызовите команду:

    flutter pub add appmetrica_push_plugin
    

    После добавления плагина в файле pubspec.yaml появится строка с зависимостью:

    dependencies:
        appmetrica_push_plugin: ^2.0.0
    
  2. Добавьте импорт appmetrica_plugin и appmetrica_push_plugin:

    import 'package:appmetrica_plugin/appmetrica_plugin.dart';
    import 'package:appmetrica_push_plugin/appmetrica_push_plugin.dart';
    
  3. Инициализируйте библиотеку AppMetrica SDK с помощью AppMetrica.activate и вашего API key:

    AppMetrica.activate(AppMetricaConfig("insert_your_api_key_here"));
    
  4. Инициализируйте AppMetrica Push SDK через AppMetricaPush.activate и вашего API key:

    AppMetricaPush.activate();
    
  5. Чтобы завершить интеграцию отправления пуш-уведомлений, воспользуйтесь документацией для каждой нативной платформы:

    1. Настройте приложение для использования Firebase. Получите и добавьте в AppMetrica ключ сервера для использования Firebase Cloud Messaging.

    2. Подключите транспорт Firebase, добавив в файл android/app/build.gradle зависимости:

    dependencies {
       implementation "com.google.firebase:firebase-messaging: 22.0.0"
       implementation "com.google.android.gms:play-services-base: 17.5.0"
    }
    

    3. Инициализируйте транспорт Firebase, используя один из способов:

    Использование Google Services Plugin

    1. Загрузите конфигурационный файл google-services.json и разместите его в каталоге модуля проекта (например, app).

    2. Для корректной работы с файлом подключите плагин Google Services в проект, добавив следующие строки в Gradle файл:

    проекта
    • build.gradle.kts

      buildscript {
            dependencies {
               classpath("com.google.gms:google-services:4.4.0")
            }
         }
      
    • build.gradle

      buildscript {
         dependencies {
            classpath "com.google.gms:google-services:4.4.0"
         }
      }
      
    приложения (модуля)
    • app/build.gradle.kts

      apply(plugin = "com.google.gms.google-services")
      
    • app/build.gradle

      apply plugin: "com.google.gms.google-services"
      
    Без использования плагина

    Внесите изменения в элемент application файла AndroidManifest.xml:

    <meta-data android:name="ymp_firebase_default_app_id" android:value="APP_ID"/>
    <meta-data android:name="ymp_gcm_default_sender_id" android:value="number:SENDER_ID"/>
    <meta-data android:name="ymp_firebase_default_api_key" android:value="API_KEY"/>
    <meta-data android:name="ymp_firebase_default_project_id" android:value="PROJECT_ID"/>
    

    APP_ID — идентификатор приложения в Firebase. Его можно узнать в консоли Firebase: перейдите в Настройки проекта. В разделе Ваши приложения скопируйте значение поля Идентификатор приложения.

    SENDER_ID— уникальный идентификатор отправителя в Firebase. Его можно узнать в консоли Firebase: перейдите во вкладку Настройки проекта → Cloud Messaging и скопируйте значение поля Идентификатор отправителя.

    API_KEY — ключ приложения в Firebase. Его можно найти в поле current_key файла google-services.json. Файл можно скачать из консоли Firebase.

    PROJECT_ID — id приложения в Firebase. Его можно найти в поле project_id файла google-services.json. Файл можно скачать из консоли Firebase.

    Использование с другими Firebase-проектами

    Внесите изменения в элемент application файла AndroidManifest.xml:

    <meta-data android:name="ymp_firebase_app_id" android:value="APP_ID"/>
    <meta-data android:name="ymp_gcm_sender_id" android:value="number:SENDER_ID"/>
    <meta-data android:name="ymp_firebase_api_key" android:value="API_KEY"/>
    <meta-data android:name="ymp_firebase_project_id" android:value="PROJECT_ID"/>
    

    APP_ID — идентификатор приложения в Firebase. Его можно узнать в консоли Firebase: перейдите в Настройки проекта. В разделе Ваши приложения скопируйте значение поля Идентификатор приложения.

    SENDER_ID— уникальный идентификатор отправителя в Firebase. Его можно узнать в консоли Firebase: перейдите во вкладку Настройки проекта → Cloud Messaging и скопируйте значение поля Идентификатор отправителя.

    API_KEY — ключ приложения в Firebase. Его можно найти в поле current_key файла google-services.json. Файл можно скачать из консоли Firebase.

    PROJECT_ID — id приложения в Firebase. Его можно найти в поле project_id файла google-services.json. Файл можно скачать из консоли Firebase.

    Внимание

    Вам необходимо самостоятельно инициализировать Firebase-проект по умолчанию.

    4. По желанию настройте Silent Push Notifications или включите актуализацию push‑токенов.

    1. Добавьте SSL-сертификат в AppMetrica по инструкции.

    2. Добавьте в свой XCode проект Capability Push Notifications.

    3. По желанию включите актуализацию push-токенов или настройте загрузку прикрепленных файлов.

    4. Настройте сбор статистики.

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

Написать в службу поддержки
Предыдущая
Следующая