Подключение и инициализация
AppMetrica React Native — это плагин для платформы React Native. Он включает поддержку AppMetrica SDK для Android и iOS.
Минимальная поддерживаемая версия React Native — 0.59.
Ниже описаны этапы подключения и инициализации AppMetrica React Native:
Шаг 1. Подключите плагин AppMetrica React Native
Установите плагин AppMetrica React Native в ваш проект с помощью менеджера пакетов
npm
:npm install react-native-appmetrica --save
СкопированоЕсли вы используете yarnУстановите плагин AppMetrica React Native в ваш проект с помощью менеджера пакетов
yarn
:yarn add react-native-appmetrica
СкопированоДля React Native версии 0.59 и ниже, выполните следующую консольную команду для связывания AppMetrica с вашим проектом:
react-native link react-native-appmetrica
СкопированоДля проектов на платформе iOS:
Если в проекте есть файл ${PROJECT_DIR}/ios/Podfile, выполните следующую консольную команду:
npx pod-install
СкопированоЕсли в проекте нет файла ${PROJECT_DIR}/ios/Podfile, подключите библиотеку вручную.
Примечание. Фреймворк должен располагаться в папке ${PROJECT_DIR}/ios/Frameworks.
Пересоберите ваше приложение:
# Android: npx react-native run-android # iOS: npx react-native run-ios
Скопировано
Шаг 2. Инициализируйте библиотеку AppMetrica
Импортируйте библиотеку в исходном коде вашего проекта:
import AppMetrica from 'react-native-appmetrica';
СкопированоВ этом случае используйте
AppMetrica
в коде проекта для работы с библиотекой.Инициализируйте библиотеку AppMetrica с помощью метода
activate()
:AppMetrica.activate({ apiKey: 'Your API key', sessionTimeout: 120, firstActivationAsUpdate: false });
СкопированоЧто такое API key?API key — это уникальный идентификатор приложения, который выдается в веб-интерфейсе AppMetrica при добавлении приложения.
Убедитесь, что он указан верно.
Отправьте событие, чтобы протестировать работу библиотеки:
// 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.