# Описание и установка

BotProtection Android SDK необходим для сбора данных с устройства и передачи их на сервер.

Для реализации предоставлен файл AAR для Android, который содержит SDK для сбора данных о поведении пользователей с датчиков устройства.

## Интеграция с Android Studio ‌

Пример встраивания библиотеки в IDE «Android Studio»: ‌

* Скачайте AAR-файл.
* Перейдите в `File > Project Structure`.

![](https://2016950825-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LzhcmsYyBEgOJsVFREq%2F-LzlPPNvC6ARBqjmNSuk%2F-LzlPyfWcRlDNQ8pFuTq%2Fimage.png?alt=media\&token=1b69a7e0-561a-430e-8970-c28e8d69d983)

* Выберите `Modules`, затем нажмите `+` над названием вашего приложения.

![](https://2016950825-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LzhcmsYyBEgOJsVFREq%2F-LzlPPNvC6ARBqjmNSuk%2F-LzlQ-Q_ws_JWUc108_9%2Fimage.png?alt=media\&token=4934a18a-ef08-4c2f-ad95-37f69ccf9ca6)

* Выберите `Import .JAR/.AAR Package`.

![](https://2016950825-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LzhcmsYyBEgOJsVFREq%2F-LzlPPNvC6ARBqjmNSuk%2F-LzlQ2ASpFf4ea0tHGNz%2Fimage.png?alt=media\&token=7494286e-a132-4157-847c-0d91124e885c)

* Путь к библиотеке AAR должен быть добавлен в поле `File name`.

![](https://2016950825-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LzhcmsYyBEgOJsVFREq%2F-LzlPPNvC6ARBqjmNSuk%2F-LzlQ4mJUW-Y6xYK4CqT%2Fimage.png?alt=media\&token=85d5467f-8425-46c7-b81c-e48280c2f966)

* Кликните `Finish`.
* В `Project Structure` кликните `Apply` и подождите синхронизацию. Затем вы увидите `botprotection` в ваших модулях:

![](https://2016950825-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LzhcmsYyBEgOJsVFREq%2F-LzlPPNvC6ARBqjmNSuk%2F-LzlQ6qqMf3EFxbzs8PG%2Fimage.png?alt=media\&token=d5b5bdbe-d7fb-4b0c-8151-ac525ada98ac)

* Идите в `Dependencies` и нажмите `+` под `Declared Dependencies`.

![](https://2016950825-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LzhcmsYyBEgOJsVFREq%2F-LzlPPNvC6ARBqjmNSuk%2F-LzlQ8h0DpdbDk8K9ixf%2Fimage.png?alt=media\&token=adfa0efc-c3c5-495f-9c6a-01305b365e3a)

* Выберите `Module Dependencies`.

![](https://2016950825-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LzhcmsYyBEgOJsVFREq%2F-LzlPPNvC6ARBqjmNSuk%2F-LzlQB0o8TwVksPHbZZ6%2Fimage.png?alt=media\&token=f59c2fea-85e8-4514-ac9f-4b18f1410e99)

* Нажмите на чекбокс botprotection и нажмите `OK`.

![](https://2016950825-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LzhcmsYyBEgOJsVFREq%2F-LzlPPNvC6ARBqjmNSuk%2F-LzlQDXr00Ij5U0omg5R%2Fimage.png?alt=media\&token=12649ddf-e0e5-4b2c-9ec3-f9b69eda1b2d)

* В `Project Structure` кликните `Apply` и подождите синхронизацию.
* Проверьте, что библиотека BotProtection была добавлена в `build.gradle`.

![](https://2016950825-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LzhcmsYyBEgOJsVFREq%2F-LzlPPNvC6ARBqjmNSuk%2F-LzlQFGVXYxRFjTmGipa%2Fimage.png?alt=media\&token=297558a3-9065-49ca-85cf-5d1c1c230ff5)

## Альтернативная интеграция

Однако, если используется KTS или не поддерживается работа с модулями, можно добавить SDL самостоятельно через build.gradle (после добавления файла AAR в каталог "libs"):

```java
implementation files('libs/BotProtection <VERSION> .aar')
```

## BotProtection API\_KEY

> Получить API\_KEY можно в Dashboard в "Install SDK"

Затем необходимо вставить полученный API\_KEY в AndroidManifest.xml:

```markup
 <application>
 //...
 
 <meta-data android:name="com.botProtection.ApiKey" 
            android:value="<api_key>" />
 
 //...
 </application>
```