Сьогодні існує величезна безліч різних ігрових платформ: ПК, консолі, мобільні пристрої та інші. І мова піде про інструмент для наймасовішої мобільної ігрової платформи – Android. Android Debug Bridge (скорочено ADB) – це утиліта, яка доступна з Android SDK за допомогою командного рядка.

Android SDK (Android Software Development Kit) – середовище розробки додатків для операційної системи Android. Вона дозволяє створювати та тестувати Android-додатки.

ADB (Android Debug Bridge) – консольний додаток для ПК, за допомогою якого робиться відладка Android пристроїв, у тому числі емуляторів. Працює за принципом клієнт-сервер. При першому запуску ADB з будь-якою командою створюється сервер у вигляді системної служби (демона), яка буде прослуховувати всі команди, що посилаються на порт 5037.

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

Встановлення ADB. Налаштування середовища та пристрою

ADB є частиною Android SDK Platform-Tools, який, у свою чергу, є компонентом Android SDK і включає різні інструменти для взаємодії з платформою Android. Так що, після установки Android Studio, можна скористатися інструментом SDK Manager і завантажити «найсвіжішу» версію інструменту. Також можна завантажити окремо Android SDK Platform-Tools за посиланням

Після встановлення ADB/SDK необхідно відкрити вікно «Edit the system environment variables».

Контрольна_панель

У вікні властивостей на вкладці «Advanced» натиснути на кнопку «Environment Variables».

Змінні_середовища

У переліку змінних середовища буде змінна з ім'ям «Path». Необхідно вибрати її та натиснути кнопку «Edit» або двічі клікнути по рядку.

Path

Відкриється вікно «Edit System Variable», в якій необхідно додати шлях до тек «Tools» і «Platform-Tools». Важливо поставити знак «;» і після крайньої змінної, що є в полі.

Зміна_системної_змінної

Після всіх налаштувань необхідно перезавантажити комп'ютер. Для перевірки застосування змін в командному рядку можна написати команду «adb devices» і, якщо з'явиться інформація як на скріншоті нижче, означає все зроблено правильно і налаштування були застосовані.

команда_adb_devices

Для роботи в ADB з мобільним пристроєм також треба провести зміни і в самому пристрої. Налаштування кожного окремого девайса відрізняється залежно від виробника, моделі та встановленої на нього версії ПЗ. Але, як правило, всі кроки більш-менш можна звести до наступних:

  1. Перейти на пристрої в розділ «Налаштування» – «Про пристрій».
  2. Тапнути по номеру білда 7 раз. 
  3. Відкрити розділ «Опції розробника» в налаштуваннях. 
  4. Активувати пункт «Відладка по USB».

Як використовувати ADB у тестуванні 

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

  • перегляд списку всіх підключених до ПК пристроїв та їх готовність до роботи з ADB;
  • встановлення та видалення додатків на пристрої; 
  • перегляд логів пристрою;
  • передача файлів на пристрій з ПК і навпаки;
  • очищення розділу data; 
  • перезапис розділу data;
  • формування звіту про помилки;
  • управління правами доступу до пристрою і так далі.

Як можна побачити, функціонал ADB дуже великий і, не дивлячись на те, що це проста утиліта Android SDK, вона незамінна для тестувальників на мобільних пристроях. Нижче будуть представлені команди для реалізації основних функцій.

ADB команди

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

  • adb start-server – дозволяє запустити службу/демон;
  • adb kill-server – протилежність першої команди, призначена для зупинки служби/демона;
adb kill-server
  • adb devices – відображає список всіх приєднаних пристроїв (у т.ч. емуляторів), вказуючи їх серійний номер та статус;
  • adb bugreport d:/12/ – призначена для створення zip-архіву з повною дебаг інформацією (dumpsys, dumpstate і logcat) в текстовому форматі (.txt);
adb bugreport
  • adb logcat – мабуть, найпопулярніша і важливіша з ADB команд при тестуванні ігор, дозволяє збирати і переглядати логи з пристрою (логи можна записувати в окремий файл або переглядати безпосередньо у вікні командного рядка Windows);
adb logcat
  • adb shell screencap /sdcard/name.png – ця команда дозволяє отримати скріншот екрану пристрою. Важливо підкреслити, що після самої команди необхідно вказати шлях, ім'я та розширення майбутнього файлу скріншоту (наприклад, /sdcard/screencap.png);
  • adb shell screenrecord /sdcard/name.mp4 – запис відео з екрану пристрою без необхідності використовувати сторонні застосування. Іноді краще один раз побачити дефект, чим 100 разів його описати. Як і у випадку зі зняттям скріншоту, необхідно вказувати після команди шлях, ім'я та розширення майбутнього відеофайлу (наприклад, /sdcard/name.mp4);
  • adb install C:cat.apk – як і виходить з назви команди, вона призначена для встановлення пакетів (додатків). Для завантаження додатка з ПК після команди необхідно вказати шлях, ім'я і розширення файлу .apk (наприклад, C:cat.apk);
adb install
  • adb push d:12textfile.txt /sdcard/ – команда для копіювання файлів з ПК на мобільний пристрій;
  • adb pull /sdcard/textfile.txt d:12 – копіювання файлів з пристрою на ПК.
adb pull

Опції (ключі) до команд

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

Розглянемо декілька команд з опціями:

  • adb logcat > d:12logsname.txt – запис логів у файл logsname.txt в директорію d:12 (якщо файлу не існує, система створить файл з таким ім'ям);
  • adb logcat – s Unity > d:12logsname.txt – запис відфільтрованих Unity логів у файл logsname.txt в директорію d:12;
  • adb shell screenrecord --time – limit 30 /sdcard/name.mp4 – встановлення ліміту на довжину відео в 30 секунд (за замовчуванням ліміт 180 секунд);
  • adb install – s d:cat.apk – встановлення додатка на SD card.

З повним списком команд та опцій можна ознайомитися на сайті.

Висновки

Android Debug Bridge є зручним і незамінним консольним додатком для тестувальників на мобільних пристроях. Воно має безліч команд, які допоможуть взаємодіяти з девайсами за різними функціями.

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