# Посібник із підключення Appium

Appium Inspector у macOS і Windows працює з хмарними телефонами MoreLogin, які підтримують ADB і відповідають вимогам драйвера UiAutomator2. Повне підключення перевірено на Android 15 у Windows та Android 15A у macOS. Запускайте ADB, Appium Server та Inspector на одному комп’ютері.

## Отримайте параметри ADB

У MoreLogin Desktop відкрийте **Профілі → Хмарний телефон** і запустіть пристрій. У меню рядка **⋯** виберіть **Увімкнути ADB**. Якщо стовпець ADB не видно, прокрутіть таблицю горизонтально й наведіть курсор на стан **Увімкнено**.

![Меню ввімкнення ADB](/assets/ml-enable.f15fca406b0642892c6d64f82f8293ff2ea998b2247fd5f57ae4c359796fc524.f59a5fd3.png)

Адреса та код підключення вказують на пряме підключення, як на Android 15. Команда й пароль SSH вказують на підключення через тунель, як на Android 15A. Використовуйте актуальні дані з підказки.

![Дані прямого ADB із прихованими значеннями](/assets/ml-popup15.59c6a444c67e1d0293f95d90a2b9076847bc6d300dd700dba298dba5ccc639df.f59a5fd3.png)

![Дані SSH із прихованими значеннями](/assets/ml-popup15a.d5026fe728e2d59573d8d7fe1a88187425b447cf3ff9047fbf2b85311195f787.f59a5fd3.png)

## Налаштуйте Android SDK, Java та Node.js

У SDK Manager в Android Studio встановіть SDK Platform для потрібної версії Android і **Android SDK Platform-Tools**. Встановіть JDK 17 та Node.js 24 LTS із npm 10 або новішою версією. У macOS підставте свої шляхи. У Windows задайте змінні користувача або виконайте команди нижче в тому самому PowerShell, з якого запускаєте Appium.

### macOS

```bash
export ANDROID_HOME="$HOME/Library/Android/sdk"
export JAVA_HOME="$(/usr/libexec/java_home -v 17)"
export PATH="$ANDROID_HOME/platform-tools:$JAVA_HOME/bin:$PATH"
```

### Windows PowerShell

```powershell
$env:ANDROID_HOME = 'C:\Android\Sdk'
$env:JAVA_HOME = 'C:\Program Files\Java\jdk-17'
$env:Path = "$env:JAVA_HOME\bin;$env:ANDROID_HOME\platform-tools;$env:Path"
java -version
adb version
```

Якщо `adb version` працює, але Doctor не знаходить SDK, у Windows перевірте `(Get-Command adb).Source`. Коренева тека SDK містить `platform-tools`. Розмістіть теку `bin` JDK 17 перед старою версією Java у Path. Після зміни змінних користувача відкрийте PowerShell знову.

## Підключіть ADB

Для прямого підключення замініть `DEVICE_ADDRESS` та `CONNECTION_CODE` даними з MoreLogin. Зберігайте регістр коду. Стан `device` підтверджує з’єднання ADB. Якщо з’явиться `Access denied! Invalid password.`, виконайте автентифікацію з актуальним кодом. У разі успіху може з’явитися `OK! Login successful.`. Якщо відкрилася оболонка пристрою, поверніться командою `exit`.

```text
adb connect DEVICE_ADDRESS
adb -s DEVICE_ADDRESS shell CONNECTION_CODE
```

Для підключення через SSH перевірте `ssh -V`. За потреби встановіть **Клієнт OpenSSH** у додаткових компонентах Windows. Виконайте повну команду SSH та введіть пароль із MoreLogin. Якщо клієнт у Windows не приймає `-Nf`, замініть його на `-N` і залиште термінал відкритим. В іншому вікні підключіться до адреси з MoreLogin. Порт 9897 наведено як приклад.

```text
adb connect localhost:9897
```

Запустіть `adb devices -l) і переконайтеся, що потрібний рядок містить `device`. Підставте точне значення першого стовпця в `adb -s DEVICE_IDENTIFIER shell getprop ro.build.version.release`. Коли команда поверне версію Android, використайте цей ідентифікатор у `appium:udid`.

[Посібник із підключення ADB](/uk/api-reference/cloud-phone/adb)

## Установіть Appium і UiAutomator2 та запустіть сервер

Якщо Appium 3 або UiAutomator2 уже встановлено, пропустіть відповідну команду. Зупиніть сервер перед установленням драйвера. Переконайтеся, що є `uiautomator2`, і виправте помилки ADB або Java, знайдені Doctor. Якщо обидва знайдено, а єдине обов’язкове виправлення стосується `emulator`, можна продовжити з уже підключеним хмарним телефоном.

### macOS

```bash
npm install -g appium@3
appium driver install uiautomator2
appium driver list --installed
appium driver doctor uiautomator2
appium --address 127.0.0.1 --port 4723 --base-path /
```

### Windows PowerShell

```powershell
npm.cmd install -g appium@3
appium.cmd driver install uiautomator2
appium.cmd driver list --installed
appium.cmd driver doctor uiautomator2
appium.cmd --address 127.0.0.1 --port 4723 --base-path /
```

Залиште термінал сервера відкритим. В іншому терміналі перевірте стан. Продовжуйте, коли `value.ready` дорівнює `true`.

`curl http://127.0.0.1:4723/status` (macOS)

`curl.exe http://127.0.0.1:4723/status` (Windows PowerShell)

[Установлення UiAutomator2](https://appium.io/docs/en/latest/quickstart/uiauto2-driver/)

## Установіть і налаштуйте Appium Inspector

У macOS завантажте DMG arm64 для Apple Silicon або x64 для Intel і перенесіть застосунок до **Програм**. У Windows запустіть офіційний EXE, виберіть установлення для поточного користувача, вкажіть теку та завершіть роботу майстра.

[Офіційні випуски Appium Inspector](https://github.com/appium/appium-inspector/releases)

*Текст інтерфейсу перекладено англійською*

![Область і тека встановлення у Windows (текст інтерфейсу перекладено англійською)](/assets/win-setup-steps.1d5d82f64c8166a167cba488022ac777eaafafbce700516aed6ec330180376dd.f59a5fd3.png)

![Установлення у Windows завершено (текст інтерфейсу перекладено англійською)](/assets/win-finish.cd7d1848bbff51814fc0a58112d0a52be56099e1e63272c0f1f420bcef51e69b.f59a5fd3.png)

У розділі **Appium Server** укажіть **Remote Host** `127.0.0.1`, **Remote Port** `4723` і **Remote Path** `/`. Зніміть позначки **SSL** і **Use Proxy**. У **Capability Builder** відредагуйте **JSON Representation**, замінивши `localhost:9897` точним ідентифікатором ADB.

```json
{
  "platformName": "Android",
  "appium:automationName": "UiAutomator2",
  "appium:udid": "localhost:9897",
  "appium:noReset": true
}
```

![Параметри Inspector у Windows](/assets/win-config.2d5344fa51514e241c2ec951a9df46ae0e952fbc67d78b74f68840f653f211c8.f59a5fd3.png)

Збережіть і натисніть **Start Session**. Зображення екрана та **App Source** підтверджують підключення. Якщо сервер недоступний, перевірте `/status`. Якщо пристрій не знайдено, перевірте ідентифікатор, автентифікацію або тунель. Усуньте стан `offline` або `unauthorized` перед повторною спробою.

![Сеанс Android 15 у Windows](/assets/win-android15-session.c59074d8c5ae9c482ba5ae6a7b0e274bfb54fdbbdc8da8221fe1b6c2aad33564.f59a5fd3.png)

![Сеанс Android 15A у macOS](/assets/ins-live-session.5ddc67ab553c8e01fff640fcadcaf3101e727d67d6a1218b8c6a5f2f37fb5d07.f59a5fd3.png)