SimpleADB

Программа SimpleADB разработана в среде Delphi XE и предназначена для упрощения работы при отладке Android устройств посредством утилиты adb (Android Debug Bridge). Все действия, выполняемые программой, осуществляются путем вызова adb с соответствующими параметрами. Вызываемые команды и результат их работы можно увидеть в окне логов.

Общие настройки программы

ADB path - путь к папке, где расположен файл adb.exe

Root - если даннай опция установлена, то все команды из под shell будут вызываться через команду su

Check Root - проверка предоставления root прав для ADB Shell. Проверка осуществляется вызовом команды:

C:\android-sdk\platform-tools\adb shell su -c date

при предоставлении необходимых прав команда вернет текущую дату. После проверки опция Root сама выставляется в нужное положение

Timeout for sending command - максимальное время в секундах на выполнение каманд из поля Send ADB Command

Настройка внешнего вида главного окна

Screen left - отображать экран устройства в левой части главного окна

Screen right - отображать экран устройства в правой части главного окна

Настройка управления скриншотом

Screen Cap Path - путь и имя файла в который будет сохраняться скриншот на устройстве

Update Screen Delay - задержка, в милисекундах, автообновления скриншота

Настройка файлового менеджера

Command to get a list of files - команда с помощью которой, будет получен список файлов Android устройства. Если выбрана команда adb shell ls и включена опция Root, то список будет вызываться так:

C:\android-sdk\platform-tools\adb shell su -c ls

Timeout copying a file - максимальное время в секундах на копирование файла/папки в устройство или из устройства

SQLite3 Path - путь к программе sqlite3 на устройстве

Check SQLite3 - проверка работы утилиты sqlite3

Install SQLite3 - установка утилиты sqlite3 на устройство. Для установки данная утилита должна находится в папке программы SimpleADB в директории sqlite3

Визуальное управление по скриншоту

В левой части основного окна программы отображается скриншот экрана Android устройства. Обновить его можно с помощью кнопки "Update Screen". Команды для получения скриншота:

# делаем скрин
C:\android-sdk\platform-tools\adb shell screencap -p /sdcard/screen.png

# копируем картинку на компьютер
C:\android-sdk\platform-tools\adb pull "/sdcard/screen.png" "C:\Temp\1.png"

# удаляем картинку на устройстве (с версии 1.0.1 этой команды нет)
C:\android-sdk\platform-tools\adb shell rm -f /sdcard/screen.png

На этой кнопке можно вызвать контекстное меню с опцией "Auto update screen", которая запускает постоянное обновление скриншета с периодом заданным в настройках. Выключается опция из того-же контекстного меню или по клику на кнопку "Update Screen"

Клик левой кнопкой мыши по скриншоту передаст событие клика по экрану устройства. А если зажать левую кнопку мыши в одном месте картинки и переместив курсор отжать ее, то передастся событие смещения

# событие касания по экрану в точке (500, 1450)
C:\android-sdk\platform-tools\adb shell input tap 500 1450

# событие движения по экрану из точку (100, 500) в точку (100, 1450)
C:\android-sdk\platform-tools\adb shell input swipe 100 500 100 1450

Для того что-бы действия на скриншоте работали корректно, нужно правильно выставить поворот экрана. То есть, если картинка отображается неправильно ее нужно перевернуть, нажав соответствующую кнопку под скриншотом. На кнопке поворота можно вызвать контекстное меню (нажав правую кнопку мыши), с помощь которого можно:

Disable automatic rotation - отключить авто поворот экрана

Enable automatic rotation - включить авто поворот экрана

Rotate to portrait - установить экран в вертикальное положении (работает только при отключенном авто повороте экрана и в приложениях которые поддерживают данное положение экрана)

Rotate to landscape - установить экран в горизонтальное положении (работает только при отключенном авто повороте экрана и в приложениях которые поддерживают данное положение экрана)

# Disable automatic rotation
C:\android-sdk\platform-tools\adb shell content insert --uri content://settings/system --bind name:s:accelerometer_rotation --bind value:i:0

# Enable automatic rotation
C:\android-sdk\platform-tools\adb shell content insert --uri content://settings/system --bind name:s:accelerometer_rotation --bind value:i:1

# Rotate to portrait
C:\android-sdk\platform-tools\adb shell content insert --uri content://settings/system --bind name:s:user_rotation --bind value:i:0

# Rotate to landscape
C:\android-sdk\platform-tools\adb shell content insert --uri content://settings/system --bind name:s:user_rotation --bind value:i:1

Также под скриншотом есть еще четыре кнопки которые отправляют события нажатия соответствующих клавиш. Эти кнопки, а также действия на картинке запускают таймер авто обновления скриншота, время которого указано в настройках

# KEYCODE_BACK
C:\android-sdk\platform-tools\adb shell input keyevent 4

# KEYCODE_HOME
C:\android-sdk\platform-tools\adb shell input keyevent 3

# KEYCODE_APP_SWITCH
C:\android-sdk\platform-tools\adb shell input keyevent 187

# KEYCODE_POWER
C:\android-sdk\platform-tools\adb shell input keyevent 26

Процессы

Что-бы посмотреть список запущенных процессов на Android устройстве, нужно нажать соответствующую клавишу в главном окне программы.

Список получается при помощи команды:

C:\android-sdk\platform-tools\adb shell ps

Список можно отсортировать по любому из полей, а также можно завершить выбранный процесс, нажав на соответствующую кнопку. Процесс останавливается следующей командой:

C:\android-sdk\platform-tools\adb shell kill 123

Редактирование контента

Окно редактирования контента открывается по нажатию кнопки "Content" в главном окне программы.

URI - в данном поле указывается адрес контента

Query - запросить/обновить список параметров

Insert - добавить параметр. При добавлении нужно указать: имя переменной; тип данных; и текущее значение

Delete - удаление текущего выбранного параметра

Также по двойному клику на строку параметра можно изменить его значение. При этом желательно убедится, что тип переменой указан правильно.

Файловый менеджер

F2 SQLite3 - открывается редактор sqlite3 в отдельной консоли с выбранной базой данных. Для редактирования базы данных на ПК в папке с утилитой adb.exe должна находится и утилита sqlite3.exe

F3 Notepad - открыть текущий файл в блокноте. Если открыть файл с Android, после его изменения программа выдаст предложение для перезаписи файла на устройство

F4 HxD - открыть текущий файл в редакторе HxD (если он установлен). Если открыть файл с Android, после его изменения программа выдаст предложение для перезаписи файла на устройство

F5 Copy - копировать выбранные файлы и папки в ПК или Android

F6 Remove - переместить выбранные файлы и папки в ПК или Android

F7 MkDir - создать папку на ПК или Android

F8 Delete - удалить выбранные файлы и папки с ПК или Android

F9 ChMod - редактирование прав доступа для выбранного файла (только для Android)

И при двойном клике с паузой более секунды можно переименовать выбранный файл или папку, как на компьютере так и на Android устройстве.