가져오기 문제

증상: 가져오기를 시도할 때 게임 파일이 회색으로 표시되거나 보이지 않습니다.

원인: Spark의 파일 확장자 필터는 기본적으로 인식된 형식만 표시합니다.

해결 방법:

1. 설정 > 게임 라이브러리로 이동합니다
2. 파일 확장자 필터를 끕니다
3. 다시 가져오기를 시도합니다

이 문제는 APK 파일에서 특히 흔합니다.

증상: 가져오기가 완료된 것 같지만 라이브러리에 게임이 나타나지 않습니다.

가능한 원인:

1. 잘못된 게임 구조 — 아카이브에 유효한 Ren’Py 게임이 포함되어 있지 않음

   • 해결: 아카이브에 .rpy 또는 .rpa 파일이 있는 game/ 폴더가 포함되어 있는지 확인

2. 중첩된 디렉토리 — 게임이 아카이브 내에 너무 깊이 묻혀 있음

   • 해결: 먼저 PC에서 아카이브를 추출한 후 게임 폴더만 전송

3. 손상된 아카이브 — 파일이 손상됨

   • 해결: 아카이브를 다시 다운로드

증상: 가져오기가 다음 오류로 실패합니다: “Unable to find the ‘game’ folder. Is this a Ren’Py title? It is possible that the game was packaged in an unknown way.”

원인: Spark은 추출된 아카이브에서 Ren’Py 게임의 표준 구조인 game/ 폴더를 검색합니다. 찾지 못하면 가져오기를 계속할 수 없습니다. 다음과 같은 경우에 발생할 수 있습니다:

• 아카이브가 Ren’Py 게임이 아닌 경우
• 게임이 비표준 방식으로 패키징된 경우 (비공식 리팩, 커스텀 폴더 구조)
• 아카이브가 이중 패키징되어 Spark의 자동 감지가 내부 게임을 찾지 못한 경우

해결 방법:

1. 아카이브가 실제로 game/ 폴더가 포함된 Ren’Py 게임인지 확인합니다
2. 리패키징된 버전 대신 원래 개발자의 공식 게임 아카이브를 사용해 보세요
3. 아카이브에 유효한 Ren’Py 게임이 포함되어 있지만 Spark이 감지하지 못하는 경우 Discord 또는 이메일로 지원팀에 보고하세요

증상: 가져오기가 다음 오류로 실패합니다: “Legacy Method — Unable to find game folder.”

원인: 기본 게임 폴더 감지가 실패한 후 Spark은 추출된 아카이브 전체를 재귀적으로 검색하는 대체 레거시 스캔을 시도합니다. 이 오류는 레거시 감지도 유효한 게임을 찾지 못했음을 의미합니다.

해결 방법:

• 아카이브 구조가 호환되지 않을 가능성이 높습니다. 게임의 다른 버전 또는 플랫폼 아카이브를 시도하세요
• PC에서 아카이브를 추출하고 폴더 구조를 확인한 후 game/ 폴더가 예상 위치에 있는 표준 ZIP으로 다시 패키징하세요
• 게임 이름과 함께 지원팀에 문제를 보고하세요

증상: “Unable to determine Ren’Py Version. Aborting Launch.” 메시지 또는 엔진 버전을 지정하라는 프롬프트와 함께 게임이 실행되지 않습니다.

원인: Spark이 게임에 필요한 Ren’Py 버전을 자동으로 감지하지 못했습니다.

해결 방법: 게임 설정(게임 길게 누르기)을 열고 Ren’Py 버전 옆의 수정을 탭한 후 올바른 엔진 버전을 수동으로 선택합니다. 확실하지 않은 경우 오래된 게임에는 최신 7.x 버전을, 새로운 게임에는 최신 8.x 버전을 시도하세요.

증상: “The requested engine version was not found.” 오류로 실행이 실패합니다.

원인: 게임에 선택된 엔진 버전이 기기에서 사용할 수 없습니다.

해결 방법: 게임 설정을 열고 다른 사용 가능한 엔진 버전을 선택하세요.

증상: 예상 압축 해제 크기와 사용 가능한 공간을 보여주는 오류와 함께 가져오기가 실패합니다.

원인: 기기에 아카이브를 추출할 충분한 여유 저장 공간이 없습니다. 일반적으로 아카이브 크기의 최소 2배 (아카이브 자체 + 추출된 파일)가 필요합니다.

해결 방법: 기기의 저장 공간을 확보하고 다시 시도하세요. 저장 공간 관리자를 사용하여 제거할 수 있는 게임이나 백업을 찾으세요.

증상: “Unable to determine the uncompressed archive size. Is the archive corrupt?” 메시지와 함께 가져오기가 실패합니다.

원인: Spark이 아카이브의 메타데이터를 읽어 압축 해제 크기를 계산할 수 없었습니다. 파일이 손상되었거나 지원되지 않는 형식 변형일 수 있습니다.

해결 방법: 아카이브를 다시 다운로드하고 다시 시도하세요. 문제가 지속되면 아카이브가 비표준 형식을 사용하고 있을 수 있습니다 — 지원팀에 보고하세요.

증상: “Unable to obtain file permission from the operating system.” 메시지와 함께 가져오기가 실패합니다.

원인: iOS가 Spark에 선택한 파일에 대한 접근 권한을 부여하지 않았습니다. 특정 클라우드 저장소 제공업체나 외부 위치의 파일에서 발생할 수 있습니다.

해결 방법: 먼저 파일 앱의 나의 iPhone/iPad 섹션에 아카이브를 복사한 다음 거기서 가져오세요.

증상: 진행 표시기가 멈추거나 가져오기 중 목록에 없는 오류가 나타납니다.

해결 방법:

• 충분한 여유 저장 공간이 있는지 확인하세요 (아카이브 크기의 최소 2배)
• 매우 큰 아카이브(2 GB+)의 경우 가져오기에 수 분이 걸릴 수 있습니다 — 인내심을 가지세요
• 7z 같은 일부 아카이브 형식은 수천 개의 개별 파일이 있을 때 극도로 느릴 수 있습니다
• 오류가 지속되면 오류 메시지와 게임 이름을 포함하여 지원팀에 보고하세요

증상: APK를 가져온 후 게임에 잘못되거나 일반적인 이름이 있습니다.

원인: APK 메타데이터에서 게임 이름을 확인할 수 없었습니다.

해결 방법: 라이브러리에서 게임을 길게 누르고 수동으로 이름을 변경하세요.