# Mindbox SDK

Это бесплатная библиотека для всех клиентов Mindbox. Код SDK размещен в открытых репозиториях.

## Возможности Mindbox SDK

| Поддерживается в SDK | Не поддерживается в SDK |
| -------- | -------- |
| <ul><li> Интеграция мобильных push-уведомлений: мониторинг токенов и разрешения, отрисовка push-уведомлений.</li><li> Передача событий в API Mindbox.</li><li> Получение данных от API Mindbox.</li><li> [In-app в приложениях.](https://developers.mindbox.ru/docs/in-app)</li></ul> | <ul><li> Интеграция программы лояльности.</li><li> Отображение виджетов продуктовых рекомендаций.</li></ul>|


:::tip

Мы оказываем техническую поддержку для двух последних минорных версий SDK — на данный момент: 2.15.x и 2.16.x.

:::

## Поддерживаемые платформы

<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/android-sdk" target="_blank" rel="noreferrer">
    <CardHeader class="p-4 pb-2">
      <CardTitle>Android</CardTitle>
    </CardHeader>
  </a>
    <CardContent class="p-4 pt-0 text-sm leading-snug">
      <p>
      **Языки:** Java / Kotlin <br />
      **Android API:** 21+ <br />
      **Устройства:** смартфоны Android любых версий<br />
      </p>
      <p>
      📚 <a href="https://developers.mindbox.ru/docs/android-sdk" target="_blank">Документация</a> <br />
      📦 <a href="https://github.com/mindbox-cloud/android-sdk/tree/develop/example" target="_blank">Пример</a> <br />
      💻 <a href="https://github.com/mindbox-cloud/android-sdk" target="_blank">GitHub</a> <br />
      📦 <a href="https://central.sonatype.com/artifact/cloud.mindbox/mobile-sdk" target="_blank">Maven Central</a> <br />
      </p>
    </CardContent>
  </Card>
<Card>
  <a href="https://developers.mindbox.ru/docs/ios-sdk" target="_blank" rel="noreferrer">
    <CardHeader class="p-4 pb-2">
      <CardTitle>iOS</CardTitle>
    </CardHeader>
  </a>
    <CardContent class="p-4 pt-0 text-sm leading-snug">
      <p>      
      **Языки:** Swift <br />
      **iOS:** 12+ <br />
      **Устройства:** смартфоны iPhone любых версий <br />
      </p>      
      <p>      
      📚 <a href="https://developers.mindbox.ru/docs/ios-sdk" target="_blank">Документация</a> <br />
      📦 <a href="https://github.com/mindbox-cloud/ios-sdk/tree/develop/Example" target="_blank">Пример</a> <br />
      💻 <a href="https://github.com/mindbox-cloud/ios-sdk" target="_blank">GitHub</a> <br />
      📦 <a href="https://swiftpackageindex.com/mindbox-cloud/ios-sdk" target="_blank">SPM</a> <br />
      📦 <a href="https://cocoapods.org/pods/Mindbox" target="_blank">CocoaPods</a>
      </p>
    </CardContent>
</Card>
<Card>
  <a href="https://developers.mindbox.ru/docs/flutter-sdk-integration" target="_blank" rel="noreferrer">
    <CardHeader class="p-4 pb-2">
      <CardTitle>Flutter</CardTitle>
    </CardHeader>
  </a>
    <CardContent class="p-4 pt-0 text-sm leading-snug">
      <p>
      **Flutter:** 2+ <br />
      **Языки:** Dart <br />
      </p>  
      <p>
      📚 <a href="https://developers.mindbox.ru/docs/flutter-sdk-integration" target="_blank">Документация</a> <br />
      📦 <a href="https://github.com/mindbox-cloud/flutter-sdk/tree/develop/example/flutter_example" target="_blank">Пример</a> <br />
      💻 <a href="https://github.com/mindbox-cloud/flutter-sdk" target="_blank">GitHub</a> <br />
      📦 <a href="https://pub.dev/packages/mindbox" target="_blank">pub.dev</a>
      </p>  
    </CardContent>
</Card>
<Card>
  <a href="https://developers.mindbox.ru/docs/react-native-sdk" target="_blank" rel="noreferrer">
    <CardHeader class="p-4 pb-2">
      <CardTitle>React Native</CardTitle>
    </CardHeader>
  </a>
  <CardContent class="p-4 pt-0 text-sm leading-snug">
    <p>
    **React Native:** 0.60+ <br />
    **Языки:** JavaScript / TypeScript <br />
    </p> 
    <p>
    📚 <a href="https://developers.mindbox.ru/docs/react-native-sdk-integration" target="_blank">Документация</a> <br />
    📦 <a href="https://github.com/mindbox-cloud/react-native-sdk/tree/develop/example/exampleApp" target="_blank">Пример</a> <br />
    💻 <a href="https://github.com/mindbox-cloud/react-native-sdk" target="_blank">GitHub</a> <br />
    📦 <a href="https://www.npmjs.com/package/mindbox-sdk" target="_blank">npm</a>
    </p> 
  </CardContent>
</Card>
<Card>
  <a href="https://developers.mindbox.ru/docs/expo-sdk" target="_blank" rel="noreferrer">
    <CardHeader class="p-4 pb-2">
      <CardTitle>Expo</CardTitle>
    </CardHeader>
  </a>
  <CardContent class="p-4 pt-0 text-sm leading-snug">
    <p>
    **React Native:** 0.81+ <br />
    **Языки:** JavaScript / TypeScript <br />
    </p> 
    <p>
    📚 <a href="https://developers.mindbox.ru/docs/expo-sdk" target="_blank">Документация</a> <br />
    📦 <a href="https://github.com/mindbox-cloud/react-native-sdk/tree/develop/example/exampleApp" target="_blank">Пример</a> <br />
    💻 <a href="https://github.com/mindbox-cloud/expo-plugin/tree/develop/examples/MindboxExpoExample" target="_blank">GitHub</a> <br />
    📦 <a href="https://www.npmjs.com/package/mindbox-expo-plugin" target="_blank">npm</a>
    </p> 
  </CardContent>
</Card>
</div>

***

## Не поддерживается

Не поддерживаем приложения, созданные:

* на кроссплатформенных технологиях (Xamarin, Native Script).
* на Cordova.
* на Unity.
* как WebView (PWA) приложения без нативной обертки (на Kotlin или Swift), которые нельзя загрузить в маркетплейс приложений (Google Play, App Store, App Gallery, RuStore и другие)*.

Если ваше приложение создано на одной из этих технологий, то обратитесь к консультанту по внедрению или менеджеру проекта.

:::note{title="🤔 *Если вы не уверены, поддерживаем ли мы ваше WebView-приложение"}

  попробуйте добавить SDK по инструкции:

  * [для Android](https://developers.mindbox.ru/docs/android-sdk)
  * [для iOS](https://developers.mindbox.ru/docs/ios-sdk)
  * [для Flutter](https://developers.mindbox.ru/docs/flutter-sdk-integration)
  * [для React Native](https://developers.mindbox.ru/docs/react-native-sdk-integration)

  Если получится, то поддерживаем. Интегрируйте SDK по стандартной инструкции и не забудьте выполнить шаги по синхронизации deviceUUID между mobile SDK и JS SDK в приложении с WebView:

  * [для Android](https://developers.mindbox.ru/docs/c%D0%B8%D0%BD%D1%85%D1%80%D0%BE%D0%BD%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F-deviceuuid-%D0%BC%D0%B5%D0%B6%D0%B4%D1%83-mobile-sdk-%D0%B8-js-sdk-%D0%B2-%D0%BF%D1%80%D0%B8%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%B8%D0%B8-%D1%81-webview)
  * [для iOS](https://developers.mindbox.ru/docs/web-view-sync-with-sdk)
  * [для Flutter](https://developers.mindbox.ru/docs/c%D0%B8%D0%BD%D1%85%D1%80%D0%BE%D0%BD%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F-deviceuuid-%D0%BC%D0%B5%D0%B6%D0%B4%D1%83-mobile-sdk-%D0%B8-js-sdk-%D0%B2-%D0%BF%D1%80%D0%B8%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%B8%D0%B8-%D1%81-webview-1)
  * [для React Native](https://developers.mindbox.ru/docs/c%D0%B8%D0%BD%D1%85%D1%80%D0%BE%D0%BD%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F-deviceuuid-%D0%BC%D0%B5%D0%B6%D0%B4%D1%83-mobile-sdk-%D0%B8-js-sdk-%D0%B2-%D0%BF%D1%80%D0%B8%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%B8%D0%B8-%D1%81-webview-2)
:::