Skip to content

디버깅

GitHub

클라우드 로그를 이해하는 방법

클라우드 로그 이해하기

클라우드 거부를 받았습니다 code deeper remediation walkthroughs가 필요합니다. 클라우드 거부 문제.

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

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

제한 및 일반 응답

제한 및 일반 응답 섹션

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

이것이 무엇을 의미하는지

Capgo은 Google 또는 클라우드 인프라에서처럼 보이는 트래픽이 감지되었습니다. 업데이트 시간이 4시간 미만인 경우 봇 트래픽이 계량 가능한 장치로 계산되지 않도록 업데이트를 무시합니다.

무엇을 해야 하나요

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

needPlanUpgrade

needPlanUpgrade 섹션

이것이 무엇을 의미하는지

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

무엇을 해야 하나요

대시보드에서 계획을 업그레이드하거나 다음 청구 주기까지 기다려보세요.

noNew

noNew

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

기기에 최신 채널 버전이 이미 설치되어 있습니다. 이것은 실패가 아닌 정상적인 상태입니다.

rateLimited

rateLimited

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

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

무엇을 해야 합니까?

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

버전 형식

버전 형식

잘못된 네이티브 버전 메타데이터로 인한 백엔드 거부

이것이 무엇을 의미하는지

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

무엇을 해야 하나요

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

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__

채널 정책이 플랫폼, 빌드 유형, 또는 장치 클래스를 차단할 때 백엔드 거부

이것이 무엇을 의미하는가

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

무엇을 해야 하나요

이것이 의도치 않게 발생한 경우 채널에서 iOS를 활성화하거나, 의도적으로 차단하는 경우 iOS 빌드를 전용 채널로 라우팅하세요.

이것이 무엇을 의미하는가

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

무엇을 해야 하나요

이것이 의도치 않게 발생한 경우 채널에서 Android를 활성화하거나, 의도적으로 차단하는 경우 Android 빌드를 전용 채널로 라우팅하세요.

이것이 무엇을 의미하는가

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

무엇을 해야 하나요

이것이 우연의 결과라면 채널에서 Electron을 활성화하거나, 의도적으로 차단하는 경우 Electron 빌드를 전용 채널로 라우팅하세요.

disableDevBuild

disableDevBuild 섹션

이것이 무엇을 의미하는가

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

무엇을 해야 하나요

테스트 채널에서 개발 버전을 허용하거나, 이 채널은 릴리스 전용으로 유지하고 개발 기기를 다른 곳으로 옮기세요.

disableProdBuild

disableProdBuild 섹션

이것이 무엇을 의미하는가

생산 버전을 호출하는 /updates, 그러나 프로덕션 업데이트가 이 채널에 의해 차단되었습니다.

무엇을 해야 하나요

이것이 실수로 이루어졌다면, 프로덕션 업데이트를 채널에 허용하거나, 또는 프로덕션 빌드를 올바른 채널로 라우팅하세요.

무엇을 의미하는가

실제 휴대폰이나 태블릿이 차단되었습니다. 이는 채널이 실제 장치를 차단하기 때문입니다.

무엇을 해야 하나요

이것이 실수로 이루어졌다면, 실제 장치 업데이트를 허용하거나, 또는 제한을 유지하고 실제 장치를 다른 채널로 라우팅하세요.

무엇을 의미하는가

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

무엇을 해야 하나요

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

자동 업데이트 호환성 규칙

자동 업데이트 호환성 규칙

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

이것이 무엇을 의미하는지

자동 업데이트 정책에 의해 채널 호환성 정책으로 차단됩니다. 메타데이터는 auto_update 일치하는 규칙과 같이 major, minor, patch, metadata또는 none.

무엇을 해야 하나요

채널 자동 업데이트 정책을 변경하여 원하는 롤아웃을 허용하세요.

disableAutoUpdateUnderNative

자동 업데이트 차단(원시 앱)

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

채널은 기기 기본선에 앞서 있는 번들을 가지고 있으며, 네이티브 버전 아래에서 업데이트를 보내지 않습니다.

무엇을 해야 합니까?

네이티브 기본선 이상의 번들을 배포하거나, 채널에서 네이티브 아래 보호를 비활성화하세요.

disableAutoUpdateMetadata

disableAutoUpdateMetadata 제목

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

채널은 min_update_version를 요구하지만, 기기 네이티브 버전은 그阈값보다 낮습니다.

무엇을 해야 합니까?

기기 네이티브 버전이 더 높은 버전의 min_update_version 를 설정하세요.

disableAutoUpdateToMajor

disableAutoUpdateToMajor 제목

What it means

major 버전 업데이트를 차단합니다. 예를 들어 1.x.x to 2.x.x.

What to do

major 버전 업데이트와 함께 주요 릴리즈 계획을 맞춰주거나, 이 트랙에 대해 major 업데이트를 허용하세요. See Common Update Problems.

What it means

major 버전 업데이트를 차단합니다. 예를 들어version_buildto 1.2.3 What to do 1.3.0.

Capgo는 기기 기본 버전 기준으로 minor 버전 업데이트를 차단합니다. 예를 들어

__CAPGO_KEEP_0__의 채널 전략을 이 트랙의 소규모 배포 계획과 일치시키거나, 이 트랙에 대해 소규모 점프를 허용하세요.

이것이 무엇을 의미하는가

채널은 패치 수준의 변경을 차단하면서 동일한 MAJOR.MINOR.PATCH __CAPGO_KEEP_0__ 접두사; 접미사만 변경이 허용됩니다.

이것을 어떻게 해야 하나요

__CAPGO_KEEP_0__의 릴리스 주기와 채널 정책을 일치시키거나, 이 트랙에 대해 패치 점프를 허용하세요.

백엔드에서 채널 구성이 누락되거나 호환되지 않아 업데이트를 거부하는 경우.

이것이 무엇을 의미하는가

__CAPGO_KEEP_0__allow_device_self_set __CAPGO_KEEP_0__

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__ allow_device_self_set __CAPGO_KEEP_0__

channelMisconfigured

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__ disable_auto_update: "version_number" __CAPGO_KEEP_0__ min_update_version Capgo

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__

NoChannelOrOverride

NoChannelOrOverride

이란 무엇인가요?

기본 채널이 설정되지 않았으며 장치에 채널 오버라이드가 없습니다.

무엇을 해야 하나요?

대시보드에서 기본 채널을 설정하거나 빌드에서 채널을 구성하세요. defaultChannel Bundle 배송 및 암호화

Backend refusals when Capgo cannot serve or decrypt the bundle.

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

Capgo failed to generate a valid signed download URL and no manifest fallback was available.

무엇을 해야 하나요

채널에 할당된 번들을 업로드하고, 매니페스트를 재생성하고, R2 또는 퍼블릭 번들을 확인하세요.

무엇을 의미하는지

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

무엇을 해야 하나요

버전을 재빌드하고 다시 업로드한 후, 번들이 실제 파일 콘텐츠를 가지고 있는지 확인하세요.

무엇을 의미하는지

디바이스 암호화 공용 키가 번들을 암호화할 때 사용한 키와 일치하지 않습니다. 메타데이터에는 device_key_id, bundle_key_id, 그리고 version.

무엇을 해야 하나요

콘솔에서 기기 및 패키지 키 ID를 비교하십시오. 동일한 키와 일치하는 CLI/플러그인 버전으로 배포하십시오.

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

제목 ‘앱 구성 및 레거시 클라이언트’

앱 구성 또는 업데이터 버전이 지원되지 않는 경우 서버에서 거부됩니다.

무엇을 의미하는가

앱이 사용자 지정 기기 ID를 보냈지만 이 앱은 사용자 지정 ID를 받지 않으므로 ID는 무시됩니다.

무엇을 해야 하나요

사용자 지정 ID를 보내지 마십시오. 또는 사용자 지정 ID를 보내야 하는 경우에만 사용하십시오.

이것이 의미하는 바는

server.url is set in Capacitor config, so the WebView loads a remote URL instead of local bundle files. Capgo live updates require local files and server.url __CAPGO_KEEP_1__ 실시간 업데이트에는 로컬 파일이 필요하고

은 프로덕션에서 사용하는 것을 피하는 것이 좋습니다.

무엇을 해야 하나요 server.url for production builds and keep update payloads local. This code can appear as a backend refusal or as a device-side stat.

제목이 'backend_refusal'인 섹션

이것이 의미하는 바는

업데이터 플러그인은 v4로, 백엔드가 더 이상 받아들이지 않습니다.

Upgrade plugin and CLI to v5+ (prefer v8) with Capacitor v5+, rebuild, and republish bundle metadata.

플러그인을 업그레이드하고 __CAPGO_KEEP_0__ v5+ (v8을 선호)로, __CAPGO_KEEP_1__ v5+로 업데이트하고, 다시 빌드하고, 다시 배포한 번들 메타데이터를 업데이트하세요.

업데이트 라이프 사이클

일반 업데이트 흐름, 활성화 및 롤백을 위한 디바이스 측 이벤트.

ping

ping

이것이 무엇을 의미하는지

STATS PIPELINE을 확인하기 위한 내부 테스트 액션.

get

get

이것이 무엇을 의미하는지

Capgo는 새로운 버전의 다운로드 정보를 디바이스로 전송했습니다.

set

set

이것이 무엇을 의미하는지

디바이스에서 패키지가 활성화되었습니다.

set_fail

set_fail

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__ npx @capgo/cli@latest app debug __CAPGO_KEEP_0__ notifyAppReady __CAPGO_KEEP_0__

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__

다운로드 및 설치 오류

다운로드 및 설치 오류

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

download_0

다운로드_0

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

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

download_10

다운로드_10

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

새로운 번들을 다운로드했습니다 — 10% 진행률을 나타냅니다.

download_20

다운로드_20

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

새로운 번들을 다운로드했습니다 — 20% 진행률을 나타냅니다.

download_30

다운로드_30

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

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

download_40

다운로드_40

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

새로운 번들을 다운로드했습니다 — 진행률이 40%로 표시됩니다.

download_50

다운로드_50

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

새로운 번들을 다운로드했습니다 — 진행률이 50%로 표시됩니다.

download_60

다운로드_60

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

새로운 번들을 다운로드했습니다 — 진행률이 60%로 표시됩니다.

download_70

다운로드_70

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

새로운 번들을 다운로드했습니다 — 70% 진행 중입니다.

download_80

다운로드_80

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

새로운 번들을 다운로드했습니다 — 80% 진행 중입니다.

download_90

다운로드_90

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

새로운 번들을 다운로드했습니다 — 90% 진행 중입니다.

download_complete

다운로드 완료

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

번들의 다운로드가 성공적으로 완료되었습니다.

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

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

download_manifest_complete

다운로드 매니페스트 완료

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

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

download_zip_start

다운로드 ZIP 시작

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

장치가 배달 아카이브를 다운로드하기 시작했습니다.

download_zip_complete

다운로드 ZIP 완료

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

장치가 배달 아카이브 다운로드를 완료했습니다.

이것은 무슨 뜻인가요?

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

무엇을 해야 하나요?

블록된 자산이 없거나 없는 경우를 고치고 매니페스트를 재생성하고 번들을 다시 업로드하세요.

download_manifest_checksum_fail

다운로드 매니페스트 체크섬 실패

이것은 무슨 뜻인가요?

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

무엇을 해야 하나요?

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

이것은 무슨 뜻인가요?

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

무엇을 해야 하나요?

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

download_fail

다운로드 실패

이것은 무슨 뜻인가요?

번들 다운로드가 실패했습니다.

무엇을 해야 하나요?

네트워크 연결성, 서명 URL 만료, CDN 접근성 및 장치 저장소 상태를 확인하세요.

이것은 무슨 뜻인가요?

The bundle installed but the app never called notifyAppReady, so Capgo rolled back.

What to do

Call notifyAppReady() after your app finishes bootstrapping. Native log text notifyAppReady was not called, roll back current bundle maps to this code.

What it means

The downloaded bundle failed checksum validation. Common causes: CRC32 vs SHA256 mismatch from an old CLI upload, or encryption key mismatch on older plugins that surface decryption failure as checksum failure.

What to do

Re-upload with a current CLI/plugin (SHA256). If using encryption, verify the app public key matches the upload key, or upgrade to plugin 8.3.0+ for explicit keyMismatch errors.

이것은 무슨 뜻인가요?

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

무엇을 해야 하나요?

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

이것은 무슨 뜻인가요?

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

무엇을 해야 하나요?

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

이것은 무슨 뜻인가요?

zip 내의 파일 경로는 정규화되지 않았습니다.

무엇을 해야 하나요

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

directory_path_fail

directory_path_fail

무엇을 의미하는 것인가요

아카이브 구조가 유효하지 않습니다.

무엇을 해야 하나요

업로드하기 전에 아카이브 구조를 수정하세요.

unzip_fail

unzip_fail

무엇을 의미하는 것인가요

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

무엇을 해야 하나요

압축 형식이 지원되는지 확인하고 아카이브의 무결성을 검증합니다.

low_mem_fail

low_mem_fail

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

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

무엇을 해야 합니까?

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

앱의 건강과 WebView 이벤트

App health and WebView events

장치 측면의 충돌, 메모리 및 WebView 진단. 항상 대시보드에서 메타데이터 JSON을 검사하세요.

app_moved_to_background

app_moved_to_background

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

앱이 백그라운드에 들어갔습니다.

이것은 무슨 뜻인가요?

앱이 전면에 표시되었습니다.

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

JavaScript or Capacitor layer crash. Metadata can include message, stack, source, and active bundle context.

메타데이터와 네이티브 로그를 검사하세요. JS와 네이티브 에러 리포팅 (예: Sentry)을 pair하여 실패하는 __CAPGO_KEEP_0__ 경로를 찾으세요.

Inspect metadata and native logs. Pair JS and native error reporting (for example Sentry) to locate the failing code path.

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

무엇을 해야 하나요?

네이티브 플랫폼 충돌입니다. 메타데이터는 플랫폼, 이유, 스택 및 프로세스 세부 정보를 포함할 수 있습니다. 네이티브 로그를 검사하고 네이티브 에러 리포팅 (예: Sentry)을 사용하여 충돌의 원인을 찾으세요.

__CAPGO_KEEP_0__ 또는 Xcode 또는 Logcat의 충돌 로그를 사용하고 메타데이터의 활성 배포본과 연관시킵니다.

이것이 무슨 뜻인가요?

Android 앱이 응답하지 않는 이벤트.

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

Logcat의 ANR 추적을 검사하고 업데이트 후 메인 스레드 차단 작업을 줄입니다.

app_killed_low_memory

__CAPGO_KEEP_0__

이것이 무슨 뜻인가요?

OS가 메모리 압박으로 앱을 죽였습니다.

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

업데이트 활성화 후 메모리 사용을 줄이고 메타데이터에서 사용 가능한 메모리 신호를 검사합니다.

app_killed_excessive_resource_usage

__CAPGO_KEEP_0__

이것이 무슨 뜻인가요

OS는 앱이 과도한 자원 사용으로 인해 죽였습니다.

무엇을 해야 하나요

자원 유형 또는 플랫폼 이유를 확인하기 위해 메타데이터를 검사하세요.

app_initialization_failure

앱 초기화 실패

이것이 무슨 뜻인가요

업데이터 또는 런타임이 정상화되기 전에 실패했습니다.

무엇을 해야 하나요

실패한 단계와 오류 메시지를 확인하기 위해 메타데이터를 검사하세요.

app_memory_warning

앱 메모리 경고

이것이 무슨 뜻인가요

iOS 메모리 경고입니다.

무엇을 해야 하나요?

업데이트 후 메모리 컨텍스트를 메타데이터에서 검사하고 사용량을 줄입니다.

webview_javascript_error

webview_javascript_error

무엇을 의미하는가?

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

무엇을 해야 하나요?

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

webview_unhandled_rejection

webview_unhandled_rejection

무엇을 의미하는가?

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

무엇을 해야 하나요?

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

webview_resource_error

웹뷰 리소스 오류

이것은 무슨 뜻인가요?

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

무엇을 해야 하나요?

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

webview_security_policy_violation

웹뷰 보안 정책 위반

이것은 무슨 뜻인가요?

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

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

웹뷰 불결한 재시작

webview_unclean_restart

이것은 무슨 뜻인가요?

메타데이터 지시문을 사용하여 CSP를 조정하고 차단된 URI 세부 정보를 참조하세요.

이전 WebView 세션은 정리되지 않았습니다. 이는 업데이트 후 충돌 루프가 발생할 수 있음을 나타낼 수 있습니다.

무엇을 해야 하나요?

충돌과 WebView 오류 이벤트를 재시작하기 전에 및 후에 상관관계하세요.

webview_render_process_gone

웹뷰 렌더러 프로세스 종료

무엇을 의미하는가요?

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

무엇을 해야 하나요?

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

webview_content_process_terminated

웹뷰 콘텐츠 프로세스 종료

무엇을 의미하는가요?

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

무엇을 해야 하나요?

활성 번들 및 페이지 URL을 메타데이터에서 확인합니다.

환경 및 채널 컨텍스트

환경 및 채널 컨텍스트 섹션

OS, 네이티브 버전 또는 채널 변경과 관련하여 업데이트 동작을 연관시키는 데 도움이 되는 디바이스 사이드 컨텍스트 이벤트.

이것이 무엇을 의미하는지

체크 간에 디바이스 OS 버전이 변경되었습니다.

네이티브 앱 스토어 버전이 변경되었습니다.

이것이 무엇을 의미하는지

이것이 무엇을 의미하는지

__CAPGO_KEEP_0__

setChannel

setChannel

setChannel

__CAPGO_KEEP_0__

uninstall

uninstall

uninstall

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

Bundle 상태

Bundle 상태
  • SUCCESS설치 완료
  • ERROR설치 또는 다운로드 실패
  • PENDING다운로드 완료, 출시待ち
  • DELETED: __CAPGO_KEEP_0__ 삭제, 통계를 위해 표시
  • DOWNLOADING: 현재 __CAPGO_KEEP_0__ 다운로드 중

장치 로그 이해

장치 로그 이해

디버그 명령어

디버그 명령어

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

터미널 창
npx @capgo/cli@latest app debug

이것은 앱에서 발생하는 모든 이벤트를 확인하고 업데이트가 안 되는 경우 해결 방법을 찾을 수 있도록 해줍니다.

iOS 네이티브 로그

iOS 네이티브 로그

Xcode에서 로그를 찾는 방법

안드로이드 네이티브 로그

안드로이드 네이티브 로그

안드로이드 스튜디오에서 로그를 찾는 방법

네이티브 로그 매핑

네이티브 로그 매핑
  • Failed to download from 매핑 download_fail
  • notifyAppReady was not called, roll back current bundle 매핑 update_fail

다운로드된 패키지를 찾는 방법

다운로드된 패키지를 찾는 방법

iOS에서 디버깅하려면 앱을 컴퓨터에 덤프해야 합니다. 방법은 다음과 같습니다.

Xcode는 iOS 기기에서 개발자에 의해 설치된 앱의 파일 시스템을 검사하는 내장 기능을 가지고 있습니다. Xcode Window 메뉴의 Devices and Simulators 옵션

이것을 달성하려면:

  • Mac에 기기를 연결하고 Xcode 메뉴바의 Window > Devices를 선택하세요.
  • 왼쪽 패널의 Devices 섹션 아래에 기기를 선택하세요.
  • 이것은 기기에 설치된 개발자 앱의 목록을 보여줍니다.
  • 검색하고자 하는 앱을 선택하고 화면의 아래쪽에 있는 3개의 점 아이콘을 선택하세요.
  • 여기에서 현재 파일 시스템을 다운로드한 스냅샷을 선택하세요.

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

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

다운로드된 xcappdata 파일에 Show Package Contents 컨텍스트 메뉴를 클릭하여 폴더를 열 수 있습니다.

이 파일을 오른쪽 클릭하고 Show Package Contents를 선택하여 폴더를 열 수 있습니다.

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

iOS 앱 컨테이너 폴더 구조에서 문서 및 라이브러리 폴더를 볼 수 있습니다.

앱이 재부팅 후에도 유지되는 버전이 2개의 폴더에 존재합니다.

library/NoCloud/ionic_built_snapshots 앱이 재부팅 후에도 유지되는 버전이 필요합니다.

핫 리로드를 위해도 필요합니다. documents/versions Android

Android를 debug하기 위해서는 Android Studio에서 디바이스에 접근해야 합니다.

Android를 debug하기 위해서는 Android Studio에서 디바이스에 접근해야 합니다.

Android를 debug하기 위해서는 Android Studio에서 디바이스에 접근해야 합니다.

  • Click View > Tool Windows > Device File Explorer or click the Device File Explorer button in the tool window bar to open the Device File Explorer.
  • __CAPGO_KEEP_0__를 선택하세요.
  • Open the path data/data/__CAPGO_KEEP_1__/ where __CAPGO_KEEP_1__는 앱 ID입니다.

Android Studio Device File Explorer showing app data directory

그런 다음 versions Find the

iOS 프로덕션 충돌 로그 이해하기

iOS 프로덕션 충돌 로그 이해하기

Debugging에서 계속

Debugging

Capacitor를 사용하는 경우 Capacitor를 사용하는 경우 Capacitor를 사용하는 경우 Using @capgo/capacitor-updater for the native capability in Using @capgo/capacitor-updater, Capgo Plugin Directory for the product workflow in Capgo Plugin Directory, Capacitor 플러그인들에 의해 Capgo Capacitor 플러그인들에 의해 Capgo의 구현 세부 정보를 위해 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트의 구현 세부 정보를 위해, 및 Ionic Enterprise 플러그인 대체 Ionic Enterprise 플러그인 대체의 제품 워크플로에 대해