오류 코드
오류 팝업¶
크로스플레이 런처 작동 중 문제가 발생하면 아래 이미지와 같이 오류 코드와 함께 오류 메시지가 노출됩니다.
오류 코드¶
크로스플레이 런처 업데이트, 앱 설치와 업데이트 및 실행, 크로스플레이 런처 또는 앱 삭제 과정에서 발생하는 오류 코드입니다.
크로스플레이 런처 업데이트¶
크로스플레이 런처를 업데이트 하는 과정에서 발생하는 오류 코드입니다.
| 오류 코드 | 설명 | 비고 | 오류 문구 |
|---|---|---|---|
| 100 - 100 | 웹 스타트 commandline 파싱 오류 | 크로스플레이 런처 업데이트에 실패하였습니다. 잠시 후 다시 시도해 주세요. (오류 코드: 100 – 100) | |
| 100 - 100 - 1 | 앱 이름 및 런처 이미지 영역 데이터 획득 과정에서 예외 발생 | 크로스플레이 런처 업데이트에 실패하였습니다. 네트워크 연결을 확인해주세요. (오류 코드: 100-100-1) | |
| 100 - 100 - 2 | 앱 이름 및 런처 이미지 영역 데이터 획득 실패 | 크로스플레이 런처 업데이트에 실패하였습니다. 네트워크 연결을 확인해주세요. (오류 코드: 100-100-2) | |
| 100 - 102 - 001 | 최신 런처 버전 정보 획득 과정에서 예외 발생 | 크로스플레이 런처 업데이트에 실패하였습니다. 잠시 후 다시 시도해 주세요. (100-102-001) | |
| 100 - 102 - X | 최신 런처 버전 정보 획득 과정에서 통신 오류 발생 | X : http status code | "크로스플레이 런처 업데이트에 실패하였습니다. 잠시 후 다시 시도해 주세요. (오류 코드: 100 - 102 - X)" |
| 100 - 103 | 획득한 최신 런처 버전 정보가 빈 값으로 반환됨 | 크로스플레이 런처 업데이트에 실패하였습니다. 잠시 후 다시 시도해 주세요. (100-103) | |
| 100 - 104 - 001 | 최신 런처 파일 정보 획득 과정에서 예외 발생 | 크로스플레이 런처 업데이트에 실패하였습니다. 잠시 후 다시 시도해 주세요. (100-104) | |
| 100 - 104 - X | 최신 버전의 런처 파일 정보 획득 과정에서 통신 오류 발생 | X : http status code | 크로스플레이 런처 업데이트에 실패하였습니다. 잠시 후 다시 시도해 주세요. (100-104-x) |
| 100 - 105 - X | 파일 다운로드 IO 처리 과정에서 오류 발생 | X : 200 (open file) 201 (write file) 202 (close file) | 크로스플레이 런처 업데이트에 실패하였습니다. 잠시 후 다시 시도해 주세요. (100-105-x) |
| 100 - 106 | 파일 다운로드 timeout 발생 | 크로스플레이 런처 업데이트에 실패하였습니다. 잠시 후 다시 시도해 주세요.(100 – 106) | |
| 100 - 107 - X | 파일 다운로드 오류 발생 | X : 1 (UNSUPPORTED_PROTOCOL) 2 (FAILED_INIT) 3 (URL_MALFORMAT) 4 (UPLOAD_FAILED) 5 (READ_ERROR) 6 (UNKNOWN_ERROR) | 크로스플레이 런처 업데이트에 실패하였습니다. 잠시 후 다시 시도해 주세요.(100 – 107 – X) |
| 100 - 108 | 파일 다운로드 unknown 오류 발생 | 크로스플레이 런처 업데이트에 실패하였습니다. 잠시 후 다시 시도해 주세요(오류 코드: 100 – 108) | |
| 100 - 109 | 파일 다운로드 후 hash 체크 불일치 | 크로스플레이 런처 업데이트에 실패하였습니다. 잠시 후 다시 시도해 주세요(오류 코드: 100 – 109) | |
| 100 - 110 - 001 - X | 크로스플레이 런처의 Hive_Updater 실행 실패 | X : Windows 시스템 오류 코드 가이드 *Windows만 사용 | 크로스플레이 런처 업데이트에 실패하였습니다. 잠시 후 다시 시도해 주세요. (100 – 110 – 001 – X) |
| 100 - 110 - 002 - X | 크로스플레이 런처의 Hive_Launcher 실행 실패 | X : Windows 시스템 오류 코드 가이드 *Windows만 사용 | 크로스플레이 런처 업데이트에 실패하였습니다. 잠시 후 다시 시도해 주세요. (100 – 110 – 002 – X) |
앱 설치, 업데이트, 실행¶
크로스플레이 런처를 통해 앱을 설치하고 업데이트 및 실행하는 단계에서 발생하는 오류 코드입니다.
| 오류 코드 | 설명 | 비고 | 오류 문구 |
|---|---|---|---|
| 200 - 100 | 웹 스타트 명령줄 파싱 오류 | 크로스플레이 런처 실행에 실패하였습니다. 잠시 후 다시 시도해 주세요.(오류 코드: 200 – 100) | |
| 200 - 101 - 001 | 앱 설치 경로 선택 후 설치 경로를 설정 파일에 저장 실패 | 앱 설치에 실패하였습니다. 잠시 후 다시 시도해 주세요. (200-101-001) | |
| 200 - 101 - 002 | 앱 설치 완료 후 설정 파일에 앱 정보(예: 설치 경로, 버전 등)를 저장하지 못함 | 앱 설치에 실패하였습니다. 잠시 후 다시 시도해 주세요. (200-101-002) | |
| 200 - 101 - 003 | 앱 설치 완료 후 설정 파일에 앱 정보(예: 설치 경로, 버전 등)를 저장하지 못함 | 앱 업데이트는 업로드된 버전 순서대로 진행되고, 설정 정보는 업데이트가 성공할 때마다 목표 버전(상위 버전)의 설정 정보로 저장됩니다. 예: v1, v2, v3 순으로 버전 업로드하는 경우
| 앱 업데이트에 실패하였습니다. 잠시 후 다시 시도해 주세요. (200-101-003) |
| 200 - 102 - 001 | 앱 버전 정보 획득 과정에서 예외 발생 | 앱 정보를 확인할 수 없습니다. 잠시 후 다시 시도해 주세요.(오류 코드: 200 – 102-001) | |
| 200 - 102 - X | 앱 버전 획득 과정에서 통신 오류 발생 | X : http status code | 앱 정보를 확인할 수 없습니다. 잠시 후 다시 시도해 주세요.(200-102-x) |
| 200 - 103 - 001 | 앱 release 버전 정보 획득 과정에서 예외 발생 | 앱 정보를 확인할 수 없습니다. 잠시 후 다시 시도해 주세요.(200 – 103 – 001) | |
| 200 - 103 - X | 앱 release 버전 정보 획득 과정에서 통신 오류 발생 | X : http status code | 앱 정보를 확인할 수 없습니다. 잠시 후 다시 시도해 주세요. (200-103-x) |
| 200 - 104 - 001 | 특정 버전의 앱 파일 정보 획득 과정에서 예외 발생 | 앱 정보를 확인할 수 없습니다. 잠시 후 다시 시도해 주세요.(200 – 104 – 001) | |
| 200 - 104 - X | 특정 버전의 앱 파일 정보 획득 과정에서 통신 오류 발생 | X : http status code | 앱 정보를 확인할 수 없습니다. 잠시 후 다시 시도해 주세요. (200-104-x) |
| 200 - 105 | 앱 파일 다운로드 후 hash 체크 결과 불일치 | 앱 파일 다운로드에 실패하였습니다. 재실행 후 동일 현상이 반복될 경우 컴퓨터를 재부팅하여 다시 설치해 주세요. 문제가 해결되지 않을 경우 다른 경로에 설치해 주세요. (오류 코드: 200 – 105) | |
| 200 - 106 - X | 앱 파일 다운로드 IO 처리 과정에서 오류 발생 | X : 200 (open file) 201 (write file) 202 (close file) | 앱 파일 다운로드에 실패하였습니다. 재실행 후 동일 현상이 반복될 경우 컴퓨터를 재부팅하여 다시 설치해 주세요. 문제가 해결되지 않을 경우 다른 경로에 설치해 주세요. (오류 코드: 200 – 106 – X) |
| 200 - 107 | 파일 다운로드 timeout 발생 | 앱 파일 다운로드에 실패하였습니다. 잠시 후 다시 시도해 주세요.(200 – 107) | |
| 200 - 108 - X | 파일 다운로드 오류 발생 | X : 1 (UNSUPPORTED_PROTOCOL) 2 (FAILED_INIT) 3 (URL_MALFORMAT) 4 (UPLOAD_FAILED) 5 (READ_ERROR) 6 (UNKNOWN_ERROR) | 앱 파일 다운로드에 실패하였습니다. 잠시 후 다시 시도해 주세요.(200 – 108-X) |
| 200 - 109 | 파일 다운로드 unknown 오류 발생 | 앱 파일 다운로드에 실패하였습니다. 잠시 후 다시 시도해 주세요.(오류 코드: 200 – 109) | |
| 200 - 110 | meta.json 파일 읽기 실패 | 앱 설치 완료 후 앱 icon 파일 생성을 위한 처리 * Windows만 사용 | 앱 설정 파일을 확인할 수 없습니다. PC를 재부팅하고 제어판에서 앱을 삭제한 후 다시 설치해 주세요. (오류 코드: 200 – 110) |
| 200 - 111 - 001 | meta.json 파일 읽기 성공 후 icon 경로를 json 파싱 과정 json parsing 오류 발생 | 앱 설정 파일을 확인할 수 없습니다. PC를 재부팅하고 제어판에서 앱을 삭제한 후 다시 설치해 주세요.(오류 코드: 200 – 111 – 001) | |
| 200 - 111 - 002 | meta.json 파일 읽기 성공 후 icon 경로를 json 파싱 과정에서 오류 발생 | 앱 설정 파일을 확인할 수 없습니다. PC를 재부팅하고 제어판에서 앱을 삭제한 후 다시 설치해 주세요.(오류 코드: 200 – 111 – 002) | |
| 200 - 112 | 앱 설치 완료 후 registry 등록 처리 실패 | 제어판에 앱 이름, icon, publisher, uninstaller.exe를 등록 * Windows만 사용 | 앱 설치에 실패하였습니다. 잠시 후 다시 시도해 주세요. (200-112) |
| 200 - 113 - 001 | 앱 업데이트를 위해 패치 정보(버전 간 차이 정보) 획득 과정에서 예외 발생 | 앱 패치 정보를 확인할 수 없습니다. 잠시 후 다시 시도해 주세요.(200-113-001) | |
| 200 - 113 - X | 패치 정보(버전 간 차이 정보) 획득 과정에서 통신 오류 발생 | X : http status code | 앱 패치 정보를 확인할 수 없습니다. 잠시 후 다시 시도해 주세요.(200-113-x) |
| 200 - 114 | 사용자 PC의 현재 앱 버전이 너무 오래되어 CDN에서 조회되지 않음 | 현재 설치된 앱의 버전은 업데이트할 수 없습니다. PC를 재부팅하고 제어판에서 앱을 삭제한 후 다시 설치해 주세요. (200-114) | |
| 200 - 116 - X | 앱 파일 업데이트 과정에서 오류 발생 | 앱 업데이트에 실패했습니다. PC를 재부팅하고 제어판에서 앱을 삭제한 후 다시 설치해 주세요. (200-116-X) | |
| 200 - 117 | 앱 업데이트 후 hash 체크 결과 불일치 | 앱 업데이트에 실패했습니다. PC를 재부팅하고 제어판에서 앱을 삭제한 후 다시 설치해 주세요. (오류 코드: 200 – 117) | |
| 200 - 117-1 | 앱 파일 업데이트 후 {file name}_patched 파일에 대해 {file name} rename 실패 | 앱 업데이트에 실패했습니다. PC를 재부팅한 후에도 동일 현상이 반복될 경우 반드시 제어판에서 앱을 삭제 후 다시 설치해 주세요. (오류 코드: 200 - 117 - 1) | |
| 200 - 119 | 앱 설치에 필요한 저장 공간 부족 | 저장 공간이 부족하여 앱을 설치할 수 없습니다. (200-119) | |
| 200 - 120 | meta.json 파일 읽기 실패 | 앱 시작 버튼을 클릭한 후 앱 실행 파일 경로를 찾아 실행 | 앱을 시작할 수 없습니다. PC를 재부팅하고 제어판에서 앱을 삭제한 후 다시 설치해 주세요. (오류 코드: 200 – 120) |
| 200 - 121 | meta.json 파일 읽기 성공 후 앱 실행 파일 경로 파싱 실패 | 앱을 시작할 수 없습니다. PC를 재부팅하고 제어판에서 앱을 삭제한 후 다시 설치해 주세요. (오류 코드: 200 – 121) | |
| 200 - 122 | meta.json 파일 읽기 성공 후 앱 실행 파일 경로 획득 과정에서 예외 발생 | 앱을 시작할 수 없습니다. PC를 재부팅하고 제어판에서 앱을 삭제한 후 다시 설치해 주세요. (오류 코드: 200 – 122-x) | |
| 200 - 123 - X | 앱 실행 실패 | X : Windows 시스템 오류 코드 가이드 * Windows만 사용 | 앱을 시작할 수 없습니다. PC를 재부팅하고 제어판에서 앱을 삭제한 후 다시 설치해 주세요. (오류 코드: 200 – 123) |