Debugging

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

클라우드 로그 이해

클라우드 거부 code이 발생하고 더 깊은 치유 walkthroughs가 필요하다면 code 업데이트 문제.

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

각 섹션 제목은 콘솔 로그 테이블에 표시된 액션 code과 일치하므로 직접 링크할 수 있습니다.

계획 제한 및 일반 응답

결제, 속도 제한, 오류가 아닌 상태와 관련된 백엔드 거부.

`InvalidIp`

이것이 무엇을 의미하는가

Capgo는 Google 또는 클라우드 인프라에서처럼 보이는 트래픽이 감지되었습니다. 4시간 이내의 업데이트는 계정 요금에 포함되지 않도록 하기 위해 봇 트래픽이 계정 장치로 계산되지 않도록 합니다.

무엇을 해야 하나요

실제 사용자에게는 무시하세요. 일반 네트워크와 실제 장치에서 다시 시도하거나 나중에 다시 확인하세요.

`provider_infrastructure_request_blocked`

이것이 무엇을 의미하는가

앱이 Google 및 Apple 데이터 센터 IP 범위에서 요청을 차단하도록 구성되어 있습니다. 보호는 업데이트를 확인하는 것, 통계, 채널-self 요청에 적용되므로 클라우드 호스팅된 프로브 및 제공자 러너도 이 응답을 받을 수 있습니다. 앱 구성이 그렇지 않으면 유효한 경우에도.

무엇을 해야 하나요

물리적 장치에서 일반 사용자 네트워크에서 다시 시도하세요. 제공자에서 유도된 트래픽이 의도적일 경우 일시적으로 차단 Block provider infrastructure requests 앱 내의 정보 탭에서 활성화 한 후 테스트 후 다시 활성화하십시오. 새로운 앱은 이 설정을 기본적으로 활성화하고 있으며 기존 앱은 이전에 비활성화된 설정을 유지합니다.

`needPlanUpgrade`

이것이 무엇을 의미하는가

당신의 조직이 플랜 또는 장치 제한을 초과했습니다. 장치는 업그레이드하거나 다음 청구 주기가 사용량을 초기화할 때까지 업데이트를 받지 못합니다.

무엇을 해야 하나요

플랜을 업그레이드하거나 다음 청구 주기를 기다리십시오.

`noNew`

이것이 무엇을 의미하는가

이 장치는 최신 버전의 채널에 대한 버블을 이미 가지고 있습니다. 이것은 실패가 아닌 일반적인 상태입니다.

`rateLimited`

무엇을 의미하는가

장치가 짧은 시간 내에 너무 많은 업데이트나 채널 요청을 보냈다.

무엇을 해야 하나

업데이트 API를 렌더 루프 내에서 호출하지 말라. 사용자 액션에서만 호출하고 setChannel / getChannel in defaultChannel 버전 형식 capacitor.config.

버전 형식 섹션

semver_error 섹션

`semver_error`

config 내의 native 앱 버전이 없거나 유효하지 않은 semver이다.

업데이트 API를 렌더 루프 내에서 호출하지 말라. 사용자 액션에서만 호출하고x.y.z).

업데이트를 위한 문제 해결

설정 plugins.CapacitorUpdater.version 유효한 semver로 설정하고 SemVer 테스터에서 확인한 후, 네이티브 앱을 재빌드하고 재설치하세요. SemVer 테스터플랫폼 및 빌드 목표

플랫폼 및 빌드 목표

disablePlatformIos

`disablePlatformIos`

이 장치는 iOS를 실행하지만 이 채널에서 iOS 업데이트를 차단했습니다.

문제 해결 방법

What to do

iOS를 채널에 활성화하세요. 이 경우 실수로 iOS를 활성화한 경우, iOS 빌드를 차단하는 경우 전용 채널로 라우팅하세요.

`disablePlatformAndroid`

이것이 무슨 뜻인가요?

이 기기는 Android를 실행하지만, 이 채널에서 Android 업데이트를 비활성화했습니다.

이것을 어떻게 해야 하나요?

iOS를 채널에 활성화하세요. 이 경우 실수로 iOS를 활성화한 경우, iOS 빌드를 차단하는 경우 전용 채널로 라우팅하세요.

`disablePlatformElectron`

이것이 무슨 뜻인가요?

이 기기는 Electron을 실행하지만, 이 채널에서 Electron 업데이트를 비활성화했습니다.

이것을 어떻게 해야 하나요?

Electron을 채널에 활성화하세요. 이 경우 실수로 Electron을 활성화한 경우, Electron 빌드를 차단하는 경우 전용 채널로 라우팅하세요.

`disableDevBuild`

이것이 무엇을 의미하는가

이 장치는 개발 버전입니다. 그러나 이 채널에서는 개발 버전이 차단되어 있습니다.

무엇을 해야 하나요

개발 버전을 허용하는 테스트 채널을 만들거나, 이 채널에서만 릴리즈를 허용하고 개발 장치를 다른 채널로 이동하세요.

`disableProdBuild`

이것이 무엇을 의미하는가

생산 버전이 호출되지만 /updates, 그러나 이 채널에서는 생산 업데이트에 차단되어 있습니다.

무엇을 해야 하나요

이것이 실수로 발생한 경우에 채널에서 생산 업데이트 허용하거나, 생산 빌드를 올바른 채널로 라우팅하세요.

`disableDevice`

이것이 무엇을 의미하는가

A real phone or tablet was blocked because this channel blocks real devices.

무엇을 할까요?

실제 기기 업데이트를 허용하거나 제한을 유지하고 다른 채널을 통해 실제 기기를 라우팅하세요.

`disableEmulator`

무엇을 의미하는 것인가요?

이 채널에서는 에뮬레이터 업데이트를 비활성화했으며 에뮬레이터는 실제 기기입니다.

무엇을 할까요?

테스트 채널에서 에뮬레이터 업데이트를 활성화하거나 에뮬레이터를 차단한 채널을 유지하고 다른 채널을 통해 에뮬레이터 검증을 사용하세요.

자동 업데이트 호환성 규칙

이 트랙의 릴리스 주기는 채널 정책과 일치하거나 패치 점프를 허용해야 합니다.

채널 설정

데이터 전송이 실패하는 이유

`cannotUpdateViaPrivateChannel`

무엇을 의미하는가

장치가 비공개 채널에 장치 자체 할당을 허용하지 않는 채널에 자체적으로 연결하려고 시도했으며 채널이 공개되지 않았습니다.allow_device_self_set 무엇을 해야 하나?

채널 설정

켜기 allow_device_self_set 채널에 켜거나 장치를 공개 또는 허용된 채널으로 전환하십시오.

`channelMisconfigured`

이것이 무슨 뜻인가요?

채널은 disable_auto_update: "version_number" 그러나 min_update_version 이 값이 null이므로 Capgo은 어떤 기기들이 업데이트해야 하는지 결정할 수 없습니다.

이러한 문제를 해결하는 방법은?

미비한 설정을 채우거나 더 간단한 자동 업데이트 모드를 사용하세요.

`NoChannelOrOverride`

이것이 무슨 뜻인가요?

기본 채널이 설정되어 있지 않고 기기에는 채널 오버라이드가 없습니다.

이러한 문제를 해결하는 방법은?

대시보드에서 기본 채널을 설정하거나 defaultChannel 빌드 중입니다.

번들 전송 및 암호화

Capgo이 번들을 제공하거나 암호화할 수 없을 때 백엔드 거부

`cannotGetBundle`

이것은 무엇을 의미합니까?

Capgo이 유효한 서명된 다운로드 URL을 생성하지 못했으며 매니페스트 대체가 사용할 수 없었다.

무엇을 해야 합니까?

번들을 다시 업로드하고 매니페스트를 재생성하고 R2 또는 공개 번들을 확인하세요.

`missingBundle`

이것은 무엇을 의미합니까?

할당된 채널에 다운로드할 수 있는 콘텐츠가 없는 번들이 있습니다. external_url아니요 r2_path내장 버전이 아니며, 매니페스트 항목도 없습니다.

무엇을 해야 하나요

버전을 다시 빌드하고 업로드한 후, 실제 파일 내용이 있는 번들을 확인하세요.

`keyMismatch`

무엇을 의미하는가요

디바이스 암호화 공개 키가 번들의 암호화 키와 일치하지 않습니다. 메타데이터는 device_key_id, bundle_key_id그리고 version.

무엇을 해야 하나요

콘솔에서 디바이스와 번들의 키 ID를 비교하세요. 동일한 키와 일치하는 CLI/플러그인 버전으로 공개하세요.

앱 구성 및 레거시 클라이언트

애플리케이션 구성 또는 업데이터 버전이 지원되지 않아 백엔드 거부가 발생했습니다.

`customIdBlocked`

이것은 무엇을 의미합니까?

앱이 사용자 지정 장치 ID를 보내지만 이 앱은 사용자 지정 ID를 허용하지 않으므로 ID는 무시됩니다.

무엇을 해야 합니까?

사용자 지정 ID를 보내지 마세요. 또는 사용자 지정 ID를 허용할 때만 워크플로우가 필요합니다.

`blocked_by_server_url`

이것은 무엇을 의미합니까?

server.url Capacitor config에서 Capgo로 설정되어 WebView는 로컬 번들 파일 대신远程 URL을로드합니다. Capgo live updates는 로컬 파일이 필요하고 server.url 이것은 프로덕션에서 비추천됩니다.

무엇을 해야 합니까?

제거하거나 클리어하세요. server.url 생산 빌드와 업데이트 패키지를 로컬에 유지하세요. 이 code는 백엔드 거부 또는 장치 측면 통계로 나타날 수 있습니다.

`backend_refusal`

What it means

업데이터 플러그인은 버전 4로, 백엔드가 더 이상 이를 수락하지 않습니다.

What to do

플러그인과 CLI을 v5 이상(권장 v8)으로 업그레이드하고 Capacitor v5 이상으로 업그레이드한 후 다시 빌드하고 배포 메타데이터를 다시 게시하세요.

업데이트 라이프 사이클

ping

`ping`

내부 테스트 액션으로 통계 pipeline을 확인하기 위해 사용됩니다.

업데이트 라이프 사이클

`get`

What it means

Capgo은 새로운 버전의 다운로드 정보를 기기에 전송했습니다.

`set`

What it means

기기에 패키지가 활성화되었습니다.

`set_fail`

What it means

기기에 패키지가 활성화되지 않았습니다.

What to do

기기 내 네이티브 로그를 확인하고 npx @capgo/cli@latest app debug 패키지의完整성, 경로 및 notifyAppReady __CAPGO_KEEP_0__.

`reset`

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__ 기기에서 기본 구성 요소로 초기화되었습니다.

`delete`

__CAPGO_KEEP_0__

이것은 무엇을 의미합니까?

장치가 버전 아카이브를 다운로드했습니다.

`download_manifest_file_fail`

이것은 무엇을 의미합니까?

한 매니페스트 항목이 다운로드되지 않았습니다. version_name 사용 version:fileName 자산을 식별하기 위해 사용됩니다.

무엇을 해야 하나요?

자산이 누락되거나 차단된 경우 자산을 다시 생성하고 번들을 다시 업로드하세요.

`download_manifest_checksum_fail`

이것은 무엇을 의미합니까?

매니페스트 파일이 체크섬 검증에서 실패했습니다.

무엇을 해야 하나요?

현재 CLI 버전의 번들을 다시 업로드하고 매니페스트 체크섬을 확인하세요.

`download_manifest_brotli_fail`

이것은 무엇을 의미합니까?

매니페스트 파일이 브로틀리 압축 해제에서 실패했습니다.

압축 설정을 확인하고 영향을 받은 자산을 다시 업로드하세요.

Section titled “download_manifest_checksum_fail”

`download_fail`

무슨 뜻인가

배포 패키지가 다운로드되지 않았습니다.

무엇을 해야 하나

네트워크 연결성, 서명 URL 만료, CDN 접근성 및 장치 저장소 확인

`update_fail`

무슨 뜻인가

배포 패키지가 설치되었지만 앱이 __CAPGO_KEEP_0__을 호출하지 않았습니다. notifyAppReady, so Capgo rolled back.

앱이 부트스트래핑을 마치면 호출하세요.

자연 로그 텍스트 notifyAppReady() context notifyAppReady was not called, roll back current bundle 이것은 code에 매핑됩니다.

`checksum_fail`

이것이 무엇을 의미하는지

다운로드 한 패키지가 체크섬 검증을 실패했습니다. 일반적인 원인: CRC32 vs SHA256 불일치가 오래된 CLI 업로드에서 발생하거나, 암호화 키 불일치가 암호화 실패를 체크섬 실패로 표출하는 오래된 플러그인에서 발생합니다.

무엇을 해야 하나요

현재 CLI/플러그인 (SHA256)으로 재업로드하세요. 암호화를 사용하는 경우, 앱 공개 키가 업로드 키와 일치하는지 확인하거나, 플러그인 8.3.0 이상으로 업그레이드하여 명시적인 keyMismatch 오류를 확인하세요.

`decrypt_fail`

이것이 무엇을 의미하는지

다운로드 한 패키지가 암호화에 실패했습니다.

무엇을 해야 하나요

암호화 키를 확인하고, 일치하는 키 pair와 함께 재업로드 하세요.

`windows_path_fail`

What it means

zip 파일에 윈도우 스타일 경로가 포함되어 있습니다.

What to do

Unix 경로에서 번들을 다시 빌드하거나 업로드하기 전에 아카이브 경로를 정리하세요.

`canonical_path_fail`

What it means

zip 파일 내의 파일 경로가 canonical 경로가 아닙니다.

What to do

업로드하기 전에 아카이브 경로 생성을 수정하세요.

`directory_path_fail`

What it means

압축 파일에 잘못된 디렉토리 경로가 포함되어 있습니다.

무엇을 해야 하나요?

업로드하기 전에 압축 구조를 수정하세요.

`unzip_fail`

무엇을 의미하는 것인가요?

다운로드한 패키지를 압축해제하는 데 장치가 실패했습니다.

무엇을 해야 하나요?

압축의 무결성과 지원되는 압축 알고리즘을 확인하세요.

`low_mem_fail`

무엇을 해야 하나요?

장치의 메모리가 부족하여 다운로드가 실패한 경우입니다.

무엇을 해야 하나요?

배포 패키지 크기를 줄이거나 더 많은 무료 메모리가 있는 기기에서 다시 시도하세요.

앱 상태 및 WebView 이벤트

기기 내의 충돌, 메모리 및 WebView 디버깅. 항상 대시보드에서 메타데이터 JSON을 검사하세요.

`app_moved_to_background`

이것은 무엇을 의미합니까?

앱이 전면에 이동했습니다.

`app_moved_to_foreground`

앱이 충돌했습니다.

이것은 무엇을 의미합니까?

`app_crash`

__CAPGO_KEEP_0__

JavaScript 또는 Capacitor layer 충돌. 메타데이터는 메시지, 스택, 소스 및 활성 번들 컨텍스트를 포함할 수 있습니다.

무엇을 해야 하나요?

메타데이터와 네이티브 로그를 검사하십시오. JS와 네이티브 에러 리포팅 (예를 들어 Sentry)을 pair하여 실패하는 code 경로를 찾으십시오.

`app_crash_native`

무엇을 의미하는가?

네이티브 플랫폼 크래시. 메타데이터는 플랫폼, 이유, 스택 및 프로세스 세부 정보를 포함할 수 있습니다.

무엇을 해야 하나요?

Xcode 또는 Logcat 크래시 로그를 사용하고 메타데이터의 활성 번들과 관련시켜보십시오.

`app_anr`

무엇을 의미하는가?

Android 애플리케이션 응답이 없습니다.

무엇을 해야 하나요?

업데이트 후 메인 스레드 블록킹 작업을 줄이고 Logcat에서 ANR 트레이스 검사하세요.

`app_killed_low_memory`

이것은 무슨 뜻인가요?

메모리 부족으로 앱이 죽었다는 것은?

업데이트 활성화 후 메모리 사용량을 줄이고 사용 가능한 메모리 신호를 검사하는 메타데이터를 확인하세요.

리소스 사용이 과도하여 OS가 앱을 죽였다.

`app_killed_excessive_resource_usage`

리소스 사용이 과도하여 OS가 앱을 죽였다는 것은?

리소스 타입 또는 플랫폼 이유를 검사하는 메타데이터를 확인하세요.

초기화 실패로 OS가 앱을 죽였다.

Section titled “app_initialization_failure”

`app_initialization_failure`

업데이터 또는 시작이 정상 실행 준비가 될 때까지 실패했습니다.

업데이터 또는 시작이 정상 실행 준비가 될 때까지 실패했습니다.

무엇을 할까요?

실패한 단계와 오류 메시지를 확인하는 메타데이터를 검사하십시오.

`app_memory_warning`

무엇을 의미합니까?

iOS 메모리 경고입니다.

무엇을 할까요?

메타데이터의 메모리 컨텍스트를 검사하고 업데이트 후 최대 사용량을 줄이십시오.

`webview_javascript_error`

무엇을 의미합니까?

웹뷰 내에서 발생한 未처리 자바스크립트 오류입니다. 메타데이터에는 오류 메시지, 소스 URL, 라인, 열, 스택이 포함될 수 있습니다.

무엇을 해야 하나

JS 및 네이티브层에서 정확한 실패 라인을 캡처하기 위해 프로덕션에서 오류 보고를 설치하세요.

`webview_unhandled_rejection`

이것이 무엇을 의미하는지

웹뷰 내에서 미처리된 약속 거부입니다.

무엇을 해야 하나

JS 및 네이티브 오류 보고를 사용하여 비동기 실패를 캡처하세요.

`webview_resource_error`

이것이 무엇을 의미하는지

웹뷰 리소스가 로드되지 않았습니다.

무엇을 해야 하나

브로KEN 자산이나 네트워크 규칙을 고치기 위해 메타데이터 URL 및 상태 세부 정보를 사용하세요.

`webview_security_policy_violation`

이것이 무엇을 의미하는가

콘텐츠 보안 정책이 리소스를 차단했습니다.

무엇을 해야 하나요

메타데이터 지시문과 차단 URI 정보를 사용하여 CSP를 조정하세요.

`webview_unclean_restart`

이것이 무엇을 의미하는가

이전 웹뷰 세션은 업데이트 후에 충돌 루프를 나타낼 수 있는 깨끗하게 종료되지 않았습니다.

무엇을 해야 하나요

재시작 전후에 충돌 및 웹뷰 오류 이벤트를 상관관계로 하세요.

`webview_render_process_gone`

이것이 무엇을 의미하는가

Android WebView 렌더러 프로세스가 종료되었습니다.

어떻게 해야 하나요?

메타데이터와 네이티브 로그에서 렌더러 충돌 신호를 검사하세요.

`webview_content_process_terminated`

무엇을 의미하는가

iOS WebView 콘텐츠 프로세스가 종료되었습니다.

어떻게 해야 하나요?

메타데이터에서 활성 번들 및 페이지 URL을 검사하세요.

SUCCESS: 배포 완료
ERROR: 배포 또는 다운로드 실패
PENDING: 다운로드 완료, 출시 대기
DELETED: 배포 삭제, 통계를 위해 표시
DOWNLOADING: 현재 배포 다운로드 중

디바이스 로그 이해

디버그 명령

Capgo 클라우드 사용자는 debug 명령어를 사용할 수 있습니다.

npx @capgo/cli@latest app debug

업데이트가 이루어지지 않는 경우에 발생하는 모든 이벤트를 확인하고 해결할 수 있도록 도와줍니다.

iOS 원본 로그

Xcode에서 로그를 찾는 방법

Android 원본 로그

__CAPGO_KEEP_0__

로그를 Logcat으로 확인하세요

자연어 로그 구문 매핑

Failed to download from 으로 매핑됩니다 download_fail
notifyAppReady was not called, roll back current bundle 으로 매핑됩니다 update_fail

장치에서 다운로드 한 패키지를 찾는 방법

iOS

Xcode는 iOS 장치에 개발자로 설치된 앱의 파일 시스템을 검사하는 내장 기능을 제공합니다.

Xcode 창 메뉴에서 장치 및 시뮬레이터 옵션을 선택하세요 __CAPGO_KEEP_0__

이 작업을 완료하려면:

Mac에 장치가 연결되어 있고 Xcode 메뉴바의 Window > Devices를 선택하세요.
장치 목록에서 장치를 선택하세요.
이 장치에 개발자에 의해 설치된 앱 목록이 표시됩니다.
검토하고자 하는 앱을 선택하고 화면 하단의 3점 아이콘을 선택하세요.
다운로드한 스냅샷을 선택하여 현재 파일 시스템을 확인할 수 있습니다.

Xcode Devices 패널에 앱 컨테이너 다운로드 옵션 표시

다운로드 컨테이너…를 선택하면 파일 시스템의 스냅샷을 .xcappdata 파일로 다운로드하고 내보내며, 이를 통해 폴더를 탐색할 수 있습니다.

다운로드한 xcappdata 파일에 Show Package Contents 컨텍스트 메뉴를 선택하세요.

이 파일을 오른쪽 클릭하고 Show Package Contents를 선택하여 폴더를 열어보세요.

App Data 폴더를 열면 문서, 라이브러리, tmp 등 몇 개의 폴더를 볼 수 있습니다.

iOS 앱 컨테이너 폴더 구조에 문서 및 라이브러리 폴더 표시

그런 다음 2개의 폴더에서 버전을 찾을 수 있습니다:

library/NoCloud/ionic_built_snapshots 앱이 재시작된 후 필요합니다

그리고 documents/versions 핫 리로드

안드로이드

안드로이드에서 디버깅하려면 안드로이드 스튜디오에서 장치에 접근해야 합니다:

보기 > 도구 창 > 장치 파일 탐색기 또는 도구 창 바의 장치 파일 탐색기 버튼을 클릭하여 장치 파일 탐색기를 열어보세요.
드롭다운 목록에서 장치를 선택하세요.
경로를 열어보세요 data/data/APP_NAME/ 그곳에서 APP_NAME은 앱 ID입니다.

Android Studio Device File Explorer에서 앱 데이터 디렉토리를 보여줍니다.

그 다음 versions 폴더를 찾으세요. 모든 버전을 볼 수 있습니다.

IOS 프로덕션 크래시 로그를 이해하는 방법

앱의 크래시 로그를 검토하는 방법

Debugging에서 계속 진행하세요.

만약에 당신이 Debugging 을 사용하여 Using @capgo/capacitor-updater Using @capgo/capacitor-updater Capgo Plugin Directory Using @Capgo/__CAPGO_KEEP_1__-updater Capacitor Plugins by Capgo for the implementation detail in Capacitor Plugins by Capgo, 에서 __CAPGO_KEEP_0__ 플러그인 디렉토리 에서 제품 워크플로우를 확인하세요. Ionic Enterprise 플러그인 대체품의 제품 워크플로우에 대해.