ndk-gdb

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

NDK에는 명령줄 네이티브 디버깅 세션 (이전에는 gdb였으나 현재는 lldb)을 시작하는 ndk-gdb 셸 스크립트가 포함되어 있습니다. GUI를 사용하고 싶은 사용자는 Android 스튜디오에서 디버깅 문서를 참조해야 합니다.

요구사항

명령줄 네이티브 디버깅이 작동하려면 다음 요구사항이 충족되어야 합니다.

• ndk-build 스크립트를 사용하여 앱을 빌드합니다. ndk-gdb 스크립트는 레거시 make APP=<name> 메서드를 사용하여 빌드하는 기능을 지원하지 않습니다.
• android:debuggable 속성을 true로 설정하는 <application> 요소를 포함하여 AndroidManifest.xml 파일에서 앱 디버깅을 사용 설정합니다.
• Android 2.2(Android API 레벨 8) 이상에서 실행할 앱을 빌드합니다.
• Android 2.2 이상을 실행하는 기기나 에뮬레이터에서 디버그합니다. AndroidManifest.xml 파일에서 선언하는 타겟 API 수준은 디버깅에서 중요하지 않습니다.
• Unix 셸에서 앱을 개발합니다. Windows에서는 Cygwin 또는 실험용 ndk-gdb-py Python 구현을 사용합니다.
• GNU Make 3.81 이상을 사용합니다.

사용

ndk-gdb 스크립트를 호출하려면 애플리케이션 디렉터리 또는 그 아래의 디렉터리로 변경합니다. 예:

cd $PROJECT
$NDK/ndk-gdb

여기서 $PROJECT는 프로젝트의 루트 디렉터리를 가리키고 $NDK는 NDK 설치 경로를 가리킵니다.

ndk-gdb를 호출하면 생성되는 네이티브 라이브러리의 기호/디버그 버전과 소스 파일을 찾는 세션이 구성됩니다. 애플리케이션 프로세스에 성공적으로 연결되면 ndk-gdb가 다양한 시스템 라이브러리를 찾을 수 없다는 일련의 긴 오류 메시지를 출력합니다. 호스트 머신은 타겟 기기에 이러한 라이브러리의 기호/디버그 버전을 포함하지 않으므로 이러한 오류 메시지가 출력되는 것은 정상입니다. 따라서 이러한 메시지는 무시해도 됩니다.

다음으로 ndk-gdb는 일반적인 lldb 프롬프트를 표시합니다.

ndk-gdb와 상호작용하는 방식은 lldb와 상호작용하는 방식과 같습니다. lldb에 익숙하지 않지만 gdb를 알고 있다면 유용한 [GDB에서 LLDB로의 명령어 지도](https://lldb.llvm.org/use/map.html)를 참고하세요.

ndk-gdb는 여러 오류 조건을 처리하며 문제를 발견하면 정보용 오류 메시지를 표시합니다. 이러한 검사에는 다음과 같은 조건이 충족되는지 확인하는 작업이 포함됩니다.

• ADB가 지정 경로에 있는지 확인합니다.
• 애플리케이션이 해당 매니페스트에서 디버깅 가능한 것으로 선언되어 있는지 확인합니다.
• 기기에서 같은 패키지 이름으로 설치되어 있는 애플리케이션 역시 디버깅이 가능한지 확인합니다.

기본적으로 ndk-gdb는 이미 실행 중인 애플리케이션 프로세스가 있는지 검색하고 실행 중인 프로세스를 찾지 못하는 경우 오류를 표시합니다. 하지만 --start 또는 --launch=<name> 옵션을 사용하여 디버깅 세션 전에 활동을 자동으로 시작할 수 있습니다. 자세한 내용은 옵션을 참조하세요.

옵션

전체 옵션 목록을 보려면 명령줄에 ndk-gdb --help를 입력하세요. 표 1에는 흔히 사용되는 여러 가지 옵션이 간략한 설명과 함께 나와 있습니다.

표 1. 일반적인 ndk-gdb 옵션과 설명

이 옵션을 지정하고 ndk-gdb를 시작하면 애플리케이션 manifest에 나열된 시작 가능한 첫 번째 활동이 시작됩니다. 그 다음으로 가능한 활동을 시작하려면 --launch=<name>을 사용하세요. 시작 가능한 활동 목록을 덤프하려면 명령줄에서 --launch-list를 실행합니다.

참고: 이 표의 마지막 3개 옵션은 Python 버전의 ndk-gdb에만 적용됩니다.