Debugging

클라우드 로그 이해

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

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 사용자 액션에서만 호출하고 defaultChannel 에서 capacitor.config.

버전 형식

백엔드에서 거부된 이유는 잘못된 네이티브 버전 메타데이터 때문이다.

semver_error

이것이 무엇을 의미하는가?

네이티브 앱 버전이 config 에 없거나 semver 형식이 잘못된 경우.x.y.z).

iOS 업데이트 불가 상태에서 iOS를 지원하는 기기에서 작동하는 경우

설정 plugins.CapacitorUpdater.version 유효한 semver로 설정하고 SemVer 테스터에서 확인한 후, 네이티브 앱을 재빌드하고 재설치하세요. SemVer 테스터iOS 업데이트 불가 상태에서 iOS를 지원하는 기기를 사용하는 경우

플랫폼 및 빌드 목표

플랫폼 및 빌드 목표

disablePlatformIos

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

이 기기는 iOS를 지원하지만 이 채널에서는 iOS 업데이트 기능이 비활성화되어 있습니다.

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

iOS를 채널에 활성화하세요. 이 경우 실수로 발생한 경우, iOS 빌드를 차단할 때 의도적으로 라우팅할 때 전용 채널로 라우팅하세요.

disablePlatformAndroid

이것이 무슨 뜻인가요?

Android 업데이트가 이 채널에서 비활성화된 상태로 실행되는 기기입니다.

무엇을 해야 하나요?

Android를 채널에 활성화하세요. 이 경우 실수로 발생한 경우, Android 빌드를 차단할 때 의도적으로 라우팅할 때 전용 채널로 라우팅하세요.

disablePlatformElectron

이것이 무슨 뜻인가요?

Electron 업데이트가 이 채널에서 비활성화된 상태로 실행되는 기기입니다.

무엇을 해야 하나요?

Electron을 채널에 활성화하세요. 이 경우 실수로 발생한 경우, Electron 빌드를 차단할 때 의도적으로 라우팅할 때 전용 채널로 라우팅하세요.

disableDevBuild

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

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

무엇을 해야 합니까?

개발 버전을 허용하는 테스트 채널을 만들거나, 이 채널에서만 릴리즈를 허용하고 개발 기기를 다른 채널로 옮겨야 합니다.

disableProdBuild

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

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

무엇을 해야 합니까?

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

disableDevice

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

실제 휴대폰이나 태블릿이 차단되었습니다. 이 채널은 실제 기기를 차단합니다.

무엇을 할까요?

이것이 실수로 발생한 경우 실제 기기 업데이트를 활성화하거나, 제한을 유지하고 실제 기기를 다른 채널로 라우팅하세요.

disableEmulator

이것이 무엇을 의미하는지

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

무엇을 할까요?

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

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

Backend에서 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 에 대한 상대적인 소수 버전跳뤙을 차단합니다 (version_build) 1.2.3 예를 들어 1.3.0.

What to do

무엇을 해야 하나

disableAutoUpdateToPatch

“disableAutoUpdateToPatch”

이것이 무엇을 의미하는가 MAJOR.MINOR.PATCH 채널은 같은 접두사 prefix 에 대해 패치 수준 변경을 차단합니다. 단, 접미사 suffix 변경만 허용합니다.

무엇을 해야 하나?

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

채널 설정

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

cannotUpdateViaPrivateChannel

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

장치가 자체 할당이 허용되지 않는 비공개 채널과 자체 할당을 시도한 장치가 있습니다.allow_device_self_set 무엇을 해야 하나?

채널에

채널에 allow_device_self_set 채널에

channelMisconfigured

이러한 오류는 무엇을 의미합니까?

채널을 사용하고 있지만 disable_auto_update: "version_number" 하지만 업데이트하려는 패키지 min_update_version Capgo은 어떤 기기를 업데이트해야 하는지 결정할 수 없습니다.

어떻게 해야 합니까?

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

NoChannelOrOverride

이러한 오류는 무엇을 의미합니까?

기본 채널이 설정되지 않았으며 기기는 채널 오버라이드도 없습니다.

어떻게 해야 합니까?

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

번들 전송 및 암호화

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

cannotGetBundle

이것이 무엇을 의미하는지

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

무엇을 해야 하나요

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

missingBundle

이것이 무엇을 의미하는지

채널에 할당된 번들이 다운로드할 수 있는 콘텐츠가 없을 때 external_url업데이트 오류 r2_pathCapacitor 또는 Cloudflare의 내장 버전이 아니며, 매니페스트 항목도 없습니다.

무엇을 해야 하나요?

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

keyMismatch

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

디바이스 암호화 공개 키가 버블에 사용된 키와 일치하지 않습니다. 메타데이터에는 device_key_id, bundle_key_id업데이트 오류 version.

콘솔에서 디바이스와 버블 키 ID를 비교하세요. 동일한 키와 일치하는 __CAPGO_KEEP_0__/플러그인 버전으로 다시 게시하세요.

Compare device and bundle key IDs in the console. Publish with the same key and matching CLI/plugin versions.

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

백엔드 거부는 앱 구성 또는 업데이터 버전이 지원되지 않아 발생합니다.

customIdBlocked

이것이 무엇을 의미하는가

앱이 사용자 고유의 장치 ID를 전송했지만, 이 앱은 사용자 고유의 ID를 허용하지 않으므로, ID는 무시됩니다.

무엇을 해야 하나요

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

blocked_by_server_url

이것이 무엇을 의미하는가

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

무엇을 해야 하나요

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

backend_refusal

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

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

무엇을 해야 합니까?

플러그인과 CLI을 버전 5 이상(버전 8을 선호)으로 업그레이드하고 Capacitor 버전 5 이상으로 업그레이드한 후 빌드하고 다시 배포한 후에 빌드 메타데이터를 다시 배포하세요.

업데이트 라이프 사이클

핑

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 flow.

reset

이것이 의미하는 바

장치가 내장된 패키지로 리셋되었습니다.

delete

이것이 의미하는 바

장치에서 하나의 패키지가 삭제되었습니다.

다운로드 및 설치 실패

다운로드 진행률, 아카이브 검증 및 설치 오류에 대한 장치 측 이벤트.

download_0

이것이 의미하는 바

다운로드 시퀀스가 0% 진행률로 시작되었습니다.

download_10

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

새로운 번들이 다운로드되었습니다 — 10% 진행률이 표시됩니다.

download_20

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

새로운 번들이 다운로드되었습니다 — 20% 진행률이 표시됩니다.

download_30

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

새로운 번들이 다운로드되었습니다 — 30% 진행률이 표시됩니다.

download_40

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

새로운 패키지가 다운로드되었습니다 — 진행률 40%가 표시됩니다.

download_50

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

새로운 패키지가 다운로드되었습니다 — 진행률 50%가 표시됩니다.

download_60

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

새로운 패키지가 다운로드되었습니다 — 진행률 60%가 표시됩니다.

download_70

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

새로운 패키지가 다운로드되었습니다 — 진행률 70%가 표시됩니다.

download_80

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

새로운 패키지가 다운로드되었습니다 — 진행률이 80%로 표시됩니다.

download_90

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

새로운 패키지가 다운로드되었습니다 — 진행률이 90%로 표시됩니다.

download_complete

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

패키지 다운로드가 성공적으로 완료되었습니다.

download_manifest_start

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

디바이스가 업데이트 매니페스트 다운로드를 시작했습니다.

download_manifest_complete

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

장치가 업데이트 매니페스트를 다운로드했습니다.

download_zip_start

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

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

download_zip_complete

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

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

download_manifest_file_fail

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

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

무엇을 해야 하나?

미러링된 자산이 없거나 차단된 경우, 매니페스트를 재생성하고 번들을 다시 업로드하세요.

download_manifest_checksum_fail

무엇을 의미하는가?

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

무엇을 해야 하나?

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

download_manifest_brotli_fail

무엇을 의미하는가?

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

무엇을 해야 하나?

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

download_fail

이것이 무엇을 의미하는가

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

무엇을 해야 하나요

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

update_fail

이것이 무엇을 의미하는가

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

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

원시 로그 텍스트 notifyAppReady() after your app finishes bootstrapping. Native log text 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

이것이 무엇을 의미하는가

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

무엇을 해야 하나

Unix 경로에서 패키지를 다시 빌드하거나 업로드하기 전에 압축 파일 경로를 정리하세요.

canonical_path_fail

이것이 무엇을 의미하는가

압축 파일 내의 파일 경로는 canonical 경로가 아닙니다.

업로드하기 전에 압축 파일 경로 생성을 수정하세요.

디렉토리 경로 실패

directory_path_fail

압축 파일 내의 디렉토리 경로는 유효하지 않습니다.

압축 파일에 잘못된 폴더 경로가 포함되어 있습니다.

무엇을 해야 하나요?

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

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와 네이티브 에러 리포팅을 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 메모리 경고입니다.

무엇을 할까요?

메모리 컨텍스트를 확인하고 업데이트한 후 peak 사용량을 줄여보세요.

webview_javascript_error

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

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

무엇을 해야 하나?

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

webview_unhandled_rejection

무엇을 의미하는가?

웹뷰에서 미처리된 약속 거부.

무엇을 해야 하나?

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

webview_resource_error

무엇을 의미하는가?

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

무엇을 해야 하나?

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

webview_security_policy_violation

이것이 무엇을 의미하는지

내용 보안 정책이 리소스를 차단했습니다.

무엇을 해야 하나요

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

webview_unclean_restart

이것이 무엇을 의미하는지

이전 웹뷰 세션은 정상적으로 종료되지 않았습니다. 이는 업데이트 후에 충돌 루프가 발생할 수 있습니다.

무엇을 해야 하나요

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

webview_render_process_gone

이것이 무엇을 의미하는지

안드로이드 WebView 렌더링 프로세스가 종료되었습니다.

무엇을 해야 하나요?

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

webview_content_process_terminated

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

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

무엇을 해야 하나요?

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

환경 및 채널 컨텍스트

OS, 네이티브 버전 또는 채널 변경과 관련된 업데이트 동작을 연관시키기 위한 디바이스 측면의 컨텍스트 이벤트입니다.

os_version_changed

이것이 무엇을 의미하는가

장치 OS 버전이 체크 간에 변경되었습니다.

native_app_version_changed

이것이 무엇을 의미하는가

자연어 앱 스토어 버전이 변경되어, 자연어 앱과 웹 앱의 분리된 버전을 구별하는 데 도움이 됩니다.

getChannel

이것이 무엇을 의미하는가

장치가 현재 채널을 조회했습니다.

setChannel

이것이 무엇을 의미하는가

장치에 채널이 성공적으로 설정되었습니다.

uninstall

이것이 의미하는 바입니다.

앱이 삭제되거나 Capgo 데이터가 삭제되었습니다.

배포 상태

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

디바이스 로그 이해

디버그 명령

There is a debug command for Capgo cloud users.

npx @capgo/cli@latest app debug

This will allow you to check all events happening in the app and find a solution if updates don’t happen.

iOS 원시 로그

Xcode에서 로그 찾기

Getting the Device Log in Xcode

Android 원시 로그

Android Studio에서 로그 찾기

로그를 Logcat로 확인하세요

자연 로그 구문 매핑

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

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

iOS

iOS 장치에서 개발자 설치한 앱의 파일 시스템을 검사하는 데 Xcode의 내장 기능이 있습니다.

Xcode Window 메뉴의 Devices and Simulators 옵션

이 작업을 완료하려면:

• Mac에 장치를 연결하고 Xcode 메뉴바의 Window > Devices를 선택하세요.
• 장치 목록에서 장치를 선택하세요.
• 이 장치에 개발자로 설치한 앱 목록이 표시됩니다.
• 검사하려는 앱을 선택하고 화면 아래쪽의 3점 아이콘을 선택하세요.
• 현재 파일 시스템을 보려면 다운로드 스냅샷을 선택하세요.

다운로드 컨테이너…을 선택하면 파일 시스템의 스냅샷을 다운로드하고 .xcappdata 파일로 내보내어 브라우징할 수 있습니다.

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

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

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

library/NoCloud/ionic_built_snapshots 앱이 재부팅 된 후 필요합니다

그리고 documents/versions 핫 리로드

안드로이드

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

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

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

알고 계셨나요?

안드로이드에서는 모든 버전이 하나의 폴더에 저장되며, IOS에서는 두 개의 위치에 복제해야 합니다.

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

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

Debugging에서 계속 진행하세요.

Capgo를 사용 중이라면 Debugging 자연 플러그인 작업을 계획하고 싶다면 Capgo 업데이터 @capgo/capacitor Capgo 업데이터 @capgo/capacitor에서 사용하는 자연 플러그인 Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리에서 사용하는 제품 워크플로우 Capacitor Plugins by Capgo Capacitor 플러그인에서 Capgo 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트에서 사용하는 구현 세부 정보 Ionic Enterprise 플러그인 대체 옵션 Ionic Enterprise 플러그인 대체 제품 워크플로우에 대한 것입니다.