# Установка и настройка киоск-приложения через USB и ADB

**Что понадобится**

- 💻 Компьютер с <span class="s1">**Windows или Mac**</span>
- 🔌 USB-кабель
- <span class="s1">📱 Android-планшет (желательно </span>**новый или сброшенный до заводских настроек**<span class="s1">)</span>
- 📦 Файл <span class="s1">.apk</span>,
- 🔢 ID приложения вида ru.site.app **(обязательно в командах ниже замените на свой, в примере будет использован ru.site.app)**

### 1. Подготовка планшета

**Если устройство не сброшено — сделайте сброс:**

> ⚠️ <span class="s1">**Важно:**</span> установить приложение в киоск-режиме можно <span class="s1">**только на “чистое” устройство**</span>.

**Как сбросить:**

1. <span class="s1">Откройте </span>**Настройки → Система → Сброс / Восстановление → Сброс до заводских настроек**
2. Подтвердите сброс. Планшет перезагрузится.

### 2. Включите «режим разработчика» и отладку по USB

1. <span class="s1">Откройте </span>**Настройки → О телефоне / Об устройстве**
2. Найдите пункт <span class="s1">**Номер сборки**</span> (Build number)
3. Нажмите по нему <span class="s1">**7 раз**</span>, пока не появится сообщение: *«Вы стали разработчиком»*
4. <span class="s1">Назад → Зайдите в </span>**Система → Для разработчиков (Developer options)**
5. <span class="s1">Включите </span>**Отладку по USB (USB Debugging)**

### 3. Установите ADB (на компьютере) 

#### ▶️ Вариант A: Для Windows 

1. <span class="s1">Скачайте </span>**ADB Platform Tools**<span class="s1">:</span>
    
    
    - [https://developer.android.com/tools/releases/platform-tools](https://developer.android.com/tools/releases/platform-tools)
2. Распакуйте архив в удобную папку, например: <span class="s1">C:\\adb</span>

#### ▶️ Вариант B: Для macOS 

1. <span class="s1">Откройте </span>**Терминал**
2. Установите ADB через <span class="s1">Homebrew</span> (если он установлен):

```
brew install android-platform-tools
```

Или скачайте вручную:

[https://developer.android.com/tools/releases/platform-tools](https://developer.android.com/tools/releases/platform-tools)

### 4. Подключите планшет к компьютеру через USB

- Разрешите отладку по USB на планшете, если появится запрос.

### 5. Установите приложение 

Перетащите <span class="s2">.apk</span> в папку с ADB. Например <span class="s1">C:\\adb</span>

**<span class="s1">Затем в консоле:</span>**

▶️ Windows:

```
cd C:\adb
adb install -r app-release.apk
```

▶️ Mac:

```
cd ~/Downloads/platform-tools
./adb install -r app-release.apk
```

✅ Должно появиться: <span class="s1">Success</span>

### 6. Назначьте приложение как Device Owner (админ устройства)

⚠️ Делается <span class="s3">**один раз**</span>, и только на сброшенном устройстве.

```
adb shell dpm set-device-owner ru.site.app/.MyDeviceAdminReceiver
```

<p class="callout danger">**<span class="s1">ru.site.app замените на ваш ID приложения!</span>**</p>

<span class="s1">✅ Если всё ок, появится сообщение: </span>Success: Device owner set to package ru.lolapizza.kso

### 7. Перезагрузите планшет 

```
adb reboot
```

После включения:

- <span class="s1">Приложение </span>**автоматически запустится**
- Нельзя выйти из него
- Все кнопки и меню будут заблокированы
- <span class="s1">Работает </span>**Kiosk Mode**

✅ ГОТОВО!

### Как выйти из режима киоска (для администратора)

Только при необходимости, с компьютера:

```
adb shell am stop-user 0
adb shell dpm remove-active-admin ru.site.app/.MyDeviceAdminReceiver
```

<p class="callout danger">**<span class="s1">ru.site.app замените на ваш ID приложения!</span>**</p>

После этого можно удалить приложение вручную.

### Как обновить приложение

Если планшет подключён к компьютеру, и у вас есть <span class="s2">.apk</span> новой версии:

1. Подключите планшет к компьютеру по USB
2. Убедитесь, что включена отладка по USB
3. Поместите <span class="s1">app-release.apk</span> в ту же папку, где <span class="s1">adb.exe</span>
4. Откройте терминал / командную строку
5. Выполните:

```
adb install -r app-release.apk
```