Как установить Appium: исчерпывающий чеклист для быстрого старта в автоматизации мобильных тестов

Appium — это краеугольный камень в автоматизации тестирования мобильных приложений. Этот кроссплатформенный инструмент с открытым исходным кодом позволяет писать тесты для iOS и Android, используя один и тот же API. Однако его первоначальная установка и настройка могут показаться лабиринтом зависимостей и переменных окружения. Этот структурированный чеклист проведет вас через каждый необходимый шаг, минимизируя ошибки и экономя часы на поиск решений в интернете. Следуйте пунктам последовательно.

Чеклист рассчитан на настройку Appium 2.x (последней основной версии) на macOS для тестирования как iOS, так и Android приложений. Для Windows или Linux шаги будут аналогичны с поправкой на установку специфичных драйверов и SDK.

**Предварительные требования и базовое ПО:**

• [ ] **Установить Node.js и npm.** Appium — это Node.js приложение. Скачайте LTS-версию с официального сайта nodejs.org. Проверьте установку: `node -v` и `npm -v`.
• [ ] **Установить Java Development Kit (JDK).** Требуется для работы Android SDK. Установите JDK 8 или 11 (рекомендуется от Adoptium/Temurin). Проверьте: `java -version`.
• [ ] **Установить Git.** Необходим для клонирования репозиториев и установки некоторых драйверов.

**Установка Appium и основных компонентов:**

• [ ] **Установить Appium 2.x через npm.** Откройте терминал и выполните: `npm install -g appium`. Флаг `-g` устанавливает его глобально. После установки проверьте: `appium -v`. Должна отобразиться версия 2.x.
• [ ] **Установить Appium Driver для UI Automation.** В Appium 2 драйвера устанавливаются отдельно. Установите основной драйвер: `appium driver install uiautomator2` (для Android) и `appium driver install xcuitest` (для iOS).
• [ ] **Установить Appium Doctor.** Это диагностический инструмент: `npm install -g appium-doctor`. Он поможет проверить всю конфигурацию.

**Настройка для Android:**

• [ ] **Установить Android Studio.** Это самый простой способ получить Android SDK и эмуляторы. Скачайте с developer.android.com/studio.
• [ ] **Настроить переменные окружения для Android SDK.** Добавьте в ваш `~/.zshrc` или `~/.bash_profile`:

```bash  export ANDROID_HOME=$HOME/Library/Android/sdk
 export PATH=$PATH:$ANDROID_HOME/emulator
 export PATH=$PATH:$ANDROID_HOME/platform-tools
 export PATH=$PATH:$ANDROID_HOME/tools/bin
 ```
 Выполните `source ~/.zshrc` и проверьте: `echo $ANDROID_HOME`.

• [ ] **Установить необходимые пакеты SDK через SDK Manager.** Запустите Android Studio -> Tools -> SDK Manager. Убедитесь, что установлены: `Android SDK Platform-Tools`, `Android SDK Build-Tools` (последняя версия), `Android Platform` для нужной версии API (например, API 33), и `Intel x86 Atom_64 System Image` или `Google Play ARM Image` для эмулятора.
• [ ] **Принять лицензии Android SDK.** Выполните в терминале: `yes | sdkmanager --licenses`. Это критически важный шаг, который часто пропускают.
• [ ] **Создать и запустить Android эмулятор (AVD).** В Android Studio: Tools -> Device Manager -> Create Device. Выберите устройство (например, Pixel 6) и систему с установленным образом. Запустите эмулятор.

**Настройка для iOS (только на macOS):**

• [ ] **Установить Xcode** из Mac App Store. Это обязательное требование.
• [ ] **Установить Xcode Command Line Tools.** Выполните в терминале: `xcode-select --install`. Примите лицензию Xcode: `sudo xcodebuild -license accept`.
• [ ] **Установить Carthage** (может потребоваться для некоторых плагинов): `brew install carthage`.
• [ ] **Настровать симулятор iOS.** Откройте Xcode -> Window -> Devices and Simulators. Убедитесь, что установлен симулятор нужной версии iOS и типа устройства (например, iPhone 14, iOS 16.2).

**Проверка установки с помощью Appium Doctor:**

• [ ] **Запустить проверку для Android:** `appium-doctor --android`. Инструмент проверит наличие всех необходимых компонентов. Все галочки должны стать зелеными. Если есть предупреждения (желтые), исправьте их.
• [ ] **Запустить проверку для iOS:** `appium-doctor --ios`. Аналогично, добейтесь зеленого статуса по всем пунктам.

**Установка клиентских библиотек и IDE:**

• [ ] **Выбрать и установить клиентскую библиотеку для вашего языка программирования.** Например, для Python: `pip install Appium-Python-Client`. Для Java: добавить зависимость `io.appium:java-client` в `pom.xml`.
• [ ] **Установить IDE для написания тестов.** PyCharm для Python, IntelliJ IDEA для Java, WebStorm для JavaScript и т.д.
• [ ] **Установить Appium Inspector (важнейший инструмент!).** Это замена старому Appium Desktop. Скачайте его с официального релиза на GitHub (репозиторий appium/appium-inspector). Он необходим для инспекции элементов приложения и записи их локаторов.

**Финальный тестовый запуск:**

• [ ] **Запустить сервер Appium.** В терминале выполните: `appium`. Сервер должен стартовать на `http://0.0.0.0:4723/` без ошибок. Оставьте его работать в отдельном окне терминала.
• [ ] **Запустить мобильный эмулятор/симулятор** (Android AVD или iOS Simulator).
• [ ] **Запустить Appium Inspector.** Настройте Desired Capabilities для подключения к эмулятору. Пример для Android:

```json  {
 "platformName": "Android",
 "appium:platformVersion": "13",
 "appium:deviceName": "Pixel_6_API_33",
 "appium:automationName": "UIAutomator2"
 }
 ```

• [ ] **Нажать кнопку "Start Session" в Appium Inspector.** Если все настроено верно, Inspector подключится к эмулятору и отобразит его текущий экран, позволяя просматривать дерево элементов. Это знак успешной установки.

Теперь ваша среда готова для написания первых автоматизированных тестов. Этот чеклист покрывает 95% типичных проблем при установке. Главные точки отказа — это неправильно настроенные переменные окружения, непринятые лицензии Android и отсутствие нужных драйверов в Appium 2. Следуя этому плану, вы превратите сложный процесс настройки в управляемую последовательность действий и сможете быстро перейти к самому интересному — созданию надежных мобильных автотестов.