앱이 충돌하거나 멈추거나 실행되지 않을 때

먼저 어떤 경우인지 확인하세요

다시 사용하기

1. 앱을 완전히 종료한 뒤 다시 엽니다.
2. ‘지난 실행이 완료되지 않았습니다’이 표시되면 ‘진단 정보 복사’을 눌러 내용을 복사해 개발자에게 보냅니다. iPhone과 iPad에서는 같은 정보가 파일 앱의 Primuse → Diagnostics 폴더에도 저장됩니다. Mac에서는 ‘지난번 실행이 완료되지 않았습니다’과 ‘정보 복사’이 표시됩니다.
3. iPhone과 iPad에서 두 번 연속으로 실행이 완료되지 않으면 앱이 ‘안전 모드’로 시작하며, 홈 화면과 시작 애니메이션, 마지막 재생 복원, iCloud 동기화와 백그라운드 스캔, 전체 라이브러리 추천과 폴더 색인을 잠시 건너뜁니다. Mac에는 안전 모드가 없습니다. 먼저 진단 정보를 보낸 뒤 ‘정상 실행으로 되돌리기’을 누르면 다음 실행부터 평소처럼 홈 화면이 열립니다.
4. 특정 곡, 소스, 동작에서만 문제가 생긴다면 당분간 피하고 어떤 것인지 메모해 두세요.

정보 수집

1. 설정 → 정보 → ‘진단 리포트’을 열고 ‘상세 로그 기록’을 켭니다(소스 코드 기준 1.12.2 이상).
2. 문제가 생기는 동작을 다시 하고 대략적인 시각을 메모합니다.
3. 충돌·멈춤 보고서는 보통 앱을 다시 연 뒤에야 ‘충돌 및 멈춤 보고서’에 나타나며 시간이 걸릴 수 있습니다.
4. 진단 정보를 수집해 개발자에게 보내기에 따라 업로드하거나 보내고, 메시지에 다음을 적어 주세요.
   • 기기 모델, 시스템 버전, 앱 버전
   • 직전에 한 일, 어떤 화면이었는지, 어떤 종류의 음악 소스였는지
   • 충돌·멈춤·종료 중 어떤 것이었는지, 대략 몇 시였는지
   • 다시 재현할 수 있는지

알려진 제한

• Apple TV에는 시스템 충돌·멈춤 보고서가 없어 로그와 설명만 사용할 수 있습니다.
• Apple Watch에는 진단 화면이 없으므로 페어링된 iPhone에서 보내 주세요.
• 기기의 보고서는 약 7일간 보관되므로 빨리 보내 주세요.

관련 문서

• 진단 정보를 수집해 개발자에게 보내기
• 진단 보고서나 로그가 비어 있거나 보이지 않을 때

충돌이나 멈춤에는 여러 원인이 있습니다. 예를 들어 파일이나 음악 소스의 비정상적인 데이터, 메모리 부족으로 인한 시스템 종료, 응답하지 않는 네트워크 요청 등입니다. 충돌 보고서나 오류 한 줄은 단서일 뿐 반드시 근본 원인은 아니며, 개발자는 언제 무엇을 했는지에 대한 설명과 함께 판단해야 합니다.