# Базовая установка Expo SDK
:::tip{title="Результат шага:"}
  * Из Mindbox отправляются мобильные push-уведомление на обе платформы и они отображается на устройстве.
  * На обеих платформах отображаются In-App
  * Проверить, что push-уведомления отправляются, можно с помощью [этой инструкции](https://developers.mindbox.ru/docs/mobile-push-check#%D0%BF%D1%80%D0%BE%D0%B2%D0%B5%D1%80%D0%B8%D1%82%D1%8C-%D1%87%D1%82%D0%BE-%D0%BC%D0%BE%D0%B1%D0%B8%D0%BB%D1%8C%D0%BD%D0%BE%D0%B5-push-%D1%83%D0%B2%D0%B5%D0%B4%D0%BE%D0%BC%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BE%D1%82%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D1%8F%D0%B5%D1%82%D1%81%D1%8F).  
  * Проверить, что In-App отображаются, можно с помощью [этой инструкции](https://help.mindbox.ru/docs/in-apps).
:::

## Требования

* Expo SDK 54+
* React Native 0.81.+
* Mindbox sdk не ниже версии 2.14.6
* [Точка интеграции настроена](https://developers.mindbox.ru/docs/add-integration-rn)

## Установка плагина

Добавьте зависимости в `package.json`:

```Text title="package.json"
 "mindbox-sdk": "^2.14.6",
 "mindbox-expo-plugin": "^1.0.4"
```

Затем выполните установку: `npm install`

:::warning
  Плагин `mindbox-expo-plugin` должен быть первым в списке плагинов.
:::

## Инициализация SDK

:::tip 
[Пример инициализации SDK](https://github.com/mindbox-cloud/expo-plugin/blob/master/examples/MindboxExpoExample/src/screens/HomeScreen.tsx#L69)
:::

### 1. Выбор варианта конфигурации SDK

Выберите вариант конфигурации SDK на основе требований от маркетинга.

import CalloutEndpoint from '/src/_CalloutEndpoint.mdx';

<CalloutEndpoint />

import Calloutdomainapimindbox from '/src/_Calloutdomainapimindbox.mdx';

<Calloutdomainapimindbox />

***

**1. Хочу передавать в Mindbox анонимных пользователей и отправлять им push-уведомления**

```typescript
const configuration = {
        domain: '<Domain API Mindbox>',
        endpointId:
          Platform.OS === 'ios'
            ? '<системное имя точки интеграции iOS>'
            : '<системное имя точки интеграции Android>',
        subscribeCustomerIfCreated: true,
        shouldCreateCustomer: true,
      };
```

**2. Хочу передавать в mindbox анонимных пользователей без возможности отправлять им push-уведомления**

```typescript
const configuration = {
        domain: '<Domain API Mindbox>',
        endpointId:
          Platform.OS === 'ios'
            ? '<системное имя точки интеграции iOS>'
            : '<системное имя точки интеграции Android>',
        subscribeCustomerIfCreated: false,
        shouldCreateCustomer: true,
      };
```

**3. Не хочу передавать в mindbox анонимных пользователей**

```kotlin
const configuration = {
        domain: '<Domain API Mindbox>',
        endpointId:
          Platform.OS === 'ios'
            ? '<системное имя точки интеграции iOS>'
            : '<системное имя точки интеграции Android>',
        subscribeCustomerIfCreated: false,
        shouldCreateCustomer: false,
      };
```

***

### 2. Настройка React Native-части проекта

Инициализировать SDK нужно синхронно в основном файле приложения **`App.tsx / App.js`**, используйте вариант конфигурации, выбранный в пункте выше

```javascript
import MindboxSdk from 'mindbox-sdk';
import React, {useCallback, useEffect, useState} from 'react';

const App = () => {
   const appInitializationCallback = useCallback(async () => {
     try {
       ВСТАВЬТЕ СЮДА ВЫБРАННУЮ НА ЭТАПЕ 1 КОНФИГУРАЦИЮ SDK
       await MindboxSdk.initialize(configuration);
     } catch (error) {
       console.log(error);
     }
   }, []);
   ....
   return ()
 }
```

:::danger
  Чтобы проверить корректность инициализации, добавьте вывод deviceUUID в консоль в любом удобном месте.
:::

<Accordion type="single" collapsible >
  <AccordionItem value="item-1">
    <AccordionTrigger className="flex flex-1 items-center justify-start gap-2 p-2 font-medium transition-all hover:underline [&[data-state=open]>svg]:rotate-180 text-left"><CircleAlertIcon color="#39AA5D" /> Как можно проверить?</AccordionTrigger>
    <AccordionContent>
      Советуем вывести deviceUUID  **сразу за вызовом** **`Mindbox.init`**.
      Далее запустите приложение через Android Studio на реальном устройстве или эмуляторе

      <br />

      ```javascript
      import MindboxSdk from 'mindbox-sdk';
      import React, {useCallback, useEffect, useState} from 'react';

      const App = () => {
        ...
        MindboxSdk.getDeviceUUID(console.log);
        return ();
      }
      ```
    </AccordionContent>
  </AccordionItem>
</Accordion>

## Конфигурация плагина


<Accordion type="single" collapsible >
  <AccordionItem value="item-1">
    <AccordionTrigger className="flex flex-1 items-center justify-start gap-2 p-2 font-medium transition-all hover:underline [&[data-state=open]>svg]:rotate-180 text-left"><CircleAlertIcon color="#39AA5D" />Все доступные параметры</AccordionTrigger>
    <AccordionContent>
      | **Название параметра** | **Возможные значения** | **Обязательность** | **Комментарий** |
      |---|---|---|---|
      | **`androidPushProviders`** | `Array`<br />Возможные значения:<br />`["firebase", "huawei", "rustore"]` | Нет | Перечисление используемых провайдеров мобильных пушей на Android |
      | **`googleServicesFilePath`** | `String`<br />Путь к файлу `google-services.json` | Нет | Необходим, если подключаем провайдера **Firebase** |
      | **`huaweiServicesFilePath`** | `String`<br />Путь к файлу `agcp-connect.json` | Нет | Необходим, если подключаем провайдера **Huawei** |
      | **`rustoreProjectId`** | `String`<br />ID проекта в RuStore | Нет | Необходим, если подключаем провайдера **RuStore** |
      | **`androidChannelId`** | `String`<br />ID канала уведомлений | Нет | Если не указывать, используется значение по умолчанию |
      | **`androidChannelName`** | `String`<br />Имя канала уведомлений | Нет | Если не указывать, используется значение по умолчанию |
      | **`androidChannelDescription`** | `String`<br />Описание канала уведомлений | Нет | Если не указывать, используется значение по умолчанию |
      | **`smallIcon`** | `String`<br />Путь к иконке для пушей в Android<br /><br />Поддерживаемые форматы: **XML** или **PNG** | Нет | Если не указывать, используется значение по умолчанию |
      | **`smallIconAccentColor`** | `String`<br />Цвет иконки | Нет | Чтобы поменять цвет монохромной иконки, задайте цвет в ресурсе `mindbox_default_notification_color` в файле `res/values/colors.xml`.<br /><br />⚠️ Изменение цвета может не работать на некоторых версиях Android в зависимости от изготовителя устройства |
      | **`iosMode`** | `String`<br />Окружение iOS<br /><br />Возможные значения:<br />`"development"` или `"production"` | Нет | По умолчанию `"development"` |
      | **`iosDevTeam`** | `String`<br />ID команды разработчика | Нет | Необходимо указывать, если в `app.json` проекта не задан параметр `"appleTeamId"` |
      | **`iosNseFilePath`** | `String`<br />Путь к файлу NSE | Нет | Используется при кастомной реализации **Notification Service Extension** |
      | **`iosNceFilePath`** | `String`<br />Путь к файлу NCE | Нет | Используется при кастомной реализации **Notification Content Extension** |
      | **`usedExpoNotification`** | `Boolean` | Нет | Используется при параллельной работе пушей Mindbox и Expo |

    </AccordionContent>
  </AccordionItem>
</Accordion>

### Android

1. Получите ключи провайдеров для отправки push-уведомлений.

<div className="text-sm w-full grid gap-4 grid-cols-1 sm:grid-cols-2 lg:grid-cols-4">
<Card>
  <a href="https://developers.mindbox.ru/docs/firebase-key-setup" target="_blank" rel="noreferrer">
    <CardHeader class="p-4 pb-2">
      <CardTitle>Firebase</CardTitle>
    </CardHeader>
  </a>
    <CardContent class="p-4 pt-0 text-sm leading-snug">
    Получение ключей Firebase.
    </CardContent>
  </Card>
<Card>
  <a href="https://developers.mindbox.ru/docs/huawei-get-keys" target="_blank" rel="noreferrer">
    <CardHeader class="p-4 pb-2">
      <CardTitle>Huawei</CardTitle>
    </CardHeader>
  </a>
    <CardContent class="p-4 pt-0 text-sm leading-snug">
    Получение ключей Huawei.
    </CardContent>
</Card>
<Card>
  <a href="https://developers.mindbox.ru/docs/rustore-get-keys" target="_blank" rel="noreferrer">
    <CardHeader class="p-4 pb-2">
      <CardTitle>RuStore</CardTitle>
    </CardHeader>
  </a>
    <CardContent class="p-4 pt-0 text-sm leading-snug">
    Получение ключей RuStore.
    </CardContent>
</Card>
</div>

1. Подключите  и настройте плагин `mindbox-expo` в `app.json`.

**Пример конфигурации:**

```javascript
"plugins": [
      [
        "mindbox-expo-plugin",
        {
          "androidPushProviders": [
            "firebase",
            "huawei",
            "rustore"
          ],
          "googleServicesFilePath": "./credentials/google-services.json",
          "huaweiServicesFilePath": "./credentials/agconnect-services.json",
          "rustoreProjectId": "hWZJga09nar5gsh0lbKlkZDuCgDJswgN",
          "androidChannelId": "expo_channel_id",
          "androidChannelName": "expo_name",
          "androidChannelDescription": "expo_description",
          "smallIcon": "./assets/icon_mb.png",
          "smallIconAccentColor": "#80F00A0A",
        }
      ]
    ]
```

### iOS

1. [Настройте Sandbox-окружение](https://developers.mindbox.ru/docs/sandbox-integration-setup).
2. Получите ключи и настройте подключение к APNs по [инструкции](https://developers.mindbox.ru/docs/apns-keys-setup).
3. Убедитесь, что в `app.json`  в разделе `ios` указаны параметры
   `bundleIdentifier` и `appleTeamId`.
4. Если appleTeamId не указан и нет возможности его указать, то в  `mindbox-expo-plugin` необходимо добавить `iosDevTeam`  и в значении передать идентификатор команды
5. В `mindbox-expo-plugin` укажите `iosMode`.

Возможны 2 значения:

* `"development"` (по умолчанию)
* `"production"`

:::info
  Если вы используете Expo Notification для отправки и отображения push-уведомлений, [выполните дополнительные настройки](https://developers.mindbox.ru/docs/expo-notification).
:::

### Запросите разрешения на уведомления  и передайте сведения о статусе в Mindbox

Это можно сделать как на стороне Android/iOS, так и в ReactNative

Пример запроса разрешения на уведомления c использованием `Expo Notification`

```typescript
import * as Notifications from 'expo-notifications';

.....

const { status: existingStatus } = await Notifications.getPermissionsAsync();
const finalStatus = existingStatus === 'granted' 
  ? existingStatus 
  : (await Notifications.requestPermissionsAsync()).status;

finalStatus === 'granted' && MindboxSdk.refreshNotificationPermissionStatus();
```
