# Керівництво з підключення ADB

Цей посібник містить детальні інструкції щодо підключення до хмарних телефонних пристроїв через ADB, які підтримують версії **Android 12/15** і **Android 13/14**.

## 1. Підключення ADB для хмарних телефонів Android 12 / Android 15

### Крок 1: підключіться до IP-адреси та порту Cloud Phone

Використовуйте команду `adb connect` для прямого підключення до IP-адреси та порту хмарного телефону.

```bash
adb connect 172.168.10.1:123456
```

> Замініть `172.168.10.1:123456` фактичною IP-адресою та портом хмарного телефону.


### Крок 2: автентифікація за допомогою коду підключення

Після успішного підключення пройдіть автентифікацію за допомогою коду підключення.

```bash
adb shell 123456
```

Після успішної автентифікації ви за замовчуванням увійдете до хмарного телефону, і ви зможете використати «вихід», щоб вийти

```bash
exit
```

Або вкажіть адресу пристрою:

```bash
adb -s 172.168.10.1:123456 shell 123456
```

> Примітка. Код підключення зазвичай надається платформою хмарного телефону. Переконайтеся, що його введено правильно.


## 2. Підключення ADB для хмарних телефонів Android 13 / Android 14 / Android 15A / Android 16

Для цих версій потрібно встановити SSH-тунель для перенаправлення порту ADB. Для цього потрібні два кроки.

### Крок 1. Встановіть тунель SSH (відкрийте перше вікно CMD)

Виконайте таку команду SSH, щоб відобразити віддалений порт ADB на вашій локальній машині:

```bash
ssh -oHostKeyAlgorithms=+ssh-rsa 10.2.179.250_1763627294587@107.151.131.2 -p 1824 -L 9897:adb-proxy:14566 -Nf
```

> Примітки:
- Замініть ім'я користувача, IP-адресу та порт у команді вашою фактичною конфігурацією.
- Коли буде запропоновано ввести пароль, вставте пароль SSH і натисніть Enter.
- Команда не виведе жодних результатів у разі успіху, що вказує на те, що тунель працює у фоновому режимі.



### Крок 2: підключіться до локального порту ADB (відкрийте друге вікно CMD)

У новому вікні виконайте команду підключення ADB:

```bash
adb connect localhost:9897
```

Приклад успішного результату:

```
connected to localhost:9897
```

## Повний приклад робочого процесу

### 1. Перше вікно CMD (тунель SSH):

```bash
ssh -oHostKeyAlgorithms=+ssh-rsa 10.2.179.250_1763627294587@107.151.131.2 -p 1824 -L 9897:adb-proxy:14566 -Nf
```

Далі введіть пароль підключення SSH

### 2. Друге вікно CMD (підключення ADB):

```bash
adb connect localhost:9897
```

## Перевірте статус підключення

Виконайте таку команду, щоб перевірити, чи підключено пристрій:

```bash
adb devices
```

Очікуваний результат:

```
List of devices attached
localhost:9897     Device
```

## Довідник із загальних команд ADB

| Команда | опис |
|  --- | --- |
| `adb devices` | Список підключених пристроїв |
| `adb shell` | Введіть термінал оболонки пристрою |
| `adb shell pm list packages` | Список встановлених програм |
| `adb install app.apk` | Встановити файл APK |
| `adb uninstall package.name` | Видаліть програму |
| `adb reboot` | Перезавантажте пристрій |


## Важливі зауваження

- Переконайтеся, що ви встановили [Android SDK Platform Tools](https://developer.android.com/studio/releases/platform-tools) і налаштували змінні середовища.
- Метод SSH-тунелю для Android 13/14/15A зашифрований і безпечний — рекомендовано для використання.
- Якщо підключення закінчилося, перевірте налаштування мережі, правила брандмауера та конфігурації портів.
- Перед підключенням завжди перевіряйте, що хмарний телефон увімкнено та доступ до ADB увімкнено.


Виконайте ці кроки, щоб успішно підключити свій хмарний телефон для завдань налагодження та автоматизації ADB.