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

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

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

Чтобы использовать плагин с Expo, нужно выполнить инструкции для библиотек, работающих с нативной частью, так как плагин обращается к нативным Android/iOS библиотекам.

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

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

React Native CLI

Expo

Установите плагин AppMetrica React Native в ваш проект:

yarn

npm

yarn 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.

Узнайте больше

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

Написать в службу поддержки

Была ли статья полезна?

AppMetrica React Native Plugin. Миграция на версию 3.0.0

Справочник методов