로그 뷰어

로그 뷰어에서는 게임이 오류나 충돌을 만났을 때 생성되는 Ren’Py traceback 로그를 검토할 수 있습니다.

Ren’Py 게임이 게임플레이 중 충돌하거나 Python 오류를 만나면, 엔진이 게임 디렉토리에 traceback.txt 파일을 기록합니다. 게임이 종료되면 Spark가 자동으로:

1. traceback.txt 파일을 감지합니다
2. Spark 시스템 정보(iOS 버전, Spark 버전, 엔진 버전, 게임 설정, 기기 구성)를 추가합니다
3. 파일명에 타임스탬프를 붙여 이름을 변경합니다 (예: traceback_20260311_143022.txt)
4. 게임 디렉토리 내의 logs/ 폴더로 이동합니다

각 충돌은 별도의 로그 파일을 생성하므로 게임의 오류 이력을 검토할 수 있습니다.

로그 뷰어는 게임 상세 화면에서 접근할 수 있습니다. 하나 이상의 traceback 로그가 있을 때 녹색 Logs 버튼이 나타납니다.

게임 종료 직후 traceback이 감지되면, Spark가 로그 파일을 검토할 수 있다고 알려주며 바로 볼 수 있는 옵션을 제공합니다.

로그에는 Ren’Py traceback — 게임 실행 중 발생한 문제를 설명하는 Python 오류 메시지와 스택 트레이스가 포함됩니다. 각 로그에는 끝에 추가된 Spark 시스템 정보도 포함됩니다:

• 사용된 Ren’Py 엔진 버전
• iOS 버전 및 Spark 버전/빌드 번호
• 전체 앱 및 게임 설정 구성
• 번역 설정 (활성화된 경우)
• 기기 variant 오버라이드 (설정된 경우)

로그 브라우저는 선택한 게임의 모든 저장된 traceback 파일을 최신순으로 표시합니다. 각 항목에는 파일명과 생성 날짜가 표시됩니다. 로그를 탭하면 전체 내용을 볼 수 있습니다.

로그를 볼 때 지원팀과 공유할 수 있습니다:

• 공유 버튼 — iOS 공유 시트를 열어 이메일, 클라우드 스토리지, 메시지 등 모든 앱을 통해 traceback을 내보냅니다
• 지원팀에 이메일 — traceback 파일이 첨부된 상태로 Spark 지원 이메일로 직접 로그를 전송합니다

로그 브라우저 메뉴에서 게임의 모든 로그를 삭제할 수 있습니다. 이것은 해당 게임의 전체 logs/ 폴더를 제거합니다.

지원팀에 문제를 보고할 때:

1. 게임을 실행하여 문제를 재현합니다
2. 충돌 후 게임 상세 화면에서 로그 뷰어를 엽니다
3. 가장 최근의 traceback 로그를 Discord나 이메일로 공유합니다

traceback과 추가된 시스템 정보는 지원팀이 문제를 진단하는 데 필요한 세부 정보를 제공합니다.