Android 디버그 로그

아티클
07/13/2023

개발자가 애플리케이션 디버그에 사용하는 아주 일반적인 트릭은 Console.WriteLine에 대한 호출을 수행하는 것입니다. 하지만 Android와 같은 모바일 플랫폼에는 콘솔이 없습니다. Android 디바이스에는 앱을 작성하는 동안 사용할 수 있는 로그가 제공됩니다. 이 명령은 검색을 위해 입력하는 명령 때문에 logcat이라고도 합니다. 로그된 데이터를 보려면 디버그 로그 도구를 사용하세요.

Android 디버그 로그 개요

디버그 로그 도구는 Visual Studio를 통해 앱을 디버그하는 동안 로그 출력을 보는 방법을 제공합니다. 디버그 로그는 다음 디바이스를 지원합니다.

물리적인 Android 휴대폰, 태블릿 및 착용식 장치
Android Emulator에서 실행 중인 Android 가상 디바이스

참고 항목

디버그 로그 도구는 Xamarin Live Player에서 작동하지 않습니다.

디버그 로그는 앱이 디바이스에서 독립형으로 실행 중인 동안(즉 Visual Studio에서 연결이 끊어진 동안)에는 로그 메시지를 표시하지 않습니다.

디바이스 로그 도구를 열려면 도구 모음에서 디바이스 로그(logcat) 아이콘을 클릭합니다.

또는 다음 메뉴 선택 사항 중 하나에서 디바이스 로그 도구를 시작합니다.

다른 Windows > 디바이스 로그 보기 >
도구 > Android > 디바이스 로그

다음 스크린샷은 디버그 도구 창의 다양한 부분을 보여줍니다.

디바이스 선택기 – 모니터링할 물리적 디바이스 또는 실행 중인 에뮬레이터를 선택합니다.
로그 항목 – logcat의 로그 메시지 테이블입니다.
로그 항목 지우기 – 테이블에서 모든 현재 로그 항목을 지웁니다.
재생/일시 중지 – 새 로그 항목의 표시를 업데이트 또는 일시 중지 간에 전환합니다.
중지 – 새 로그 항목의 표시를 중지합니다.
검색 상자 – 이 상자에 검색 문자열을 입력하여 로그 항목의 하위 집합을 필터링합니다.

디버그 로그 도구 창이 표시되면 디바이스 풀다운 메뉴를 사용하여 모니터링할 Android 디바이스를 선택합니다.

디바이스를 선택한 후 디바이스 로그 도구는 실행 중인 앱에서 로그 항목을 자동으로 추가합니다. 이러한 로그 항목은 로그 항목 테이블에 표시됩니다. 디바이스 간에 전환하면 디바이스 로깅이 중지되었다가 다시 시작됩니다. 디바이스 선택기에 디바이스가 표시되기 전에 Android 프로젝트가 로드되어야 합니다. 디바이스 선택기에 디바이스가 표시되지 않는 경우 시작 단추 옆의 Visual Studio 디바이스 드롭다운 메뉴에서 디바이스가 사용 가능한지 확인합니다.

디바이스 로그를 열려면 패드 > 디바이스 로그 보기를 > 클릭합니다.

다음 스크린샷은 디버그 도구 창의 다양한 부분을 보여줍니다.

디바이스 선택기 – 모니터링할 물리적 디바이스 또는 실행 중인 에뮬레이터를 선택합니다.
로그 항목 – logcat의 로그 메시지 테이블입니다.
로그 항목 지우기 – 테이블에서 모든 현재 로그 항목을 지웁니다.
검색 상자 – 이 상자에 검색 문자열을 입력하여 로그 항목의 하위 집합을 필터링합니다.
메시지 표시 – 정보 메시지 표시를 전환합니다.
경고 표시 – 경고 메시지 표시를 전환합니다(경고 메시지는 노란색으로 표시됨).
오류 표시 – 오류 메시지 표시를 전환합니다(경고 메시지는 빨간색으로 표시됨).
다시 연결 – 디바이스에 다시 연결하고 로그 항목 표시를 새로 고칩니다.
표식 추가 – 최신 로그 항목 뒤에 표식 메시지(예: --- Marker N ---)를 삽입합니다. 여기서 N 은 1에서 시작하여 새 표식이 추가되면 1씩 증분하는 카운터입니다.

[디버그 로그] 도구 창이 표시되면 디바이스 풀다운 메뉴를 사용하여 모니터링할 Android 디바이스를 선택합니다.

명령줄에서 액세스

Visual Studio
Mac용 Visual Studio

디버그 로그를 보는 또 다른 옵션은 명령줄을 통해서 보는 것입니다. 명령 프롬프트 창을 열고 Android SDK 플랫폼 도구 폴더로 이동합니다(일반적으로 SDK 플랫폼 도구 폴더는 C:\Program Files (x86)\Android\android-sdk\platform-tools에 있음).

디바이스(물리적 디바이스 또는 에뮬레이터)가 하나만 연결된 경우 다음 명령을 입력하여 로그를 볼 수 있습니다.

$ adb logcat

디버그 로그를 보는 또 다른 옵션은 명령줄을 통해서 보는 것입니다. 터미널 창을 열고 Android SDK 플랫폼 도구 폴더(일반적으로 SDK 플랫폼 도구 폴더는 /Users/username/Library/Developer/Xamarin/android-sdk-macosx/platform-tools에 있음)로 이동합니다.

디바이스(물리적 디바이스 또는 에뮬레이터)가 하나만 연결된 경우 다음 명령을 입력하여 로그를 볼 수 있습니다.

$ ./adb logcat

연결된 디바이스가 둘 이상이면 디바이스를 분명히 식별해야 합니다. 예를 들어 adb -d logcat은 연결된 물리적 디바이스의 로그만 보여주고, adb -e logcat은 실행 중인 에뮬레이터의 로그만 보여줍니다.

adb를 입력하고 도움말 메시지를 읽어서 더 많은 명령을 찾을 수 있습니다.

디버그 로그에 쓰기

Android.Util.Log 클래스의 메서드를 사용하여 디버그 로그에 메시지를 쓸 수 있습니다. 예시:

string tag = "myapp";

Log.Info (tag, "this is an info message");
Log.Warn (tag, "this is a warning message");
Log.Error (tag, "this is an error message");

이 명령은 다음과 비슷한 출력을 생성합니다.

I/myapp   (11103): this is an info message
W/myapp   (11103): this is a warning message
E/myapp   (11103): this is an error message

디버그 로그에 쓰는 데 사용할 Console.WriteLine 수도 있습니다. 이러한 메시지는 약간 다른 출력 형식으로 logcat에 표시됩니다(이 기술은 Android에서 Xamarin.Forms 앱을 디버깅할 때 특히 유용합니다).

System.Console.WriteLine ("DEBUG - Button Clicked!");

이 명령은 logcat에 다음과 비슷한 출력을 생성합니다.

Info (19543) / mono-stdout: DEBUG - Button Clicked!

흥미로운 메시지

로그를 읽을 때(그리고 특히 다른 사람에게 로그 코드 조각을 제공할 때) 로그 파일을 전부 정독하는 일은 너무 힘든 경우가 많습니다. 로그 메시지를 보다 쉽게 탐색하려면 다음과 유사한 로그 항목을 찾습니다.

I/ActivityManager(12944): Starting: Intent { act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER] flg=0x10200000 cmp=GcTest.GcTest/gctest.Activity1 } from pid 24175

특히 애플리케이션 패키지 이름도 포함하는 정규식과 일치하는 줄을 찾습니다.

^I.*ActivityManager.*Starting: Intent

작업의 시작 부분에 해당하는 줄이며 다음 메시지 중 대부분(전부는 아님)이 애플리케이션과 관련되어야 합니다.

모든 메시지는 메시지를 생성하는 프로세스의 프로세스 식별자(pid)를 포함합니다. 위의 ActivityManager 메시지에서 12944 프로세스는 메시지를 생성합니다. 어떤 프로세스가 디버그 중인 애플리케이션의 프로세스인지 확인하려면 mono.MonoRuntimeProvider 메시지를 찾습니다.

I/ActivityThread(  602): Pub TouchTest.TouchTest.__mono_init__: mono.MonoRuntimeProvider

이 메시지는 시작된 프로세스에서 생성됩니다. 이 pid를 포함하는 모든 후속 메시지는 동일한 프로세스에서 생성됩니다.

다음을 통해 공유

Android 디버그 로그