Airbridge SDK 연동 후 예상하지 못한 동작이나 오류가 발생할 때, 정확한 문제 진단을 위해서는 디버그 로그가 필수적입니다. 이 가이드는 각 플랫폼에서 Airbridge 디버그 로그를 확인하고 저장하는 방법을 설명합니다.
디버그 로그를 확인하기 위해서는 먼저 Airbridge SDK 초기화 시 logLevel을 설정해야 합니다. logLevel 설정 방법은 플랫폼마다 다르므로, 아래의 플랫폼별 가이드를 참고하여 DEBUG 레벨로 설정한 후 진행해주세요.
logLevel 설정 확인: SDK 초기화 시 logLevel이 DEBUG로 설정되어 있는지 확인합니다.
앱 빌드 및 실행: Android Studio에서 앱을 빌드하여 테스트 기기에 설치합니다.
Logcat 필터 설정:
Android Studio 하단의 Logcat 탭을 엽니다.
우측 상단 필터 입력란에 고객앱의 패키지명을 입력하고, Airbridge를 입력하여 Airbridge 로그만 표시되도록 설정합니다.
이슈 재현: 문제가 발생하는 상황을 재현합니다.
로그 저장:
약 30초 동안 앱을 활성화 상태로 유지합니다.
Logcat의 모든 로그를 선택 후 복사합니다.
텍스트 에디터(메모장, VS Code 등)에 붙여넣어 파일로 저장합니다.
터미널에서 adb 명령어를 사용하여 로그를 직접 수집할 수 있습니다. Platform Tools가 설치되어 있어야 합니다.
Logcat 버퍼 초기화:
adb logcat -c이슈 재현: 문제가 발생하는 상황을 재현합니다.
파일에 기록:
adb logcat "Airbridge:V" "*:S" > airbridge_logs.txt이슈 재현 후 30초 정도 기다린 후 로그 저장을 중단합니다.
저장된 파일 확인: 현재 디렉토리에 airbridge_logs.txt 파일이 생성됩니다.
logLevel 설정 확인: SDK 초기화 시 logLevel이 DEBUG로 설정되어 있는지 확인합니다.
디바이스 연결: iOS 기기를 Mac에 연결합니다.
앱 빌드 및 실행: Xcode에서 앱을 빌드하여 연결된 기기에 설치 및 실행합니다.
콘솔 필터 설정:
Xcode 하단의 Console 탭을 엽니다.
우측 하단의 필터 입력란에 Airbridge를 입력하여 Airbridge 로그만 표시되도록 설정합니다.
이슈 재현: 문제가 발생하는 상황을 재현합니다.
로그 저장:
약 30초 동안 앱을 활성화 상태로 유지합니다.
Console의 모든 로그를 선택 후 복사합니다.
텍스트 에디터에 붙여넣어 파일로 저장합니다.
iOS 기기에서 직접 Xcode로 빌드할 수 없는 경우, Mac의 Console 앱을 사용하여 로그를 수집할 수 있습니다.
디바이스 연결: iOS 기기를 Mac에 연결합니다.
Console 앱 열기: Spotlight 검색(Cmd+Space)에서 "Console"을 검색하여 앱을 실행합니다.
로그 스트림 시작:
Console 앱 상단의 검색란 옆 장치 선택 메뉴에서 연결된 iOS 기기를 선택합니다.
상단의 검색/필터 입력란에 앱의 번들 ID를 입력하여 필터링합니다.
로그 초기화: 이전 로그를 제거하기 위해 Console 창을 우클릭하여 "Clear Console"을 선택합니다.
이슈 재현: 문제가 발생하는 상황을 재현합니다.
로그 저장:
약 30초 동안 앱을 활성화 상태로 유지합니다.
표시된 모든 로그를 선택 후 복사합니다.
텍스트 에디터에 붙여넣어 파일로 저장합니다.
수집범위: 이슈 재현부터 30초 이상의 로그를 전달하여 초기화, 추적, 처리 과정 전체를 포함하도록 합니다.
필터링: Airbridge 관련 로그만 포함하도록 필터링하는 것이 좋습니다.
파일 형식: 되도록 텍스트 파일(.txt) 형식으로 저장하여 전달합니다.
SDK 버전
앱 설치 방식 (일반 설치, 테스트 배포 등)
기기 정보 (OS 버전, 모델명 등)
발생 시점 (특정 이벤트 시, 앱 시작 시 등)
재현 경로
환경 정보: 다음 정보도 함께 제공하면 문제 분석이 빨라집니다.
DEBUG 로그는 민감한 내부 동작을 노출할 수 있습니다. 릴리즈 빌드에서는 반드시 제거하거나 WARNING 이상으로 복원해야 합니다.
도움이 되었나요?