에러 추적

설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설정 지시를 복사하세요.

클라우드 로그 이해:

클라우드 거부 code이 발생하고 구체적인 해결책 단계가 필요하다면, 일반적인 업데이트 문제.

Capgo 로그에는 이벤트에 대한 메타데이터가 포함될 수 있습니다. 대시보드에서 액션 필터를 사용하여 code 아래에 나열된 스네이크 케이스 액션으로 필터링하고 메타데이터 셀을 클릭하여 전체 JSON 페이로드를 복사하세요. 메타데이터는 특히 오류 메시지, 소스 URL, 라인 및 열, 프로세스 상태, 메모리 압박 또는 플랫폼별 이유와 같은 컨텍스트를 포함하는 크래시 및 WebView 이벤트에 유용합니다. 이전 로그도 여전히 레거시 camelCase 별칭을 포함하는 괄호로 표시됩니다.

백엔드에서 전송됨

code	설명
유효하지 않은 IP (__CAPGO_KEEP_0__)	__CAPGO_KEEP_0__
__CAPGO_KEEP_0__ (__CAPGO_KEEP_0____CAPGO_KEEP_0__ __CAPGO_KEEP_0__)	__CAPGO_KEEP_0__
__CAPGO_KEEP_0__ (__CAPGO_KEEP_0__)	__CAPGO_KEEP_0__
__CAPGO_KEEP_0__	__CAPGO_KEEP_0__
__CAPGO_KEEP_0__ (__CAPGO_KEEP_1__)	이 기기는 iOS 플랫폼을 사용하고 있지만 채널 설정에서 비활성화되어 있습니다.
__CAPGO_KEEP_0__ (__CAPGO_KEEP_1__)	이 기기는 안드로이드 플랫폼을 사용하고 있지만 채널 설정에서 비활성화되어 있습니다.
자동 업데이트 기능이.compatiblity 정책으로 비활성화되어 있습니다. 메타데이터는 (일치하는 규칙과 함께)	, 또는 `auto_update` native 하위에서 자동 업데이트 기능이.compatiblity 정책으로 비활성화되어 있습니다. `major`, `minor`, `patch`, `metadata`__CAPGO_KEEP_0__ `none`.
__CAPGO_KEEP_1__ (__CAPGO_KEEP_0__)	이 기기는 ( ) 버전을 사용하고, 채널은 기기 버전보다 ( ) 버전의 업데이트를 보냅니다. 하지만 채널 설정에서 업데이트를 비활성화했습니다.`1.2.3`disableAutoUpdateUnderNative`1.2.2`__CAPGO_KEEP_0__
__CAPGO_KEEP_0__ (이 기기는 개발 버전을 사용하고 있지만 채널 설정에서 개발 버전 업데이트를 비활성화했습니다.)	__CAPGO_KEEP_0__
__CAPGO_KEEP_0__ (이 기기는 에뮬레이터 버전을 사용하고 있지만 채널 설정에서 에뮬레이터 버전 업데이트를 비활성화했습니다.)	__CAPGO_KEEP_0__
__CAPGO_KEEP_0__ (__CAPGO_KEEP_0__)	배포 가능한 서명 URL을 생성하는 데 실패했습니다. 이 문제는 배포 URL 생성이 실패하거나 유효하지 않은 URL을 반환할 때 발생하며, 대체로 매니페스트가 없을 때 발생합니다.
개인 채널을 통해 업데이트할 수 없습니다. (개인 채널을 통해 업데이트할 수 없습니다.)	장치가 개인 채널과 자체 연관을 시도했지만, 채널 설정에서 장치 자체 연관을 허용하지 않았으며 (false) 채널이 공개되지 않았습니다.`allow_device_self_set` 채널이 잘못 구성되었습니다.
채널이 잘못 구성되었습니다. (버전 번호 ( )에 따라 자동 업데이트를 비활성화한 채널이지만, 업데이트를 위한 bundle의 field가 null로 설정되어, 업데이트를 받을 장치가 결정할 수 없습니다.)	버전 번호에 따라 자동 업데이트를 비활성화한 채널입니다.`disable_auto_update: 'version_number'`버전 번호에 따라 자동 업데이트를 비활성화한 채널입니다. `min_update_version` __CAPGO_KEEP_0__
__CAPGO_KEEP_0__ (__CAPGO_KEEP_0__)	버전 번호 메타데이터로 자동 업데이트가 비활성화되었습니다. 채널은 장치의 버전이 적어도 __CAPGO_KEEP_0__ 이상이어야 합니다. `min_update_version`하지만 장치의 현재 버전은 이 임계값보다 낮습니다.
주 버전 업데이트를 차단 (disableAutoUpdateToMajor)	채널 설정 `disable_auto_update: 'major'` 주 버전 업데이트를 차단하는 것과 같이 주요 버전 번호를 증가시키는 업데이트를 차단합니다. `1.x.x` from updating to `2.x.x`.
주 버전 업데이트를 차단 (주 버전 업데이트를 차단하는 것과 같이 주요 버전 번호를 증가시키는 업데이트를 차단합니다.)	채널 설정 `disable_auto_update: 'minor'` 주 버전 업데이트를 차단하는 것과 같이 주요 버전 번호를 증가시키는 업데이트를 차단합니다. `1.2.x` 부 버전 업데이트를 차단 `1.3.x`.
자동 업데이트 패치 버전 번호를 증가시키거나 동일한 메이저.마이너 버전 내에서 패치 수준 업데이트만 허용하는 설정입니다. (자동 업데이트 패치 버전 번호를 증가시키거나 동일한 메이저.마이너 버전 내에서 패치 수준 업데이트만 허용하는 설정입니다.)	채널 설정 `disable_auto_update: 'patch'` 이 설정은 패치 버전 번호를 증가시키지 않는 업데이트를 차단하거나, 동일한 메이저.마이너 버전 내에서 패치 수준 업데이트만 허용합니다.
배포 패키지 없음 (배포 패키지 없음)	assign된 채널에 다운로드 가능한 콘텐츠가 없습니다. 이는 배포 패키지가 없으며, 내장 버전이 아니며, 다운로드 가능한 매니페스트 항목이 없습니다. `external_url`배포 패키지 없음 `r2_path`배포 패키지 없음
내장 버전이 아니며, 다운로드 가능한 매니페스트 항목이 없습니다. (채널 없음)	채널 없음 또는 오버라이드 없음
__CAPGO_KEEP_0__ (__CAPGO_KEEP_0__)	요청이 과도하여 제한되었습니다.
key_id_mismatch (keyMismatch)	디바이스의 암호화 공개 키가 패키지를 암호화하기 위해 사용된 공개 키와 일치하지 않습니다. 메타데이터에는 `device_key_id`, `bundle_key_id`, 및 `version` 이 일치하지 않는 문제를 식별하는 데 도움이 됩니다.

디바이스에서 전송됨

code	설명
ping	__CAPGO_KEEP_0__
get	__CAPGO_KEEP_0__
delete	__CAPGO_KEEP_0__
set	__CAPGO_KEEP_0__
set_fail	__CAPGO_KEEP_0__
reset	__CAPGO_KEEP_0__ `builtin` 압축.
__CAPGO_KEEP_0__ 다운로드	__CAPGO_KEEP_0__ 다운로드가 완료되었습니다. 진행률은 XX% (10% 단위로 증가)로 표시됩니다.
__CAPGO_KEEP_0__ 다운로드 완료	__CAPGO_KEEP_0__ 다운로드가 완료되었습니다.
__CAPGO_KEEP_0__ 업데이트 매니페스트 다운로드 시작	__CAPGO_KEEP_0__ 업데이트 매니페스트 다운로드가 완료되었습니다.
__CAPGO_KEEP_0__ 배달 아카이브 다운로드 시작	__CAPGO_KEEP_0__ 배달 아카이브 다운로드가 완료되었습니다.
__CAPGO_KEEP_0__	__CAPGO_KEEP_0__
__CAPGO_KEEP_0__	__CAPGO_KEEP_0__
다운로드 매니페스트 파일 실패	__CAPGO_KEEP_1__ `version_name` 다운로드 매니페스트 항목이 하나 이상 실패했습니다. `version:fileName` __CAPGO_KEEP_2__
다운로드 매니페스트 항목을 pinpoint 하기 위해 사용하는 통계 payload 형식	__CAPGO_KEEP_3__
다운로드 매니페스트 항목을 pinpoint 하기 위해 사용하는 통계 payload 형식	__CAPGO_KEEP_4__
다운로드 매니페스트 항목을 pinpoint 하기 위해 사용하는 통계 payload 형식	__CAPGO_KEEP_5__
다운로드 매니페스트 항목을 pinpoint 하기 위해 사용하는 통계 payload 형식	새로운 패키지가 설치되었습니다. 그러나 호출을 실패했습니다. `notifyAppReady`.
체크섬 실패	새로운 패키지가 체크섬을 검증하지 못했습니다. 여러 가지 이유로 발생할 수 있습니다. 1) 체크섬 타입 불일치: CLI의 최신 버전과 플러그인(버전 5.10.0+, 6.25.0+ 또는 7+)은 SHA256 체크섬을 사용합니다. 그러나 이전 버전의 플러그인은 CRC32을 사용했습니다. 체크섬 실패를 보게 되면 체크섬이 CRC32(짧은 해시)인지 SHA256인지 확인하세요. 일반적으로 업로드한 CLI의 버전이 이전 버전일 때 발생합니다. Capgo 대시보드에서 업로드한 패키지의 버전을 확인하세요. 버전 5.10.0/6.25.0/7 이후에 업로드된 패키지는 SHA256을 사용합니다. CRC32 체크섬을 보게 되면 CLI이 최신 버전인지 확인하고 업그레이드하세요. CLI을 업그레이드하고 패키지를 다시 업로드하세요. 2) 암호화 키 불일치 (플러그인 버전 8.3.0 이하 또는 5/6/7.38.0): 플러그인 버전이 이전 버전일 때, 장치의 공개 키와 업로드한 패키지를 암호화한 키가 일치하지 않으면, 암호화가 실패하고 체크섬 실패를 발생시킵니다. 암호화를 사용하고 체크섬 실패를 보게 되면 __CAPGO_KEEP_4__의 공개 키가 __CAPGO_KEEP_5__에 등록된 개인 키와 일치하는지 확인하세요. 플러그인 버전을 8.3.0+ (또는 5/6/7.38.0+)로 업그레이드하면 서버에서 올바른 에러 메시지를 반환하여 이 문제를 더 쉽게 진단할 수 있습니다. `checksum_fail`__CAPGO_KEEP_6__ 경로가 유효하지 않은 윈도우 경로를 포함하고 있습니다. `capacitor.config.json` __CAPGO_KEEP_7__ 경로가 유효하지 않은 윈도우 경로를 포함하고 있습니다. `keyMismatch` __CAPGO_KEEP_8__ 경로가 유효하지 않은 윈도우 경로를 포함하고 있습니다.
__CAPGO_KEEP_9__ 경로가 유효하지 않은 윈도우 경로를 포함하고 있습니다.	__CAPGO_KEEP_10__ 경로가 유효하지 않은 윈도우 경로를 포함하고 있습니다.
canonical_path_fail	__CAPGO_KEEP_0__
directory_path_fail	__CAPGO_KEEP_0__
unzip_fail	__CAPGO_KEEP_0__
low_mem_fail	__CAPGO_KEEP_0__
app_moved_to_background	__CAPGO_KEEP_0__
app_moved_to_foreground	__CAPGO_KEEP_0__
앱 충돌	JavaScript 또는 Capacitor layer에서 충돌이 감지된 앱이 보고되었습니다. 메타데이터에는 메시지, 스택, 소스 및 활성 번들 컨텍스트가 포함될 수 있습니다.
네이티브 layer에서 플랫폼 충돌이 보고되었습니다. 메타데이터에는 플랫폼, 이유, 스택 및 프로세스 세부 정보가 포함될 수 있습니다.	Android에서 애플리케이션 응답이 없다고 보고되었습니다. 메타데이터에는 ANR 이유, 스레드 또는 트레이스 요약이 포함될 수 있습니다.
앱 프로세스는 낮은 메모리 압력을 받은 후 종료되었습니다. 메타데이터에는 사용 가능한 메모리 및 플랫폼 신호가 포함될 수 있습니다.	OS는 앱을 과도한 리소스 사용으로 인해 종료했습니다. 메타데이터에는 리소스 유형 또는 플랫폼 이유가 포함될 수 있습니다.
업데이터 또는 앱 시작 흐름이 정상 런타임이 준비되기 전에 실패했습니다. 메타데이터에는 실패한 단계 및 오류 메시지가 포함될 수 있습니다.	app_crash
app_crash_native	app_anr
app_killed_low_memory	app_killed_excessive_resource_usage
app_memory_warning	iOS에서 메모리 경고가 발생했습니다. 활성 번들 및 메모리 컨텍스트가 있을 때 메타데이터가 포함될 수 있습니다.
webview_javascript_error	웹뷰에서 미처 捕获되지 않은 자바스크립트 오류가 발생했습니다. 메시지, 소스 URL, 라인, 열, 스택이 포함된 메타데이터가 있을 수 있습니다.
webview_unhandled_rejection	웹뷰에서 미처 처리되지 않은 약속 거부가 발생했습니다. 거부 사유, 소스 URL, 스택이 포함된 메타데이터가 있을 수 있습니다.
webview_resource_error	웹뷰 리소스가 로드되지 않았습니다. URL, 상태 code, 리소스 타입, 오류 메시지 등이 포함된 메타데이터가 있을 수 있습니다.
webview_security_policy_violation	웹뷰에서 콘텐츠 보안 정책 위반 오류가 발생했습니다. 차단된 URI, 지시문, 문서 URL이 포함된 메타데이터가 있을 수 있습니다.
webview_unclean_restart	앱이 이전 웹뷰 세션이 정상적으로 종료되지 않은 것을 감지했습니다. 업데이트 후에 발생하는 충돌 루프를 식별하는 데 도움이 될 수 있습니다.
__CAPGO_KEEP_0__	Android에서 WebView 렌더링 프로세스가 종료되었습니다. 메타데이터에는 렌더링 프로세스가 충돌한지 여부와 렌더링 프로세스의 우선순위가 포함될 수 있습니다.
__CAPGO_KEEP_0__	iOS에서 WebView 콘텐츠 프로세스가 종료되었습니다. 메타데이터에는 활성 번들 및 페이지 URL이 포함될 수 있습니다.
__CAPGO_KEEP_0__	다운로드된 번들을 암호화할 수 없습니다.
__CAPGO_KEEP_0__ (__CAPGO_KEEP_0__)	__CAPGO_KEEP_0__
__CAPGO_KEEP_0__ (__CAPGO_KEEP_0__)	__CAPGO_KEEP_0__
uninstall	애플리케이션이 제거되거나 Capgo 데이터가 지워졌습니다.
blocked_by_server_url	Server.url이 capacitor 구성 파일에 있습니다. 이로 인해 Capacitor은远程 URL을 사용하고 로컬 파일을 무시합니다. 그러나 업데이터는 로컬 파일을 사용하도록 설계되어 있습니다. Server.url은 Capacitor 제작자들에 의해 프로덕션에서 나쁜 관행으로 간주되고, 많은 문제와 플러그인이 올바르게 작동하지 않는 문제를 일으킬 수 있습니다.