문제 해결
DoveRunner Mobile App Security CLI 도구 사용 중 발생하는 오류는 종료 코드로 식별됩니다. 아래 표에서 종료 코드를 확인하고 해결 절차를 따르세요. 문제가 해결되지 않으면 DoveRunner HelpDesk로 문의하세요.
종료 코드 레퍼런스
Section titled “종료 코드 레퍼런스”| 종료 코드 | 설명 | 조치 |
|---|---|---|
| 100 | CLI 도구에 전송된 매개변수 없음 | CI 설정에서 필수 매개변수가 모두 구성되어 있는지 확인하세요 |
| 101 | 구성 파일 경로 미입력 또는 해당 경로에 파일 없음 | 유효한 구성 파일 경로가 입력되었는지 확인하세요 |
| 103 | 실링 정보 검색 실패 | CLI 도구 액세스 권한을 확인하고, 문제가 지속되면 로그와 함께 HelpDesk에 문의하세요 |
| 110 | 인증 실패 또는 실링 옵션 유효성 검사 실패 | 아래 상세 내용 참고 |
| 120 | CLI 도구에 전달된 잘못된 실링 옵션 | 아래 상세 내용 참고 |
| 130 | APK/AAB 파일 업로드 실패 | srcapk 경로에 파일이 존재하고 네트워크가 연결되어 있는지 확인하세요. 재시도 동작 참고 |
| 140 | 실링 요청 실패 | 로그를 HelpDesk로 전송하세요. 재시도 동작 참고 |
| 150 | 실링 프로세스 실패 | 로그를 HelpDesk로 전송하세요. 재시도 동작 참고 |
| 160 | 실링된 APK/AAB 다운로드 실패 | 네트워크 연결을 확인하세요. 재시도 동작 참고 |
| 250 | 서버 불안정 | 5분 후 재시도하고, 문제가 지속되면 로그와 함께 HelpDesk에 문의하세요 |
110 — 인증 / 옵션 유효성 검사 실패
Section titled “110 — 인증 / 옵션 유효성 검사 실패”인증 실패 원인
Section titled “인증 실패 원인”1. authkey 미입력 또는 유효하지 않음
입력한 authkey가 계정에 발급된 키와 일치하는지 확인하세요.
2. 도구 버전 또는 해시 값이 유효하지 않음
CLI 도구가 수정되었거나 무결성 검사를 통과하지 못한 경우입니다. DoveRunner Mobile App Security 콘솔에서 공식 버전을 다운로드하여 다시 시도하세요.
3. authkey에 등록되지 않은 패키지로 실링 시도
계정에 등록된 앱 패키지만 실링할 수 있습니다. 패키지 등록을 요청한 후 진행하세요.
실링 옵션 유효성 검사 실패 원인
Section titled “실링 옵션 유효성 검사 실패 원인”1. block_environment 값 오류 — emulator, rooting만 허용됩니다.
2. allow_external_tool 값 오류 — macro, sniff만 허용됩니다.
3. deploymode 값 오류 — test, release만 허용됩니다.
4. dex_encrypt 값 오류 — yes, no만 허용됩니다.
5. app_type 값 오류 — GAME, NON_GAME만 허용됩니다.
6. 지원되지 않는 옵션 또는 오타 — 옵션명과 입력 값을 다시 확인하세요.
인증 중 네트워크 불안정
Section titled “인증 중 네트워크 불안정”CLI 도구는 10초 간격으로 최대 10회 재시도합니다. 네트워크가 안정되면 자동으로 다음 단계로 진행됩니다.
[재시도 메시지]요청을 일시적으로 완료할 수 없습니다. 다시 시도하세요... ( 1 / 10 )
[오류 메시지]유효성 검사가 실패했습니다. 실링을 다시 시도하세요. 문제가 해결되지 않으면 헬프 센터를 통해 문의하세요. [이유 : 예외 원인] (종료 코드: 110)120 — 잘못된 실링 옵션
Section titled “120 — 잘못된 실링 옵션”1. 잘못된 url
URL이 유효하지 않거나 방화벽에 의해 차단된 경우 실링을 처리할 수 없습니다. CLI 도구는 HTTPS(SSL)를 사용하므로 환경에서 HTTPS 아웃바운드 연결이 허용되어 있는지 확인하세요.
2. 잘못된 srcapk 경로
srcapk 옵션이 입력되지 않았거나, 지정된 경로에 APK/AAB 파일이 존재하지 않습니다.
3. 잘못된 sealedapk 경로
sealedapk 옵션이 입력되지 않았습니다.
네트워크 재시도 동작
Section titled “네트워크 재시도 동작”종료 코드 130, 140, 150, 160에서는 CLI 도구가 10초 간격으로 자동 재시도합니다. 130, 140, 160은 최대 10회, 150은 실링 프로세스 중 최대 40회 재시도합니다. 네트워크가 안정되면 자동으로 다음 단계로 진행됩니다.
[재시도 메시지]요청을 일시적으로 완료할 수 없습니다. 다시 시도하세요... ( 1 / 10 )재시도 횟수를 모두 소진한 후에도 네트워크가 불안정하면 다음 오류 메시지가 표시됩니다.
[종료 코드 130]APK/AAB 파일 업로드가 실패했습니다. 실링을 다시 시도하세요. 문제가 해결되지 않으면 헬프 센터를 통해 문의하세요. [이유 : 예외 원인] (종료 코드: 130)
[종료 코드 140]실링 요청이 실패했습니다. 실링을 다시 시도하세요. 문제가 해결되지 않으면 헬프 센터를 통해 문의하세요. [이유 : 예외 원인] (종료 코드: 140)
[종료 코드 150]실링 처리가 실패했습니다. 실링을 다시 시도하세요. 문제가 해결되지 않으면 헬프 센터를 통해 문의하세요. [이유 : 예외 원인] (종료 코드: 150)
[종료 코드 160]APK/AAB 파일 다운로드가 실패했습니다. 실링을 다시 시도하세요. 문제가 해결되지 않으면 헬프 센터를 통해 문의하세요. [이유 : 예외 원인] (종료 코드: 160)실링이 1시간 이상 지속되는 경우
Section titled “실링이 1시간 이상 지속되는 경우”500MB 이상의 앱은 업로드/다운로드에 추가 시간이 소요될 수 있지만, 실링 처리 자체가 1시간을 초과하는 것은 비정상 동작입니다.
조치 방법: 현재 세션은 그대로 두고, 새 세션에서 실링을 다시 시도하세요. 문제가 반복되면 실링 로그와 함께 HelpDesk에 문의하세요.
다른 계정에 등록된 앱 실링 시 실패
Section titled “다른 계정에 등록된 앱 실링 시 실패”다른 계정에 등록된 앱을 실링하려고 하면 실패합니다. 사용 중인 authkey와 앱 소유 계정이 동일한 팀 또는 조직에 속해 있는지 확인하세요.
업로드/다운로드 속도가 너무 느린 경우
Section titled “업로드/다운로드 속도가 너무 느린 경우”전송 속도가 느린 것은 실링 문제가 아닌 네트워크 환경 문제일 수 있습니다.
조치 방법:
- Wi-Fi를 사용 중이라면 유선 연결로 변경 후 다시 시도하세요.
- 여전히 느리다면 현재 접속 지역, 앱 크기, 실링 로그를 포함하여 HelpDesk에 문의하세요.
이 가이드에서 다루지 않은 오류가 발생한 경우, 실링 로그와 환경 정보를 포함하여 HelpDesk에 문의하세요.