Debugging

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

클라우드 로그 이해

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

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

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

계획 제한 및 일반적인 응답

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

`InvalidIp`

이것이 무엇을 의미하는지

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

무엇을 해야 하나요

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

`provider_infrastructure_request_blocked`

이것이 무엇을 의미하는지

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

무엇을 해야 하나요

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

`needPlanUpgrade`

이것이 무엇을 의미하는가

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

무엇을 해야 하나요

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

`noNew`

이것이 무엇을 의미하는가

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

`rateLimited`

이것이 무엇을 의미하는가

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

무엇을 해야 하나

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

버전 형식

백엔드에서 거부된 이유는 유효하지 않은 네이티브 버전 메타데이터 때문이다.

`semver_error`

이것이 무엇을 의미하는가

네이티브 앱 버전이 config에 없거나 유효하지 않은 semver (x.y.z).

업데이트를 위한 문제 해결

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

플랫폼 및 빌드 목표

disablePlatformIos

`disablePlatformIos`

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

업데이트를 위한 문제 해결

업데이트를 위한 문제 해결

iOS를 채널에 활성화하세요. 이 경우 실수로 활성화된 경우, iOS 빌드를 차단하기 위한 의도적인 경우 전용 채널로 라우팅하세요.

`disablePlatformAndroid`

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

이 기기에서는 Android가 실행되지만, 이 채널에서는 Android 업데이트가 비활성화되어 있습니다.

이것을 어떻게 처리합니까?

이것이 실수로 활성화된 경우 Android를 채널에 활성화하세요. 이 경우 의도적으로 차단하기 위한 경우 Android 빌드를 전용 채널로 라우팅하세요.

`disablePlatformElectron`

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

이 기기에서는 Electron이 실행되지만, 이 채널에서는 Electron 업데이트가 비활성화되어 있습니다.

이것을 어떻게 처리합니까?

이것이 실수로 활성화된 경우 Electron을 채널에 활성화하세요. 이 경우 의도적으로 차단하기 위한 경우 Electron 빌드를 전용 채널로 라우팅하세요.

`disableDevBuild`

이것이 무엇을 의미하는가

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

무엇을 해야 하나요?

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

`disableProdBuild`

이것이 무엇을 의미하는가

생산 버전이 호출되지만, 이 채널에서는 생산 업데이트 버전이 차단되어 있습니다. /updates무엇을 해야 하나요?

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

disableDevice

`disableDevice`

__CAPGO_KEEP_0__

실제 휴대폰이나 태블릿이 차단되었습니다. 이 채널은 실제 장치가 차단됩니다.

무엇을 할까요?

실제 장치 업데이트를 활성화하여 이는 실수로 발생한 경우, 또는 제한을 유지하고 실제 장치를 다른 채널로 라우팅하세요.

`disableEmulator`

무엇을 의미하는가?

장치는 에뮬레이터입니다. 그러나 이 채널에서는 에뮬레이터 업데이트를 차단합니다.

무엇을 할까요?

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

자동 업데이트와 호환성 규칙

백엔드 거부: semver 또는 메타데이터 규칙이 대상 패키지를 차단할 때.

`disableAutoUpdate`

업데이트 정책이란?

채널 호환성 정책으로 인해 자동 업데이트 기능이 비활성화되었습니다. 메타데이터에는 auto_update 다음 규칙과 일치하는 major, minor, patch, metadata, 또는 none.

무엇을 해야 할까요?

자신의 원하는 배포를 허용하기 위해 채널 자동 업데이트 정책을 변경하세요.

`disableAutoUpdateUnderNative`

업데이트 정책이란?

채널이 기기 기본선에 앞서 있는 버전의 패키지를 가지고 있으며, 네이티브 버전에서 업데이트를 보내지 않습니다.

무엇을 해야 할까요?

네이티브 기본선 이상의 버전의 패키지를 배포하거나, 채널에서 네이티브 보호 기능을 비활성화하세요.

`disableAutoUpdateMetadata`

이것이 무엇을 의미하는지

채널이 요구하는 것은 min_update_version, 그러나 장치의 원래 버전은 그 임계값 이하입니다.

무엇을 해야 하나요

설정 min_update_version 목표 버킷 또는 릴리스에서 최신 원본 버전으로

`disableAutoUpdateToMajor`

이것이 무엇을 의미하는지

예를 들어 채널은 메이저 버전 업데이트를 차단합니다. 1.x.x 까지 2.x.x.

무엇을 해야 하나요

채널 전략을 메이저 릴리스 계획과 일치시키거나 이 트랙에 대해 메이저 업데이트를 허용하세요. 일반 업데이트 문제.

`disableAutoUpdateToMinor`

이것이 무엇을 의미하는가

기기 기본 버전 baseline에 대한 상대적인 소수 버전跳뛰기 channel이 차단된다 (version_build), 예를 들어 1.2.3 to 1.3.0.

무엇을 해야 하나

채널 전략을 소수 버전 배포 계획과 일치시키거나 이 트랙에 대해 소수 버전跳뛰기를 허용하십시오.

`disableAutoUpdateToPatch`

이것이 무엇을 의미하는가

channel은 같은 prefix를 유지하면서 patch-level 변경을 차단하고, only suffix 변경만 허용합니다. MAJOR.MINOR.PATCH 이것이 무엇을 의미하는가

무엇을 해야 하나

이 트랙의 릴리스 일정과 채널 정책을 동기화하거나 패치 점프를 허용하십시오.

채널 설정

채널 구성이 누락되거나 불일치하여 백엔드가 거부되는 경우

`cannotUpdateViaPrivateChannel`

이것은 무슨 뜻인가

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

채널에

채널에 allow_device_self_set on을 활성화하거나 장치를 공개 또는 허용된 채널로 전환하십시오.

`channelMisconfigured`

이 무엇을 의미합니까?

채널이 사용하고 있지만 disable_auto_update: "version_number" 그러나 배포본이 min_update_version Capgo이 업데이트 할 장치들을 결정할 수 없기 때문에 null입니다.

무엇을 해야 합니까?

해당 규칙에 대한 누락된 구성 정보를 채우거나 더 간단한 자동 업데이트 모드를 전환하세요.

`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`

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

업데이터 플러그인은 버전 4입니다. 백엔드는 더 이상 이를 받아들이지 않습니다.

이것이 무엇을 의미하는지

장치의 메모리가 부족하여 다운로드가 실패했습니다.

어떻게 해야 하나요?

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

앱 상태 및 WebView 이벤트

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

`app_moved_to_background`

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

앱이 전면으로 이동했습니다.

`app_moved_to_foreground`

앱이 충돌했습니다.

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

`app_crash`

__CAPGO_KEEP_0__

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

무엇을 해야 하나요?

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

`app_crash_native`

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

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

무엇을 해야 하나요?

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

`app_anr`

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

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

무엇을 해야 하나요?

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

`app_killed_low_memory`

이것은 무슨 뜻인가요?

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

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

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

`app_killed_excessive_resource_usage`

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

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

앱 초기화 실패

앱 초기화가 실패했다.

`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 콘텐츠 프로세스가 종료되었습니다.

무엇을 해야 하나요?

SUCCESS: 번들 설치 완료
ERROR: 설치 또는 다운로드 실패
PENDING: 다운로드 완료, 출시 대기
DELETED: 번들이 삭제되었지만 통계를 위해 표시됩니다.
DOWNLOADING: 현재 번들을 다운로드 중입니다.

디바이스 로그 이해

디버그 명령

Capgo 클라우드 사용자에게는 디버그 명령어가 있습니다.

npx @capgo/cli@latest app debug

업데이트가 이루어지지 않는다면 앱 내 모든 이벤트를 확인하고 해결 방법을 찾을 수 있습니다.

iOS 원본 로그

Xcode에서 장치 로그 가져오기

Android 원본 로그

Android Studio에서 로그를 찾는 방법

로그를 Logcat로 확인하세요

네이티브 로그 구문 매핑

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

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

iOS

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

Xcode의 Window 메뉴에서 Devices and Simulators 옵션을 선택하세요 Xcode Window 메뉴에 Devices and Simulators 옵션이 표시됩니다

이 작업을 완료하려면:

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 핫 리로드

안드로이드

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

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

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

그런 다음 versions 폴더를 찾으세요. 모든 버전을 보려면

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

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

Debugging에서 계속 진행하세요.

Capgo를 사용 중이라면 Debugging 자연 플러그인 작업을 계획하고 싶다면 자연 플러그인 작업을 위해 @capgo/capacitor-업데이터를 연결하세요 자연 플러그인 작업을 위해 @capgo/capacitor-업데이터를 사용하세요 Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리를 사용하여 제품 워크플로우를 관리하세요 Capacitor Plugins by Capgo Capacitor 플러그인을 Capgo으로 관리하세요 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트에서 구현 세부 사항을 확인하세요 아이오닉 엔터프라이즈 플러그인 대체 옵션 Capgo 제품 워크플로우에 대한 Ionic Enterprise Plugin 대체 항목입니다.