디버거 사용

이 페이지에서는 OS 개발에 LLDB 또는 GDB를 사용하는 방법을 자세히 설명합니다. 앱 개발의 경우 LLDB 기반의 Android 스튜디오 GUI를 사용하는 방법을 설명한 앱 디버그를 참고하세요.

GDB는 지원 중단되었으며 곧 삭제됩니다. GDB에서 LLDB로 전환한다면 LLDB 가이드부터 읽어보는 것이 좋습니다. 전문 GDB 사용자라면 전환하는 동안 GDB에서 LLDB로의 명령어 지도가 매우 유용합니다.

기본 요건

디버거를 사용하려면 다음 단계를 따르세요.

  • 일반적인 envsetup.sh 명령어로 빌드 환경을 설정합니다.
  • 빌드할 때 사용한 것과 동일한 lunch 명령어를 실행합니다.

환경 설정과 관련해 추가 도움이 필요한 경우 환경 설정을 참고하세요.

실행 중인 앱 또는 프로세스 디버깅

실행 중인 앱 또는 네이티브 데몬에 연결하려면 PID와 함께 gdbclient.py를 사용합니다. 예를 들어 PID 1234를 사용하여 프로세스를 디버그하려면 호스트에서 다음을 실행합니다.

gdbclient.py -p 1234

이 스크립트는 포트 전달을 설정하고 기기에서 적절한 원격 디버깅 스텁을 시작한 후, 호스트에서 디버거를 시작합니다. 그런 다음 기호를 찾도록 이 디버거를 구성한 후 원격 디버깅 스텁에 디버거를 연결합니다.

네이티브 프로세스 시작 디버깅

프로세스를 시작할 때 디버그하려면 -r 옵션과 함께 gdbclient.py를 사용합니다. 예를 들어 ls /bin을 디버그하려면 호스트에서 다음을 실행합니다.

gdbclient.py -r /system/bin/ls /bin

그런 다음 디버거 프롬프트에서 continue를 입력합니다.

앱 시작 디버깅

앱이 시작될 때 앱을 디버깅하려는 경우가 있는데, 충돌이 발생한 경우 및 충돌이 발생하기 전에 무슨 문제가 있었는지 코드를 차근차근 살펴보고자 하는 경우가 여기에 해당합니다. 연결이 잘 작동하는 경우가 있지만 어떤 경우에는 연결하기 전에 앱이 충돌해 연결이 불가능합니다. 앱에 포트를 열 수 있는 권한이 없을 수 있고 gdbserver가 이러한 제한사항을 상속받기 때문에 logwrapper 접근 방법(strace에 사용됨)이 항상 효과가 있는 것은 아닙니다.

앱 시작을 디버그하려면 설정의 개발자 옵션을 사용하여 자바 디버거가 연결될 때까지 앱이 대기하도록 지시합니다.

  1. 설정 > 개발자 옵션 > 디버그할 앱 선택으로 이동하고 목록에서 앱을 선택한 다음 디버거 연결 대기를 클릭합니다.
  2. 런처에서 또는 명령줄을 사용하여 실행하려는 앱을 시작합니다.
    adb shell am start -a android.intent.action.MAIN -n APP_NAME/.APP_ACTIVITY
    
  3. 앱이 로드되고, 앱이 디버거를 대기하고 있음을 알리는 대화상자가 표시될 때까지 기다립니다.
  4. gdbserver/gdbclient를 일반적인 방법으로 연결하고 중단점을 설정한 다음 프로세스를 계속 진행합니다.

앱이 실행되도록 하려면 자바 디버거(jdb)와 같은 자바 디버그 유선 프로토콜(JDWP) 디버거를 연결합니다.

adb forward tcp:12345 jdwp:XXX  # (Where XXX is the PID
of the debugged process.)
jdb -attach localhost:12345

비정상 종료되는 앱 또는 프로세스 디버깅

디버거에 연결할 수 있도록 debuggerd가 다운된 프로세스를 정지하도록 하려면 적절한 속성을 설정합니다.

  • Android 11 이상
    adb shell setprop debug.debuggerd.wait_for_debugger true
    
  • Android 11 이하
    adb shell setprop debug.debuggerd.wait_for_gdb true
    
  • Android 6.0 Marshmallow 이하
    adb shell setprop debug.db.uid 999999
    

일반적인 비정상 종료 출력 끝부분에서는 debuggerd가 logcat을 통해 디버거를 다운된 프로세스에 연결하는 방법을 보여주는 복사하여 붙여넣기 지침을 제공합니다.

기호 없이 디버깅

32비트 ARM의 경우 기호가 없으면 gdb는 어떤 명령 집합이 디스어셈블을 수행하는지 확인할 수 없습니다(ARM 또는 Thumb). 기호 정보가 없을 때 기본값으로 선택된 명령 세트를 지정하려면 다음 속성을 설정합니다.

set arm fallback-mode arm  # or thumb

VS 코드로 디버깅

LLDB는 Visual Studio Code에서 디버깅 플랫폼 코드를 지원합니다. LLDB CLI 인터페이스 대신 VS 코드 디버거 프런트엔드를 사용하여 기기에서 실행되는 네이티브 코드를 제어하고 디버그할 수 있습니다.

디버깅에 VS 코드를 사용하기 전에 CodeLLDB 확장 프로그램을 설치하세요.

VS 코드를 사용하여 코드를 디버그하는 방법:

  1. gdbclient.py 또는 lldbclient.py를 실행하는 데 필요한 모든 빌드 아티팩트(예: 기호)가 있는지 확인합니다.
  2. 다음 명령어를 실행합니다.
    lldbclient.py --setup-forwarding
          vscode-lldb ANY_OTHER_FLAGS -p pid | -n proc-name | -r ...

    그러면 JSON 객체가 인쇄되고 lldbclient.py가 계속해서 실행됩니다. 이는 예상된 동작이므로 lldbclient.py 프로그램을 종료하지 마세요.

    도구에서 플래그를 파싱하는 방식으로 인해 -r 플래그가 있다면 마지막 플래그여야 합니다.

  3. VS 코드의 디버깅 탭에서 구성 추가를 선택하고 LLDB: 맞춤 실행을 선택합니다. 그러면 launch.json 파일이 열리고 목록에 새 JSON 객체가 추가됩니다.
  4. 새로 추가된 디버거 구성을 삭제합니다.
  5. lldbclient.py가 인쇄한 JSON 객체를 복사하여 방금 삭제한 객체에 붙여 넣습니다. 변경사항을 저장합니다.
  6. 창을 다시 로드하여 디버거 목록을 새로 고치려면 Ctrl+Shift+P를 누르고 reload window를 입력합니다.
  7. 새 디버거 구성을 선택하고 실행을 누릅니다. 디버거는 10~30초 후에 연결해야 합니다.
  8. 디버깅이 끝나면 lldbclient.py를 실행 중인 터미널로 이동하고 Enter를 눌러 lldbclient.py 프로그램을 종료합니다.