# Руководство по подключению 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, проверьте путь командой `(Get-Command adb).Source` в Windows. Корень SDK содержит каталог `platform-tools`. В Path каталог `bin` JDK 17 должен стоять перед старой версией Java. После изменения переменных пользователя откройте 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](/ru/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)