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

AppMetrica React Native — это плагин для платформы React Native. Он включает поддержку AppMetrica SDK для Android и iOS.

Минимальная поддерживаемая версия React Native — 0.59.

Ниже описаны этапы подключения и инициализации AppMetrica React Native:

  1. Шаг 1. Подключите плагин AppMetrica React Native
  2. Шаг 2. Инициализируйте библиотеку AppMetrica

Шаг 1. Подключите плагин AppMetrica React Native

  1. Установите плагин AppMetrica React Native в ваш проект с помощью менеджера пакетов npm:

    npm install react-native-appmetrica --save
    Скопировано
    Если вы используете yarn

    Установите плагин AppMetrica React Native в ваш проект с помощью менеджера пакетов yarn:

    yarn add react-native-appmetrica
    Скопировано
  2. Для React Native версии 0.59 и ниже, выполните следующую консольную команду для связывания AppMetrica с вашим проектом:

    react-native link react-native-appmetrica
    Скопировано
  3. Для проектов на платформе iOS:

    • Если в проекте есть файл ${PROJECT_DIR}/ios/Podfile, выполните следующую консольную команду:

      npx pod-install
      Скопировано
    • Если в проекте нет файла ${PROJECT_DIR}/ios/Podfile, подключите библиотеку вручную.

      Примечание. Фреймворк должен располагаться в папке ${PROJECT_DIR}/ios/Frameworks
      .
  4. Пересоберите ваше приложение:

    # Android:
    npx react-native run-android
    # iOS:
    npx react-native run-ios
    Скопировано

Шаг 2. Инициализируйте библиотеку AppMetrica

  1. Импортируйте библиотеку в исходном коде вашего проекта:

    import AppMetrica from 'react-native-appmetrica';
    Скопировано

    В этом случае используйте AppMetrica в коде проекта для работы с библиотекой.

  2. Инициализируйте библиотеку AppMetrica с помощью метода activate():

    AppMetrica.activate({
      apiKey: 'Your API key',
      sessionTimeout: 120,
      firstActivationAsUpdate: false
    });
    Скопировано
    Что такое API key?

    API key — это уникальный идентификатор приложения, который выдается в веб-интерфейсе AppMetrica при добавлении приложения.

    Убедитесь, что он указан верно.

  3. Отправьте событие, чтобы протестировать работу библиотеки:

    // Sends a custom event message and additional parameters (optional).
    AppMetrica.reportEvent('My event');
    AppMetrica.reportEvent('My event', { foo: 'bar' });
    
    // Send a custom error event.
    AppMetrica.reportError('My error')
    Скопировано

Пример проекта с интегрированной AppMetrica SDK на GitHub.

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