맥 안드로이드 에뮬레이터 로그 확인: 파일 위치, 복사, 지원팀에 보내는 법

안드로이드 에뮬레이터가 실행되지 않거나, 오류가 뜨거나, 버튼을 눌러도 아무 반응이 없으면 지원팀은 로그를 요청합니다. 로그는 엔진과 런처가 하는 일을 한 줄씩 적어 두는 텍스트 파일입니다. MACOS EMULATOR에서 로그를 찾는 곳, 잘리지 않게 보내는 법, 그리고 복사하는 시점이 왜 중요한지 정리했습니다.

에뮬레이터 로그에 담기는 것

안드로이드 기기가 돌아가는 동안 에뮬레이션 엔진은 자신이 하는 일을 기록합니다. 설정을 받아들이지 못하면 멈추기 전에 오류 한 줄을 남기는데, 원인이 그 줄에 그대로 적혀 있는 경우가 많습니다. 런처도 자기 로그를 따로 남깁니다. 파일은 모두 세 개입니다.

• emulator.log: 엔진 로그입니다. 로그 창이 기본으로 여는 파일이라, 아무것도 바꾸지 않으면 이 파일을 보내게 됩니다.
• launcher.log: 업데이트를 확인할 때마다, 그리고 “Update”를 누를 때마다 날짜와 함께 한 줄씩 남습니다. 눌러도 “아무 반응이 없는” 버튼은 이 파일에서 확인합니다.
• branding.log: 드물게 필요합니다. 엔진을 설치한 뒤 엔진을 준비하는 과정이 담깁니다.

로그와 성능 리포트는 서로 다릅니다

성능 리포트는 플레이 6초를 측정합니다. 화면에 표시된 프레임, 메모리, 맥의 발열 상태입니다. 리포트는 암호화된 상태로 복사되기 때문에 직접 읽을 수 없고, 지원팀이 엽니다. 반면 로그는 무슨 일이 있었는지를 기록하고, 암호화되지 않은 텍스트로 남습니다. 보내기 전에 한 줄 한 줄 직접 읽어 볼 수 있습니다.

게임이 끊길 때는 지원팀이 둘 다 요청합니다. 게임이 실행되지 않을 때는 측정할 플레이가 없습니다. 이때 부팅 과정의 흔적은 엔진 로그에 남아 있습니다. 리포트를 만드는 법은 에뮬레이터 FPS 측정 가이드에서 설명합니다.

런처에서 로그를 찾는 곳

1. 1“Settings”를 엽니다. 런처 오른쪽 위의 톱니바퀴입니다.
2. 2“Engine and storage” 항목의 “Logs” 줄에서 “View…”를 누릅니다.
3. 3“Logs” 창이 emulator.log를 연 상태로 나타납니다. “Copy”를 누르면 텍스트가 맥 클립보드로 복사됩니다.

이 창은 파일을 실시간으로 따라갑니다. 2초마다 새로 고쳐지고(“Refreshes every 2 s”), 마지막 줄에 맞춰집니다. 중요한 것은 끝부분이고, “Copy”가 가져가는 것도 바로 파일의 끝, 마지막 200KB 정도입니다. 방금 일어난 일이 담긴 부분입니다.

창 오른쪽 위의 메뉴에서 파일을 바꿀 수 있습니다. 반응이 없는 것이 “Update” 버튼이라면, “Copy”를 누르기 전에 launcher.log를 고르세요. “Show in Finder”는 디스크에 있는 파일을 보여 주지만, “Copy”만으로 충분합니다.

“리포트 보내기”로 로그 보내기

1. 1라이선스 키 또는 이메일 주소로 고객 페이지에 로그인합니다.
2. 2“지원팀에 문의하기” 카드에서 “리포트 보내기”를 누릅니다. 대화가 열리고 “리포트 붙여넣기” 창이 나타납니다.
3. 3“로그” 칸에 Cmd+V로 로그를 붙여넣습니다. “성능 리포트” 칸은 비워 둬도 됩니다. 둘 중 하나만 있으면 됩니다.
4. 4“리포트 보내기”를 누릅니다. 채운 칸마다 .txt 파일이 되어 대화에 첨부됩니다.

이미 대화 중인가요? 같은 버튼이 메시지 아래, 클립 아이콘 옆에 아이콘으로 있습니다. 지원팀 이메일의 링크로 열리는 “티켓 확인” 페이지에도 있습니다.

로그를 메시지 입력란에 붙여넣지 마세요. 일반 메시지는 4,000자에서 끊기고, 로그는 금방 그 길이를 넘습니다. “로그” 칸은 아무것도 자르지 않고 파일로 만듭니다. 전송이 실패하면, 칸에 남아 있는 내용은 전송되지 않은 것입니다.

메시지에는 맥 사양(Apple 메뉴 > 이 Mac에 관하여)과 지금 보이는 현상을 직접 적어 주세요.

복사할 때: 문제 직후, 다시 실행하기 전에

엔진 로그는 기기가 시작될 때마다 빈 상태에서 다시 시작합니다. 그래서 문제가 생긴 뒤 기기를 다시 시작하면, 엔진이 적어 둔 내용이 오류 줄까지 지워집니다. 문제가 생기면 바로 로그를 복사하고, 그다음에 다시 실행하세요.

• 부팅 중에는 로그를 찾으려고 “Settings”를 열지 마세요. 진행 중인 실행이 끊깁니다. 오류 메시지가 뜨거나 기다리는 시간이 끝날 때까지 기다리세요. 얼마나 걸리는 것이 정상인지는 에뮬레이터가 실행되지 않을 때 가이드에 나와 있습니다.
• “Something went wrong” 창에 “The engine reported:”가 나오면, 그 줄도 그대로 메시지에 옮겨 적어 주세요. 지원팀이 찾는 것이 바로 이 줄입니다.

삭제하거나 이전 버전으로 되돌리기 전에

로그는 앱의 다른 데이터와 함께 사용자 폴더 안의 ~/Library/Application Support에 있습니다. “Uninstall”은 앱 데이터가 담긴 이 폴더를 로그까지 통째로 지웁니다. 다시 설치한 뒤에는 이전 문제에 대해 읽을 것이 아무것도 남지 않습니다. 먼저 로그를 보내 주세요. 무엇이 지워지는지는 맥 안드로이드 에뮬레이터 삭제 가이드에 자세히 나와 있습니다.

“Switch to the previous version”을 누르기 전에도 마찬가지입니다. 이전 버전으로 돌아가면, 무엇이 잘못됐는지 더 이상 측정할 수 없습니다.

맥 밖으로 나가는 것과 나가지 않는 것

로그는 직접 붙여넣을 때만 맥 밖으로 나갑니다. 런처가 스스로 보내는 것은 라이선스 확인뿐이고, 붙여넣은 내용이 곧 지원팀이 받는 내용입니다. 앱이 맥에 그 밖에 무엇을 요청하는지는 맥 안드로이드 에뮬레이터 안전성 가이드에 자세히 나와 있습니다.

자주 묻는 질문