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