Overview
언제 필요한가요
Primuse가 충돌하거나, 응답하지 않거나, 스캔에서 곡이 빠지거나, 음악 소스에 연결되지 않거나, 재생이 끊길 때 개발자는 문제가 생긴 순간의 기록이 필요합니다. 진단 정보는 기기에만 저장되며 자동으로 전송되지 않습니다. 직접 보낼 때만 기기 밖으로 나갑니다.
시작하기 전에
- 앱 버전 확인: 설정 → 정보에서 버전과 빌드 번호를 볼 수 있습니다. 문의할 때 함께 알려 주세요.
- 업로드하려면 인터넷 연결이 필요합니다. 기기당 하루 최대 5회, 한 번에 최대 8 MB까지 업로드할 수 있습니다.
1단계: 진단 모드 켜기(권장)
- 설정 → 정보 → ‘진단 리포트’을 엽니다.
- Mac: 설정 → 정보 → ‘진단 로그…’를 누르고, 열린 창에서 ‘진단 리포트’을 클릭합니다.
- Apple TV: 설정에서 ‘진단 리포트’을 엽니다.
- ‘상세 로그 기록’을 켭니다. 이후 24시간 동안 문제 해결에 필요한 세부 정보를 더 기록하고, 시간이 지나면 자동으로 꺼집니다.
- 문제를 다시 발생시키고(예: 다시 스캔, 그 곡을 다시 재생, 그 소스에 다시 연결) 대략적인 시각을 메모합니다.
진단 모드를 켜기 전에 일어난 일은 기본 로그에만 남아 정보가 부족할 수 있습니다. 진단 모드를 켠 상태에서 한 번 재현하는 것이 좋습니다.
2단계: 개발자에게 업로드
- ‘진단 리포트’ 화면의 도구 막대에서 ‘개발자에게 보내기’을 누릅니다.
- ‘첨부 파일(선택 사항)’에서 포함할 항목을 고릅니다: ‘진단 리포트’(충돌·멈춤 보고서, 실행 지표)과 ‘로그’.
- 필요하면 ‘이미지(선택 사항)’에 스크린샷을 추가하고(최대 6장, 자동으로 축소), ‘요청 또는 제안’에 무엇을 했는지, 무엇을 기대했는지, 실제로 무슨 일이 있었는지, 대략 몇 시였는지 적습니다.
- 아래쪽의 ‘개발자에게 업로드’을 누릅니다. ‘묶는 중…’, ‘업로드 중 …%’, ‘확인 중…’이 차례로 표시됩니다.
- ‘개발자에게 업로드했습니다’이 나타나면 ‘코드 복사’을 눌러 번호를 복사하고, GitHub나 메일로 문의할 때 함께 적어 주세요.
예상 결과: 보고서 번호가 표시됩니다. 업로드에 성공하면 업로드된 보고서와 로그는 기기에서 삭제됩니다.
Apple TV에는 시스템 충돌 보고서가 없으므로 로그와 메시지만 업로드됩니다. 번호가 표시된 뒤 ‘하나 더 보내기’으로 한 번 더 보낼 수 있습니다.
업로드할 수 없을 때: 메일 또는 공유
- 업로드 버튼 아래에 ‘대신 이메일로 보내기’ 또는 ‘대신 공유하기’이 있습니다. 메일에는 선택한 보고서나 로그가 첨부되며, 보내기 전에 직접 확인할 수 있습니다.
- 업로드 서비스를 사용할 수 없으면 업로드 버튼이 나타나지 않고, 도구 막대 버튼이 ‘메일 열기’ 또는 ‘공유’로 바뀌며 개발자의 메일 주소가 표시됩니다.
- 1.12.2 이전 버전에는 업로드 기능이 없습니다. ‘개발자에게 보내기’으로 메일 또는 공유를 이용하세요.
보고서 하나만 공유하기
‘진단 리포트’ 화면에서 보고서를 누르면 그 보고서만 공유할 수 있습니다. Mac에서는 ‘로그 내보내기’를 누르면 Finder에서 로그 파일이 표시됩니다.
옵션 설명
| 옵션 | 의미 |
|---|---|
| 충돌 및 멈춤 보고서 | 앱이 충돌하거나 오래 멈춘 뒤 시스템이 남기는 보고서. 보통 앱을 다시 연 뒤에 나타납니다 |
| 실행 지표 보고서 | 시스템이 주기적으로 제공하는 실행 데이터(최대 메모리, 종료 원인 등) |
| 로그 | 최근 재생·스캔·동기화에 대한 앱 자체 기록. 업로드·공유 시 최근 부분만 포함됩니다 |
| 상세 로그 기록 | 24시간 동안 더 자세히 기록한 뒤 자동으로 꺼집니다 |
| 로그 지우기 | 이 기기의 로그를 삭제합니다. 되돌릴 수 없습니다 |
개인정보
로그에는 곡 제목과 파일 경로가 포함되며, 음악 소스 주소와 계정은 짧은 태그로 바뀝니다. 비밀번호, 토큰 등 자격 증명은 기록 전에 제거됩니다. 업로드된 내용은 문제 해결에만 사용되며 30일 후 개발자 서버에서 삭제됩니다(서버 공간이 부족하면 더 일찍 삭제될 수 있음). 보내기 전에 ‘로그’ 선택을 해제하거나 스크린샷을 빼도 됩니다.
제한 사항
- 한 번 업로드는 패키징 후 최대 8 MB, 기기당 하루 5회이며 완료되지 않은 시도도 횟수에 포함됩니다.
- 기기에 있는 보고서와 로그는 약 7일간 보관됩니다.
- Apple TV에는 충돌·멈춤 보고서가 없고, Apple Watch에는 진단 화면이 없으므로 페어링된 iPhone에서 보내 주세요.