# 2. Инициализация SDK
:::warning{title=" Убедитесь, что эти шаги выполнены успешно:"}

 * [Настройка точек интеграции для Android приложения](https://developers.mindbox.ru/docs/add-android-integration)
 * [Добавление SDK в приложение](https://developers.mindbox.ru/docs/add-android-sdk)

:::

:::tip{title="Результат шага «Инициализация SDK»:"} 

 * Приложение запустилось без ошибок;
 * В консоли разработчика в Android Studio выведен **deviceUUID** SDK mindbox;
 * Дополнительно, только если вы делаете интеграцию с созданием и подпиской анонимного пользователя в системе Mindbox — [создастся клиент Mindbox](https://developers.mindbox.ru/docs/sdk-subscribe-customer).
:::

 :::info 
 [Пример инициализации SDK](https://github.com/mindbox-cloud/android-sdk/blob/develop/example/app/src/main/java/com/mindbox/example/ExampleApplication.kt#L39)
 :::

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

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

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

<CalloutEndpoint />

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

<Calloutdomainapimindbox />

:::danger 
Не передавайте в этом поле адрес административного раздела
:::

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

```kotlin title="Kotlin"
val configuration = MindboxConfiguration.Builder(
	applicationContext,
	"<Domain API Mindbox>",
	"<системное имя точки интеграции>" )
	.shouldCreateCustomer(true)
	.subscribeCustomerIfCreated(true)
	.build()
```

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

```kotlin title="Kotlin"
val configuration = MindboxConfiguration.Builder(
	applicationContext,
	"<Domain API Mindbox>",
	"<системное имя точки интеграции>" )
	.shouldCreateCustomer(true)
	.subscribeCustomerIfCreated(false)
	.build()
```

### Не хочу передавать в Mindbox анонимных пользователей

```kotlin title="Kotlin"
val configuration = MindboxConfiguration.Builder(
	applicationContext,
	"<Domain API Mindbox>",
	"<системное имя точки интеграции>" )
	.shouldCreateCustomer(false)
	.build()
```

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

:::info
  Для корректной работы SDK не должна быть глобально отключена автоматическая инициализация компонентов. Обратите внимание, нет ли у вас в манифесте следующей записи:  
  [Disable automatic initialization for all components](https://developer.android.com/topic/libraries/app-startup#disable-all)
  Если у вас она отключена для всех компонентов, включите ее и отключите автоматическую инициализацию только для [отдельных компонентов](https://developer.android.com/topic/libraries/app-startup#disable-individua)
:::

:::danger
  Асинхронная инициализация SDK может привести к некорректной работе.
:::

Инициализировать SDK нужно синхронно в методе Application.onCreate, **используйте вариант конфигурации, выбранный на этапе «Выбор варианта конфигурации SDK»**.

Для инициализации передайте в метод `Mindbox.init` `application`  вашего приложения.

```kotlin title="Kotlin"
import android.app.Application
import cloud.mindbox.mobile_sdk.*

class MyApp: Application() {
    override fun onCreate() {
        super.onCreate()
        // ВСТАВЬТЕ СЮДА ВЫБРАННУЮ НА ЭТАПЕ 1 КОНФИГУРАЦИЮ SDK                    
        Mindbox.init(application, configuration, listOf())

    }
}
```

### Если у вас single activity application и вы не можете инициализировать SDK в Application

Тогда можно инициализировать Mindbox SDK в вашей Activity, передав в `Mindbox.init` вашу Activity.

```kotlin title="Kotlin"
 class MainActivity() : Activity() {
        override fun onCreate() {
            super.onCreate()
            // ВСТАВЬТЕ СЮДА ВЫБРАННУЮ НА ЭТАПЕ 1 КОНФИГУРАЦИЮ SDK  
            Mindbox.init(this@MainActivity, configuration, listOf())
        }
    }
```

### Если вы ранее уже инициализировали SDK

Вам нужно заменить устаревшую реализацию метода инициализации Mindbox.init(context, configuration, list), требующую передачу контекста, на одну из новых: требующую application, при инициализации внутри класса Application и требующую activity, при инициализации внутри класса Activity.

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

Далее запустите приложение через Android Studio на реальном устройстве или эмулятор

```kotlin title="Kotlin"
package cloud.mindbox.checkguidandroid

import android.app.Application
import android.util.Log
import cloud.mindbox.mobile_sdk.*

class MyApp: Application() {
    override fun onCreate() {
        super.onCreate()

				...
        Mindbox.init(
           application = this,
           configuration = configuration,
           pushServices = listOf(MindboxFirebase, MindboxHuawei, MindboxRuStore)
        )
        Mindbox.subscribeDeviceUuid { uuid -> Log.i("MindboxDeviceUUID", uuid) }
    }
}
```

### Если вам нужно изменить endpoint

Если ваше приложение используется в нескольких странах, а точное местоположение клиента становится известно только после запуска приложения, может потребоваться смена endpoint для корректной передачи информации о стране. Для этого нужно повторно вызвать `Mindbox.init` и указать в конфигурации новый `endpoint`.

### Использование SDK при собственной инициализации WorkManager

[Документация](https://developer.android.com/topic/libraries/architecture/workmanager/advanced/custom-configuration)  
Внутри Mindbox SDK для отправки ивентов используется WorkManager. Если в вашем проекте отключена автоматическая инициализация WorkManager и инициализируете его вручную, то добавьте:

```kotlin title="Kotlin"
Configuration.Builder().setWorkerFactory(
  DelegatingWorkerFactory().apply {
    // ваши фабрики
     addFactory(Mindbox.mindboxWorkerFactory)
  }
)
```
