이 페이지에는 일반적인 오류 코드와 오류 코드가 나타내는 내용, 앱이나 게임에서 이에 대응할 수 있는 방식이 나열되어 있습니다.
일반적인 오류 코드
다음 표에는 API가 플랫폼에서 반환할 수 있는 오류와 제안된 후속 조치가 나와 있습니다.
| 오류 코드 | 설명 | 조치 |
|---|---|---|
API_NOT_AVAILABLE |
Integrity API를 사용할 수 없습니다. Play 스토어 버전이 오래되었을 수 있고 또는 애플리케이션이 이 API를 사용하도록 설정되지 않았습니다. | 1) 앱이 API를 사용하도록 설정되었는지 확인합니다. 2) 사용자에게 Google Play 스토어를 업데이트하라고 요청합니다. |
NETWORK_ERROR |
사용 가능한 네트워크를 찾을 수 없습니다. | 사용자에게 네트워크 연결을 확인하라고 요청합니다. |
PLAY_STORE_NOT_FOUND |
기기에서 공식 Play 스토어 앱을 찾을 수 없습니다. | 사용자에게 Google Play 스토어를 설치하거나 사용 설정하라고 요청합니다. |
PLAY_STORE_VERSION_OUTDATED |
Play 스토어 앱을 업데이트해야 합니다. | 사용자에게 Google Play 스토어를 업데이트하라고 요청합니다. |
PLAY_STORE_ACCOUNT_NOT_FOUND |
기기에서 Play 스토어 계정을 찾을 수 없습니다. Play Integrity API가 이제 인증되지 않은 요청을 지원합니다. 이 오류 코드는 지원되지 않는 이전 Play 스토어 버전에만 사용됩니다. | 사용자에게 Google Play 스토어에 로그인해 달라고 요청합니다. |
CANNOT_BIND_TO_SERVICE |
Play 스토어의 서비스에 바인딩할 수 없습니다. 기기에 이전 Play 스토어 버전이 설치되어 있기 때문일 수 있습니다. | 사용자에게 Google Play 스토어를 업데이트하라고 요청합니다. |
APP_NOT_INSTALLED |
호출 앱이 설치되어 있지 않습니다. | 문제가 발생했습니다. 공격일 수 있습니다. 작업이 불가능합니다. |
PLAY_SERVICES_NOT_FOUND |
Play 서비스를 사용할 수 없거나 업데이트해야 합니다. | 사용자에게 Play 서비스를 설치하거나 사용 설정하라고 요청합니다. |
PLAY_SERVICES_VERSION_OUTDATED |
Play 서비스를 업데이트해야 합니다. | 사용자에게 Google Play 서비스를 업데이트하라고 요청합니다. |
TOO_MANY_REQUESTS |
호출 앱이 API에 너무 많은 요청을 해 제한되었습니다. | 지수 백오프로 다시 시도합니다. |
GOOGLE_SERVER_UNAVAILABLE |
알 수 없는 내부 Google 서버 오류입니다. | 지수 백오프로 다시 시도합니다. |
INTERNAL_ERROR |
알 수 없는 내부 오류입니다. | 지수 백오프로 다시 시도합니다. |
NONCE_TOO_SHORT |
nonce 길이가 너무 짧습니다. nonce는 최소 16바이트(base64 인코딩 전)여야 합니다. | 더 긴 nonce로 다시 시도합니다. |
NONCE_TOO_LONG |
nonce 길이가 너무 깁니다. nonce는 base64 인코딩 전에 500바이트 미만이어야 합니다. | 더 짧은 nonce로 다시 시도합니다. |
NONCE_IS_NOT_BASE64 |
nonce 형식이 base64, 웹 안전, 줄바꿈 없음이 아닙니다. | 정확한 nonce 형식으로 다시 시도합니다. |
CLOUD_PROJECT_NUMBER_IS_INVALID |
입력한 클라우드 프로젝트 번호가 잘못되었습니다. | Play Integrity API가 사용 설정된 클라우드 프로젝트의 클라우드 프로젝트 번호를 사용합니다. |
APP_UID_MISMATCH |
호출 앱 UID(사용자 ID)가 패키지 관리자의 UID와 일치하지 않습니다. | 문제가 발생했습니다. 공격일 수 있습니다. 작업이 불가능합니다. |
네이티브 관련 오류 코드
INTEGRITY_ 접두사는 네이티브 오류 코드 앞에 추가되어 잠재적인 이름 지정 충돌을 방지합니다. 위에 나열된 오류 코드 외에 네이티브 API에는 다음 오류 코드도 포함됩니다.
| 오류 코드 | 설명 | 조치 |
|---|---|---|
INTEGRITY_INITIALIZATION_NEEDED |
IntegrityManager가 초기화되지 않았습니다. | 먼저 IntegrityManager_init()를 호출합니다. |
INTEGRITY_INITIALIZATION_FAILED |
Integrity API를 초기화하는 중에 오류가 발생했습니다. | 지수 백오프로 다시 시도합니다. 버그 신고를 고려해보세요. |
INTEGRITY_INVALID_ARGUMENT |
잘못된 인수가 Integrity API에 전달되었습니다. | 정확한 인수로 다시 시도합니다. |