본문 바로가기

디버깅

GitHub

클라우드 로그 이해하기

“클라우드 로그 이해하기” 섹션

클라우드 거부 code 오류가 발생했고 더 자세한 해결 방법이 필요하다면 다음을 참고하세요. 일반적인 업데이트 문제.

Capgo 로그에는 이벤트 메타데이터가 포함될 수 있습니다. 대시보드에서 snake_case 형식의 액션 code로 필터링한 뒤 메타데이터 셀을 클릭하면 전체 JSON 페이로드가 복사됩니다. 메타데이터에는 에러 메시지, 소스 URL, 라인과 컬럼, 프로세스 상태, 메모리 압박, 플랫폼별 원인 등이 담길 수 있어 크래시 및 WebView 이벤트 분석에 특히 유용합니다. 오래된 로그에는 괄호 안에 이전 camelCase 별칭이 표시될 수 있습니다.

각 섹션 제목은 콘솔 로그 테이블에 표시되는 code 액션과 일치하므로 해당 섹션으로 바로 이동할 수 있습니다.

플랜 제한과 정상 응답

“플랜 제한 및 일반 응답” 섹션

결제, 스로틀링 또는 에러가 아닌 상태와 관련된 백엔드 거부 응답입니다.

의미

Capgo가 Google 또는 클라우드 인프라에서 온 것으로 보이는 트래픽을 감지했습니다. 봇 트래픽이 과금 대상 디바이스로 집계되지 않도록 생성된 지 4시간 미만인 업데이트는 무시됩니다.

해결 방법

실제 사용자에서는 무시하세요. 일반 네트워크와 실제 기기에서 재시도하거나, 잠시 후 다시 확인하세요.

provider_infrastructure_request_blocked

“provider_infrastructure_request_blocked” 섹션

의미

앱이 Google과 Apple의 데이터센터 IP 범위에서 오는 요청을 차단하도록 설정되어 있습니다. 이 보호 기능은 업데이트 확인, 통계, 채널 자체 요청에 적용되므로, 앱 설정이 정상적이어도 클라우드 호스팅 프로브나 프로바이더 러너가 이 응답을 받을 수 있습니다.

해결 방법

일반 사용자 네트워크의 물리적 기기에서 재시도하세요. 프로바이더에서 발생한 트래픽이 의도적인 것이라면, 일시적으로 비활성화하세요 프로바이더 인프라 요청 차단 앱의 정보 탭에서, 테스트 후 다시 활성화하세요. 새 앱은 기본적으로 이 설정이 활성화되어 있으며, 기존 앱은 변경될 때까지 이전의 비활성화 설정이 유지됩니다.

의미

조직이 플랜 또는 기기 한도에 도달했습니다. 업그레이드하거나 다음 청구 주기에 사용량이 리셋될 때까지 기기에 업데이트가 전달되지 않습니다.

해결 방법

대시보드에서 플랜을 업그레이드하거나 다음 청구 주기를 기다리세요.

의미

기기가 해당 채널에서 최신 번들을 이미 보유하고 있습니다. 이는 실패가 아닌 정상 상태입니다.

의미

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

해결 방법

렌더 루프 내에서 업데이트 API를 호출하지 마세요. setChannel / getChannel 사용자 동작에서만 호출하고, defaultChannel 에서 capacitor.config.

유효하지 않은 native 버전 메타데이터로 인한 백엔드 거부.

의미

config의 native 앱 버전이 누락되었거나 유효한 semver가 아닙니다 (x.y.z).

해결 방법

설정 plugins.CapacitorUpdater.version 유효한 semver로 수정하려면 SemVer 테스터에서 확인한 다음, native 앱을 다시 빌드하고 재설치하세요).

플랫폼 및 빌드 타겟팅

“플랫폼 및 빌드 타겟팅” 섹션

채널 정책이 플랫폼, 빌드 유형 또는 기기 클래스를 차단할 때 백엔드에서 거부됨.

의미

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

해결 방법

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

의미

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

해결 방법

실수로 차단된 경우 채널에서 Android를 활성화하거나, 의도적으로 차단하는 경우 Android 빌드를 전용 채널로 라우팅하세요.

의미

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

해결 방법

실수로 차단된 경우 채널에서 Electron을 활성화하거나, 의도적으로 차단하는 경우 Electron 빌드를 전용 채널로 라우팅하세요.

의미

디바이스가 개발 빌드인데, 이 채널에서는 개발 빌드가 차단되어 있습니다.

해결 방법

테스트 채널에서 개발 빌드를 허용하거나, 이 채널을 릴리스 전용으로 유지하고 개발용 디바이스를 다른 곳으로 이동하세요.

의미

production build인 /updates이지만, 이 채널에서는 production 업데이트가 차단되어 있습니다.

해결 방법

실수였다면 채널에서 production 업데이트를 허용하거나, production build를 올바른 채널로 라우팅하세요.

의미

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

해결 방법

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

의미

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

해결 방법

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

자동 업데이트 호환성 규칙

“자동 업데이트 호환성 규칙” 섹션

semver 또는 메타데이터 규칙이 대상 bundle을 차단할 때 백엔드에서 거부되는 경우.

의미

채널 호환성 정책에 따라 자동 업데이트가 비활성화되었습니다. 메타데이터에는 auto_update 과 일치하는 규칙이 포함되어 있습니다. 예를 들어 major, minor, patch, metadata, 또는 none.

해결 방법

의도한 롤아웃을 허용하도록 채널 자동 업데이트 정책을 변경하세요.

disableAutoUpdateUnderNative

“disableAutoUpdateUnderNative” 섹션

의미

채널에 디바이스 베이스라인보다 오래된 bundle이 있어 네이티브 버전 아래에서 업데이트 전송이 차단됩니다.

해결 방법

네이티브 베이스라인 이상인 번들을 게시하거나, 채널에서 네이티브 미만 보호를 비활성화하세요.

의미

채널은 min_update_version을(를) 요구하지만, 기기의 네이티브 버전이 해당 임계값보다 낮습니다.

해결 방법

설정 min_update_version 대상 번들 또는 더 새로운 네이티브 버전의 릴리스에서

의미

채널은 메이저 버전 점프를 차단합니다. 예를 들어 1.x.x 대상 2.x.x.

해결 방법

메이저 롤아웃 계획에 맞춰 채널 전략을 조정하거나, 이 트랙에서 메이저 점프를 허용하세요. 참고 일반적인 업데이트 문제.

의미

채널은 디바이스 네이티브 베이스라인(version_build) 대비 마이너 버전 점프를 차단합니다. 예: 1.2.3 대상 1.3.0.

해결 방법

채널 전략을 마이너 롤아웃 계획에 맞추거나, 이 트랙에서 마이너 버전 점프를 허용하세요.

의미

해당 채널은 동일한 prefix를 유지하면서 patch 레벨 변경을 차단하고, MAJOR.MINOR.PATCH suffix 변경만 허용합니다.

해결 방법

릴리스 주기를 채널 정책에 맞추거나, 이 트랙에서 patch 버전 점프를 허용하세요.

채널 설정이 누락되었거나 호환되지 않아 발생하는 백엔드 거부 오류입니다.

cannotUpdateViaPrivateChannel

“cannotUpdateViaPrivateChannel” 섹션

의미

디바이스가 자체 할당이 허용되지 않는 프라이빗 채널에 자체 연결을 시도했습니다 (allow_device_self_set 가 false)이고 채널이 공개되어 있지 않습니다.

해결 방법

활성화 allow_device_self_set 채널에서 설정하거나, 기기를 공개 또는 허용된 채널로 전환하세요.

의미

채널은 disable_auto_update: "version_number" 을(를) 사용하지만 번들은 min_update_version 이(가) null이므로 Capgo이(가) 어떤 기기를 업데이트해야 할지 결정할 수 없습니다.

해결 방법

해당 규칙의 누락된 설정을 채우거나 더 간단한 자동 업데이트 모드로 전환하세요.

의미

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

해결 방법

대시보드에서 기본 채널을 설정하거나 defaultChannel 빌드에서 구성하세요.

Capgo가 bundle을 서빙하거나 복호화할 수 없을 때 발생하는 백엔드 거부.

의미

Capgo에서 유효한 서명된 다운로드 URL을 생성하지 못했고, 매니페스트 폴백도 없었습니다.

해결 방법

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

의미

채널에 할당된 번들에 다운로드 가능한 콘텐츠가 없습니다: 없음 external_url, 없음 r2_path, 내장 버전도 아니고 매니페스트 항목도 없습니다.

해결 방법

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

의미

기기의 암호화 공개 키가 bundle 암호화에 사용된 키와 일치하지 않습니다. 메타데이터에는 다음이 포함될 수 있습니다: device_key_id, bundle_key_id, 그리고 version.

해결 방법

콘솔에서 기기와 bundle의 키 ID를 비교하세요. 동일한 키와 일치하는 CLI/plugin 버전으로 게시하세요.

앱 설정 및 레거시 클라이언트

“앱 설정 및 레거시 클라이언트” 섹션

앱 설정 또는 지원되지 않는 updater 버전으로 인한 백엔드 거부.

의미

앱이 커스텀 기기 ID를 보냈지만 이 앱은 커스텀 ID를 허용하지 않으므로 해당 ID는 무시됩니다.

해결 방법

커스텀 ID 전송을 중단하거나, 워크플로우에 꼭 필요한 경우에만 활성화하세요.

의미

server.url Capacitor 설정에 지정되어 있어, WebView가 로컬 번들 파일 대신 원격 URL을 로드합니다. Capgo Live Updates는 로컬 파일이 필요하며, server.url 운영 환경에서는 권장되지 않습니다.

해결 방법

제거하거나 지우세요. server.url 운영 빌드에서는 업데이트 페이로드를 로컬로 유지해야 합니다. 이 code은 백엔드 거부 또는 디바이스 측 통계로 나타날 수 있습니다.

의미

업데이터 플러그인이 v4 버전이라 백엔드에서 더 이상 허용하지 않습니다.

해결 방법

Capacitor v5+를 사용해 플러그인과 CLI를 v5 이상(v8 권장)으로 업그레이드하고, 다시 빌드한 뒤 번들 메타데이터를 다시 게시하세요.

업데이트 라이프사이클

“업데이트 라이프사이클” 섹션

일반적인 업데이트 흐름, 활성화 및 롤백에 대한 디바이스 측 이벤트입니다.

의미

통계 파이프라인을 검증하는 데 사용되는 내부 테스트 액션입니다.

의미

Capgo가 새 버전에 대한 다운로드 정보를 디바이스로 전송했습니다.

의미

기기에서 번들이 활성화되었습니다.

의미

기기에서 번들 활성화에 실패했습니다.

해결 방법

다음 명령어로 네이티브 로그를 확인하고 npx @capgo/cli@latest app debug 번들 무결성, 경로 및 notifyAppReady 흐름을 검증하세요.

의미

기기가 내장 번들로 리셋되었습니다.

의미

기기에서 번들 하나가 삭제되었습니다.

다운로드 및 설치 실패

“다운로드 및 설치 실패” 섹션

다운로드 진행 상황, 아카이브 검증 및 설치 오류에 대한 기기 측 이벤트입니다.

의미

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

의미

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

의미

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

의미

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

의미

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

의미

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

의미

새 bundle이 다운로드되었습니다 — 진행률 60% 표시.

의미

새 bundle이 다운로드되었습니다 — 진행률 70% 표시.

의미

새 bundle이 다운로드되었습니다 — 진행률 80% 표시.

의미

새 bundle이 다운로드되었습니다 — 진행률 90% 표시.

의미

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

의미

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

download_manifest_complete

“download_manifest_complete” 섹션

의미

디바이스가 업데이트 manifest 다운로드를 완료했습니다.

의미

디바이스가 bundle 아카이브 다운로드를 시작했습니다.

의미

기기에서 번들 아카이브 다운로드를 완료했습니다.

download_manifest_file_fail

“download_manifest_file_fail” 섹션

의미

매니페스트 항목 중 하나를 다운로드하지 못했습니다. version_name 사용 version:fileName 에셋을 식별하기 위해 사용됩니다.

해결 방법

누락되거나 차단된 에셋을 수정하고, 매니페스트를 다시 생성한 뒤 번들을 다시 업로드하세요.

download_manifest_checksum_fail

“download_manifest_checksum_fail” 섹션

의미

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

해결 방법

현재 CLI 버전으로 bundle을 다시 upload하고 manifest checksum을 확인하세요.

download_manifest_brotli_fail

“download_manifest_brotli_fail” 섹션

의미

manifest 파일이 Brotli 압축 해제에 실패했습니다.

해결 방법

압축 설정을 확인하고 영향을 받은 에셋을 다시 upload하세요.

의미

bundle을 download하지 못했습니다.

해결 방법

네트워크 연결, signed URL 만료 여부, CDN 접근 가능 여부, 디바이스 저장 공간을 확인하세요.

의미

번들은 설치됐지만 앱이 호출하지 않았고 notifyAppReady그래서 Capgo가 롤백되었습니다.

해결 방법

호출하세요 notifyAppReady() 앱 부트스트래핑이 완료된 후. 네이티브 로그 텍스트 notifyAppReady was not called, roll back current bundle 이 code에 매핑됩니다.

의미

다운로드한 번들이 체크섬 검증을 통과하지 못했습니다. 흔한 원인은 이전 CLI 업로드로 인한 CRC32와 SHA256 불일치이거나, 복호화 실패가 체크섬 실패로 나타나는 구형 플러그인의 암호화 키 불일치입니다.

해결 방법

최신 CLI/plugin(SHA256)으로 다시 upload하세요. 암호화를 사용한다면 앱 public key가 upload key와 일치하는지 확인하거나, 명확한 keyMismatch 오류.

의미

다운로드한 bundle을 복호화하지 못했습니다.

해결 방법

암호화 키를 확인하고, 일치하는 키 쌍으로 bundle을 다시 upload하세요.

의미

zip에 허용되지 않는 Windows 스타일 경로가 있습니다.

해결 방법

Unix 경로로 bundle을 다시 빌드하거나, upload 전에 아카이브 경로를 정리하세요.

의미

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

해결 방법

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

의미

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

해결 방법

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

의미

기기가 다운로드한 번들을 압축 해제하지 못했습니다.

해결 방법

아카이브 무결성과 지원되는 압축 방식을 확인하세요.

의미

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

해결 방법

Bundle 크기를 줄이거나, 사용 가능한 메모리가 더 많은 기기에서 다시 시도하세요.

앱 상태 및 WebView 이벤트

“App health and WebView events” 섹션

기기 측 크래시, 메모리 및 WebView 진단. Dashboard에서 항상 metadata JSON을 확인하세요.

의미

앱이 백그라운드로 전환되었습니다.

의미

앱이 포그라운드로 전환되었습니다.

의미

JavaScript 또는 Capacitor 레이어 크래시. 메타데이터에는 메시지, 스택, 소스, 활성 번들 컨텍스트가 포함될 수 있습니다.

해결 방법

메타데이터와 네이티브 로그를 확인하세요. JS와 네이티브 오류 보고(예: Sentry)를 함께 사용해 실패한 code 경로를 찾으세요.

의미

Native 플랫폼 크래시. 메타데이터에 플랫폼, 원인, 스택 및 프로세스 상세 정보가 포함될 수 있습니다.

해결 방법

Xcode 또는 Logcat 크래시 로그를 사용하고, 메타데이터의 활성 bundle과 대조하여 확인하세요.

의미

Android Application Not Responding(ANR) 이벤트.

해결 방법

Logcat에서 ANR trace를 조사하고, 업데이트 후 메인 스레드 차단 작업을 최소화하세요.

의미

메모리 압박으로 인해 OS가 앱을 종료했습니다.

해결 방법

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

app_killed_excessive_resource_usage

“app_killed_excessive_resource_usage” 섹션

의미

과도한 리소스 사용으로 OS가 앱을 종료했습니다.

해결 방법

메타데이터에서 리소스 유형이나 플랫폼 원인을 확인하세요.

app_initialization_failure

“app_initialization_failure” 섹션

의미

정상 런타임이 준비되기 전에 Updater 또는 앱 시작 단계에서 실패했습니다.

해결 방법

메타데이터에서 실패한 단계와 에러 메시지를 확인하세요.

의미

iOS 메모리 경고.

해결 방법

메타데이터에서 메모리 컨텍스트를 확인하고 업데이트 후 피크 사용량을 줄이세요.

의미

WebView에서 발생한 Uncaught JavaScript 에러입니다. 메타데이터에는 메시지, 소스 URL, 라인, 컬럼 및 스택 정보가 포함될 수 있습니다.

해결 방법

프로덕션 환경에서 정확한 에러 발생 라인을 캡처하려면 JS 및 네이티브 레이어에 에러 리포팅을 설치하세요.

webview_unhandled_rejection

“webview_unhandled_rejection” 섹션

의미

WebView에서 처리되지 않은 promise rejection입니다.

해결 방법

JS 및 네이티브 에러 리포팅으로 비동기 실패를 포착하세요.

의미

WebView 리소스를 불러오지 못했습니다.

해결 방법

메타데이터 URL과 상태 상세 정보를 사용해 깨진 에셋이나 네트워크 규칙을 수정하세요.

webview_security_policy_violation

“webview_security_policy_violation” 섹션

의미

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

해결 방법

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

의미

이전 WebView 세션이 정상적으로 종료되지 않았으며, 업데이트 후 크래시 루프의 징후일 수 있습니다.

해결 방법

재시작 전후의 크래시 및 WebView 오류 이벤트와 상관관계를 확인하세요.

webview_render_process_gone

“webview_render_process_gone” 섹션

의미

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

해결 방법

메타데이터와 네이티브 로그에서 렌더러 크래시 신호를 확인하세요.

webview_content_process_terminated

“webview_content_process_terminated” 섹션

의미

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

해결 방법

메타데이터에서 활성 bundle과 페이지 URL을 확인하세요.

실행 및 내비게이션 텔레메트리

“실행 및 내비게이션 텔레메트리” 섹션

이러한 타이밍 이벤트는 앱의 라이프사이클을 설명합니다. 모든 기능이 정상 작동한다는 것을 보장하지는 않습니다.

의미

앱이 실행 측정을 시작했습니다. 정상적인 라이프사이클 이벤트입니다.

의미

앱이 준비 완료를 보고했습니다. 타이밍 메타데이터는 버전 간 시작 시간을 비교하는 데 도움이 됩니다. 정상적인 라이프사이클 이벤트입니다.

의미

앱이 실행 측정 시간 내에 준비 완료를 보고하지 않았습니다.

해결 방법

시작 오류와 디바이스 타임라인을 검사하세요. 시작 과정이 readiness 호출에 도달하는지 확인하고, 호출하세요 notifyAppReady() 타임아웃 설정을 변경하기 전에 이전 번들과 타이밍 및 실패를 비교하세요.

webview_dom_content_loaded

“webview_dom_content_loaded” 섹션

의미

WebView가 DOM 콘텐츠 로딩을 보고했습니다. 이는 정상적인 타이밍 이벤트이며, 모든 리소스나 애플리케이션 기능이 준비되었음을 의미하지 않습니다.

의미

WebView가 페이지 로딩을 보고했습니다. 이는 정상적인 타이밍 이벤트입니다. 느린 로딩을 조사할 때 버전 간 지속 시간 메타데이터를 비교하세요.

의미

앱이 내비게이션 이벤트를 보고했습니다. 이는 정상적인 텔레메트리입니다. 앱이 메타데이터를 제공하면 라우트와 지속 시간 메타데이터를 통해 화면별 비교가 가능합니다.

추가 업데이터 결과

"추가 업데이트 결과" 섹션

의미

번들이 다음 앱 실행 시 활성화되도록 예약되었습니다. 예약은 정상적인 동작이며, 번들이 이미 활성화되었음을 의미하지 않습니다.

의미

선택된 채널이 일시 중지되었습니다. 서버는 업데이트를 전송하지 않으며, 기기는 현재 번들을 유지합니다. 이는 의도적인 릴리스 정책일 수 있습니다.

해결 방법

채널이 일시 중지된 이유와 재개가 안전한지 확인하세요. 이 이벤트를 무시하기 위해 롤아웃을 자동으로 재개하지 마세요.

의미

기기가 다운로드된 번리의 최종 처리를 완료하지 못했습니다.

해결 방법

기본 파일 시스템 또는 검증 오류에 대한 메타데이터와 네이티브 로그를 검사하세요. 재시도 전에 사용 가능한 저장 공간과 업로드된 아카이브를 확인하세요.

의미

업데이트 중 매니페스트 파일 경로가 검증을 통과하지 못했거나 사용할 수 없었습니다.

해결 방법

네이티브 로그에서 실패한 경로를 검사하고, 번들의 파일 레이아웃을 수정한 후 다시 업로드하세요. 경로 검증을 우회하지 마세요.

의미

업데이터는 이 다운로드에 대해 누락된 체크섬 메타데이터가 필요합니다.

해결 방법

현재 CLI와 함께 번들을 다시 업로드하고 체크섬 메타데이터가 존재하는지 확인하세요. 오류를 우회하기 위해 무결성 검사를 비활성화하지 마세요.

의미

기기에 업데이트를 설치할 충분한 저장 공간이 부족합니다.

해결 방법

기기의 저장 공간을 확보하고, 가능한 경우 bundle 크기를 줄인 후 해당 테스트 기기에서 다시 시도하세요. 채널의 버전 정책을 변경해도 이 문제는 해결되지 않습니다.

의미

업데이트 확인에 실패했습니다. 이 이벤트만으로는 원인이 연결성, 서버 가용성, 또는 특정 응답 거부인지 구별할 수 없습니다.

해결 방법

응답 메타데이터와 주변 네이티브 로그를 확인하세요. 연결 상태와 설정된 업데이트 URL을 점검한 후, 설정을 변경하기 전에 'Common Update Problems'에서 특정 백엔드 오류를 검색하세요.

환경 및 채널 컨텍스트

“Environment and channel context” 섹션

OS, 네이티브 버전, 또는 채널 변경과 업데이트 동작을 상관관계로 분석하는 데 도움이 되는 기기 측 컨텍스트 이벤트입니다.

의미

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

native_app_version_changed

“native_app_version_changed” 섹션

의미

네이티브 앱 스토어 버전이 변경되어 네이티브와 웹 번들 변경을 구분하는 데 도움이 됩니다.

의미

디바이스가 현재 채널을 조회했습니다.

의미

디바이스에 채널이 성공적으로 설정되었습니다.

의미

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

  • SUCCESS: bundle 설치 완료
  • ERROR: 설치 또는 다운로드 실패
  • PENDING: 다운로드 완료, 릴리스 대기 중
  • DELETED: bundle 삭제됨, 통계용으로 여전히 표시됨
  • DOWNLOADING: 현재 bundle 다운로드 중

디바이스 로그 이해하기

“Understanding device logs” 섹션

디버그 명령어

“Debug command” 섹션

Capgo 클라우드 사용자를 위한 디버그 명령이 있습니다.

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

앱에서 발생하는 모든 이벤트를 확인하고, 업데이트가 이루어지지 않을 때 해결책을 찾을 수 있습니다.

Xcode에서 로그를 확인하려면

Android 네이티브 로그

“Android 네이티브 로그” 섹션

Android Studio에서 로그를 확인하려면

네이티브 로그 문구 매핑

“네이티브 로그 문구 매핑” 섹션
  • Failed to download from 매핑 대상 download_fail
  • notifyAppReady was not called, roll back current bundle 매핑 대상 update_fail

기기에서 다운로드한 bundle 찾기

“디바이스에서 다운로드된 번들 찾기” 섹션

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

Xcode에는 iOS 디바이스에 설치된 개발자용 앱의 파일 시스템을 검사하는 내장 기능이 있습니다. Xcode Window 메뉴에서 Devices and Simulators 옵션이 표시된 화면

다음과 같이 진행하세요:

  • 기기를 Mac에 연결하고 Xcode 메뉴바에서 Window > Devices를 선택하세요.
  • 왼쪽 패널의 Devices 섹션에서 기기를 선택하세요.
  • 해당 기기에 설치된 개발자용 앱 목록이 표시됩니다.
  • 검사할 앱을 선택한 후 화면 하단 근처의 3점 아이콘을 선택하세요.
  • 여기서 스냅샷 다운로드를 선택하여 현재 파일 시스템을 볼 수 있습니다.

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

Download Container…를 선택하면 파일 시스템 스냅샷이 .xcappdata 파일로 다운로드되어 탐색할 수 있습니다.

Show Package Contents 컨텍스트 메뉴가 표시된 다운로드된 xcappdata 파일

이 파일을 우클릭하고 Show Package Contents를 선택하여 폴더를 엽니다.

App Data 폴더를 열면 Documents, Library, tmp 등의 폴더가 표시됩니다.

Documents와 Library 폴더를 보여주는 iOS 앱 컨테이너 폴더 구조

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

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

및 documents/versions 핫 리로드용

Android에서 디버깅하려면 Android Studio에서 기기에 접근해야 합니다:

  • View > Tool Windows > Device File Explorer를 클릭하거나 도구 창 바의 Device File Explorer 버튼을 클릭해 Device File Explorer를 엽니다.
  • 드롭다운 목록에서 기기를 선택합니다.
  • 경로를 엽니다 data/data/APP_NAME/ 어디에 APP_NAME은 앱 ID입니다.

앱 데이터 디렉토리를 보여주는 Android Studio Device File Explorer

그다음 폴더를 찾아 versions 모든 버전을 확인합니다

디버깅에서 계속하기

“Debugging”에서 계속하기

사용 중이라면 디버깅 네이티브 플러그인 작업을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-updater 사용하기 네이티브 기능의 경우 @capgo/capacitor-updater 사용하기에서, Capgo 플러그인 디렉토리 Capgo Plugin Directory의 제품 워크플로우에 맞춰, Capgo의 Capacitor 플러그인 Capgo의 Capacitor 플러그인 구현 상세 내용에 대해서는, 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트 구현 상세 내용에 대해서는, Ionic Enterprise 플러그인 대안 Ionic Enterprise 플러그인 대안의 제품 워크플로우에 대해서는.