ndk-gdb

NDK включает в себя сценарий оболочки с именем ndk-gdb для запуска собственного сеанса отладки из командной строки. Пользователям, которые предпочитают использовать графический интерфейс, вместо этого следует прочитать документацию по отладке в Android Studio .

Требования

Для работы встроенной отладки из командной строки должны быть выполнены следующие требования:

• Создайте свое приложение с помощью сценария ndk-build . Сценарий ndk-gdb не поддерживает использование устаревшего метода make APP=<name> для сборки.
• Включите отладку приложения в файле AndroidManifest.xml , включив элемент <application> , который устанавливает для атрибута android:debuggable значение true .
• Создайте свое приложение для работы на Android 2.2 (уровень Android API 8) или выше.
• Отладка на устройстве или эмуляторе под управлением Android 2.2 или более поздней версии. Для целей отладки целевой уровень API, объявленный в файле AndroidManifest.xml не имеет значения.
• Разработайте свое приложение в оболочке Unix. В Windows используйте Cygwin или экспериментальную реализацию Python ndk-gdb-py .
• Используйте GNU Make 3.81 или выше.

Использование

Чтобы вызвать сценарий ndk-gdb , перейдите в каталог приложения или любой каталог под ним. Например:

cd $PROJECT
$NDK/ndk-gdb

Здесь $PROJECT указывает на корневой каталог вашего проекта, а $NDK указывает на путь установки NDK.

Когда вы вызываете ndk-gdb , он настраивает сеанс для поиска исходных файлов и версий символов/отладки созданных вами собственных библиотек. При успешном подключении к процессу приложения ndk-gdb выводит длинную серию сообщений об ошибках, отмечая, что не может найти различные системные библиотеки. Это нормально, поскольку ваш хост-компьютер не содержит символьных/отладочных версий этих библиотек на целевом устройстве. Вы можете смело игнорировать эти сообщения.

Затем ndk-gdb отображает обычное приглашение GDB.

Вы взаимодействуете с ndk-gdb так же, как и с GNU GDB. Например, вы можете использовать b <location> для установки точек останова и c (для «продолжения») для возобновления выполнения. Полный список команд смотрите в руководстве GDB. Если вы предпочитаете использовать отладчик LLDB , используйте параметр --lldb при вызове сценария ndk-gdb .

Обратите внимание: когда вы выходите из командной строки GDB, процесс приложения, который вы отлаживаете, останавливается. Такое поведение является ограничением GDB.

ndk-gdb обрабатывает множество ошибок и отображает информативное сообщение об ошибке, если обнаруживает проблему. эти проверки включают проверку выполнения следующих условий:

• Проверяет, что ADB находится на вашем пути.
• Проверяет, что ваше приложение объявлено в манифесте отлаживаемым.
• Проверяет, что на устройстве установленное приложение с тем же именем пакета также является отлаживаемым.

По умолчанию ndk-gdb ищет уже запущенный процесс приложения и отображает ошибку, если его не находит. Однако вы можете использовать опцию --start или --launch=<name> , чтобы автоматически запускать свою деятельность перед сеансом отладки. Дополнительную информацию см. в разделе «Параметры» .

Параметры

Чтобы просмотреть полный список параметров, введите ndk-gdb --help в командной строке. В таблице 1 показаны некоторые наиболее часто используемые из них, а также их краткие описания.

Таблица 1. Распространенные параметры ndk-gdb и их описания.

Запуск ndk-gdb с указанной опцией запускает первое запускаемое действие, указанное в манифесте вашего приложения. Используйте --launch=<name> чтобы запустить следующее запускаемое действие. Чтобы сбросить список запускаемых действий, запустите --launch-list из командной строки.

Вариант	Описание>
--lldb	Если установлено, сценарий будет использовать для сеанса отладчик LLDB вместо gdb.
--verbose	Этот параметр указывает системе сборки печатать подробную информацию о настройке сеанса встроенной отладки. Это необходимо только для проблем отладки, когда отладчик не может подключиться к приложению, а сообщений об ошибках, отображаемых ndk-gdb недостаточно.
--force	По умолчанию ndk-gdb прерывается, если обнаруживает, что на том же устройстве уже запущен другой собственный сеанс отладки. Эта опция убивает другой сеанс и заменяет его новым. Обратите внимание, что этот параметр не уничтожает само отлаживаемое приложение, которое необходимо закрыть отдельно.
--start	Когда вы запускаете ndk-gdb , он по умолчанию пытается подключиться к существующему работающему экземпляру вашего приложения на целевом устройстве. Вы можете переопределить это поведение по умолчанию, используя --start для явного запуска приложения на целевом устройстве перед сеансом отладки.
--launch=<name>	Эта опция аналогична --start , за исключением того, что она позволяет запускать определенное действие из вашего приложения. Эта функция полезна только в том случае, если ваш манифест определяет несколько запускаемых действий.
--launch-list	Эта удобная опция распечатывает список всех имен запускаемых действий, найденных в манифесте вашего приложения. --start использует первое имя действия.
--project=<path>	Этот параметр указывает каталог проекта приложения. Это полезно, если вы хотите запустить сценарий без предварительного перехода в каталог проекта.
--port=<port>	По умолчанию ndk-gdb использует локальный TCP-порт 5039 для связи с приложением, которое он отлаживает на целевом устройстве. Использование другого порта позволяет выполнять отладку программ, работающих на разных устройствах или эмуляторах, подключенных к одному хост-компьютеру.
--adb=<file>	Этот параметр указывает исполняемый файл инструмента adb . Это необходимо только в том случае, если вы не указали путь для включения этого исполняемого файла.
-d -e -s <serial>	Эти флаги аналогичны одноименным командам adb. Установите эти флаги, если к вашему хост-компьютеру подключено несколько устройств или эмуляторов. Их значения следующие: -d Подключитесь к одному физическому устройству. -e Подключитесь к одному устройству-эмулятору. -s <serial> Подключитесь к конкретному устройству или эмулятору. Здесь <serial> — это имя устройства, указанное командой adb devices . Альтернативно вы можете определить переменную среды ADB_SERIAL для указания конкретного устройства без необходимости использования конкретной опции.
--exec=<file> -x <file>	Эта опция указывает ndk-gdb запускать команды инициализации GDB, найденные в <file> после подключения к отлаживаемому процессу. Это полезная функция, если вы хотите сделать что-то повторно, например настроить список точек останова, а затем автоматически возобновить выполнение.
--nowait	Отключите приостановку выполнения кода Java до тех пор, пока GDB не подключится. Передача этой опции может привести к тому, что отладчик пропустит ранние точки останова.
--tui -t	Включите текстовый пользовательский интерфейс, если он доступен.
--gnumake-flag=<flag>	Эта опция представляет собой дополнительный флаг (или флаги), который необходимо передать системе ndk-build при запросе у нее информации о проекте. Вы можете использовать несколько экземпляров этой опции в одной команде.

Примечание. Последние три параметра в этой таблице относятся только к версии ndk-gdb для Python.

Поддержка потоков

Если ваше приложение работает на платформе старше Android 2.3 (уровень API 9), ndk-gdb не сможет правильно отлаживать собственные потоки. Отладчик может отлаживать только основной поток, abd полностью игнорирует выполнение других потоков.

Если вы поместите точку останова на функцию, выполняемую в неосновном потоке, программа завершит работу, и GDB отобразит следующее сообщение:

Program terminated with signal SIGTRAP, Trace/breakpoint trap.
      The program no longer exists.