디버깅

클라우드 로그 이해

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

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

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

계획 제한 및 일반적인 응답

청구, 속도 제한 또는 비 오류 상태와 관련된 백엔드 거부

InvalidIp

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

Capgo은 Google 또는 클라우드 인프라에서처럼 보이는 트래픽을 감지했습니다. 4시간 이내의 업데이트는 무시되므로 봇 트래픽이 청구 가능한 장치로 계산되지 않습니다.

무엇을 해야 합니까?

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

provider_infrastructure_request_blocked

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

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

무엇을 해야 합니까?

물리 장치에서 일반 사용자 네트워크에서 다시 시도하십시오. 제공자에서 유도된 트래픽이 의도적일 경우 일시적으로 Block provider infrastructure requests 앱의 정보 __CAPGO_KEEP_0__을 눌러서 설정을 다시 활성화하세요. 새로운 앱은 이 설정을 기본적으로 활성화합니다. 기존 앱은 이전에 비활성화된 설정을 유지합니다. 설정을 변경할 때까지.

needPlanUpgrade

이것이 무슨 뜻인가요?

__CAPGO_KEEP_2__에 도달하거나 장치 제한이 설정된 경우 장치가 업데이트를 받지 않습니다. 사용량이 다음 청구 주기에서 초기화될 때까지 업그레이드하거나.

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

__CAPGO_KEEP_3__에서 업그레이드하거나 다음 청구 주기까지 기다려보세요.

noNew

이것이 무슨 뜻인가요?

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

rateLimited

이것이 무슨 뜻인가요?

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

업데이트 API를 렌더 루프 내에서 호출하지 마세요. 사용자 액션에서만 호출하고

버전 형식 setChannel / getChannel 버전 형식 defaultChannel 버전 형식이 잘못된 네이티브 버전 메타데이터로 인해 백엔드가 거부되는 경우입니다. capacitor.config.

semver_error

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

semver_error

업데이트 API를 렌더 루프 내에서 호출하지 마세요. 사용자 액션에서만 호출하고

버전 형식x.y.z).

설정하세요.

버전 형식 plugins.CapacitorUpdater.version __CAPGO_KEEP_0__ 버전을 valid semver로 확인하고 SemVer 테스터를 통해 유효성을 검증한 후 네이티브 앱을 재구축하고 재설치하십시오.

플랫폼 및 빌드 목표

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

disablePlatformIos

이 의미는 무엇인가요?

이 장치는 iOS를 실행하고 있지만 이 채널에서 iOS 업데이트를 비활성화했습니다.

무엇을 해야 하나요?

이것이 의도치 않은 경우 iOS를 채널에 활성화하십시오. 또는 의도적으로 차단하는 경우 iOS 빌드를 전용 채널로 라우팅하십시오.

disablePlatformAndroid

이것이 의미하는 바

이 장치에서는 안드로이드가 실행되지만, 이 채널에서 안드로이드 업데이트가 비활성화되어 있습니다.

무엇을 해야 하나요

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

disablePlatformElectron

이것이 의미하는 바

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

무엇을 해야 하나요

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

disableDevBuild

이것이 의미하는 바

이 장치는 개발 빌드지만, 이 채널에서 개발 빌드가 차단되어 있습니다.

무엇을 해야 하나요

테스트 채널에서 개발 빌드를 허용하거나, 이 채널은 개발 장치가 아닌 채널로 이동시키고 개발 빌드 허용을 차단하세요.

disableProdBuild

무엇을 의미하는가

생산 빌드가 호출되지만, 이 채널에서는 생산 업데이트만 차단됩니다. /updates무엇을 해야 하나요

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

제목: 'disableDevice'

disableDevice

실제 휴대폰이나 태블릿이 차단되었습니다. 왜냐하면 이 채널에서는 실제 장치가 차단되어 있습니다.

무엇을 해야 하나요

What to do

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

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.

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

일반적인 업데이트 문제 제목이 “disableAutoUpdateToMinor”인 섹션.

disableAutoUpdateToMinor

__CAPGO_KEEP_0__은 무엇을 의미합니까?

이 채널은 기기 기본 버전 baseline에 대한 소수점 버전 업데이트를 차단합니다 (version_build) 예를 들어 1.2.3 to 1.3.0.

__CAPGO_KEEP_0__을 무엇을 해야 합니까?

이 채널 전략을 소수점 버전 업데이트와 일치시키거나, 이 트랙에 대한 소수점 업데이트를 허용하세요.

disableAutoUpdateToPatch

__CAPGO_KEEP_0__은 무엇을 의미합니까?

이 채널은 같은 prefix를 유지하면서 패치 수준 변경을 차단합니다. 단, suffix 변경만 허용됩니다. MAJOR.MINOR.PATCH __CAPGO_KEEP_0__을 무엇을 해야 합니까?

릴리즈 캘린더를 채널 정책과 일치시키거나, 이 트랙에 대한 패치 업데이트를 허용하세요.

Section titled “disableAutoUpdateToPatch”

채널 설정

채널 설정이 누락되거나 불일치로 인한 백엔드 거부

cannotUpdateViaPrivateChannel

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

장치가 비공개 채널로 장치 자체 할당을 허용하지 않는 채널과 연결하려고 시도했으며, 채널이 공공이 아니므로 장치 자체 할당이 불가능합니다.allow_device_self_set 이것을 어떻게 해야 합니까?

채널 설정에서 "허용"을 활성화하거나 장치를 공공 채널이나 허용된 채널로 전환하세요.

채널 설정 오류 allow_device_self_set 이것은 무엇을 의미합니까?

channelMisconfigured

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

채널은 사용하지만 disable_auto_update: "version_number" 배포본은 null이므로 __CAPGO_KEEP_0__은 업데이트할 장치들을 결정할 수 없습니다. min_update_version is null, so Capgo cannot decide which devices should update.

해당 규칙에 대한 미비한 설정을 채우거나 더 간단한 자동 업데이트 모드를 전환하세요.

제목 ‘NoChannelOrOverride’

NoChannelOrOverride

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

무엇을 할까요

대시보드에서 기본 채널을 설정하거나

빌드에서 구성하세요. defaultChannel 배포본 전송 및 암호화

__CAPGO_KEEP_0__

Capgo이 패키지를 제공하거나 암호화할 수 없을 때 백엔드 거부.

cannotGetBundle

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

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

이것을 어떻게 해야 합니까?

패키지를 다시 업로드하고 매니페스트를 재생성하고 R2 또는 공개 패키지 설정을 확인하세요.

missingBundle

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

채널에 할당된 패키지가 다운로드할 수 있는 콘텐츠가 없습니다: external_url__CAPGO_KEEP_0__이 없으며 r2_path__CAPGO_KEEP_0__이 없으며

무엇을 해야 하나요

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

keyMismatch

무엇을 의미하는가

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

무엇을 해야 하나요

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

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

앱 구성 또는 업데이터 버전이 지원되지 않는 경우 백엔드가 거부하는 경우

customIdBlocked

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

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

무엇을 해야 합니까?

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

blocked_by_server_url

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

server.url Capacitor 설정에서 지정된 URL로 WebView가 로컬 번들 파일 대신 로드되도록 설정되어 있습니다. Capgo 라이브 업데이트에는 로컬 파일이 필요하고 server.url 이것은 __CAPGO_KEEP_0__ 프로덕션 빌드에서 사용하지 않는 것이 좋습니다.

무엇을 해야 합니까?

프로덕션 빌드에서는 제거하거나 __CAPGO_KEEP_0__ 업데이트 패킷을 로컬에 유지하십시오. 이 __CAPGO_KEEP_0__는 백엔드 거부 또는 장치 측면의 통계로 나타날 수 있습니다. 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

__CAPGO_KEEP_0__를 업그레이드하여 __CAPGO_KEEP_1__ v5+와 함께 v8을 선호하는 업그레이드합니다.

__CAPGO_KEEP_0__를 업그레이드하여 __CAPGO_KEEP_1__ v5+와 함께 v8을 선호하는 업그레이드합니다.

업데이트 라이프 사이클

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

기본 업데이트 흐름, 활성화 및 롤백을 위한 디바이스 사이드 이벤트.

업데이트를 위한 디바이스의 상태를 확인하는 내부 테스트 액션입니다.

ping

업데이트를 위한 디바이스의 상태를 확인하는 내부 테스트 액션입니다.

업데이트를 위한 디바이스의 상태를 확인하는 내부 테스트 액션입니다.

get

업데이트를 위한 디바이스의 상태를 확인하는 내부 테스트 액션입니다.

Capgo는 새로운 버전의 다운로드 정보를 기기에게 보냈습니다.

set

이것이 무엇을 의미하는가

기기에 번들 활성화가 이루어졌습니다.

set_fail

이것이 무엇을 의미하는가

무엇을 해야 하나요

기기 내 네이티브 로그를 확인하고

번들完整성, 경로 및 npx @capgo/cli@latest app debug 흐름을 확인하세요. notifyAppReady 설정 초기화

reset

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__

delete

__CAPGO_KEEP_0__

__CAPGO_KEEP_2__

__CAPGO_KEEP_3__

__CAPGO_KEEP_1__

download_0

__CAPGO_KEEP_5__

__CAPGO_KEEP_1__

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

__CAPGO_KEEP_0__

__CAPGO_KEEP_1__

download_complete

__CAPGO_KEEP_3__

__CAPGO_KEEP_4__

download_manifest_start

__CAPGO_KEEP_6__

__CAPGO_KEEP_7__

download_manifest_complete

__CAPGO_KEEP_9__

__CAPGO_KEEP_10__

download_zip_start

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

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

download_zip_complete

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

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

download_manifest_file_fail

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

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

무엇을 해야 합니까?

누락된 또는 차단된 자산을 수정하고 매니페스트를 재생성한 후 번들을 다시 업로드하세요.

download_manifest_checksum_fail

이것은 무슨 뜻인가요?

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

무엇을 해야 하나요?

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

download_manifest_brotli_fail

이것은 무슨 뜻인가요?

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

무엇을 해야 하나요?

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

download_fail

이것은 무슨 뜻인가요?

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

무엇을 할까요

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

update_fail

무엇을 의미하는가

배포는 성공했지만 앱이 호출하지 않았습니다. notifyAppReady따라서 Capgo이 롤백되었습니다.

무엇을 할까요

호출 notifyAppReady() 앱이 부트스트래핑을 마치면 호출하세요. notifyAppReady was not called, roll back current bundle maps to this code.

checksum_fail

__CAPGO_KEEP_0__

다운로드 한 배포본이 체크섬 검증을 통과하지 못했습니다. 일반적인 원인: CRC32 vs SHA256이 오래된 CLI 업로드에서 일치하지 않거나, 암호화 키가 오래된 플러그인에서 암호화 실패를 체크섬 실패로 표면화하는 경우입니다.

__CAPGO_KEEP_0__

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

decrypt_fail

__CAPGO_KEEP_0__

암호화 키를 확인하고 재 업로드 한 배포본과 일치하는 키 pair를 사용하세요.

__CAPGO_KEEP_0__

다운로드 한 배포본이 윈도우 경로를 찾을 수 없습니다.

windows_path_fail

다운로드 한 배포본이 윈도우 경로를 찾을 수 없습니다.

__CAPGO_KEEP_0__

__CAPGO_KEEP_1__

__CAPGO_KEEP_2__

canonical_path_fail

__CAPGO_KEEP_4__

__CAPGO_KEEP_5__

__CAPGO_KEEP_6__

__CAPGO_KEEP_7__

directory_path_fail

__CAPGO_KEEP_9__

__CAPGO_KEEP_10__

__CAPGO_KEEP_11__

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

unzip_fail

이것이 무엇을 의미하는지

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

무엇을 해야 하나요

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

low_mem_fail

이것이 무엇을 의미하는지

다운로드가 실패한 이유는 장치의 메모리가 부족했기 때문입니다.

무엇을 해야 하나요

배포본의 크기를 줄이거나 메모리가 충분한 장치에서 다시 시도하세요.

앱의 상태와 WebView 이벤트

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

app_moved_to_background

앱이 백그라운드에 들어간다는 의미

앱이 전면으로 이동했다는 의미

app_moved_to_foreground

앱이 충돌했다는 의미

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

app_crash

무엇을 해야 하나요?

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

무엇을 해야 하나요?

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

app_crash_native

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

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

무엇을 해야 합니까?

Xcode 또는 Logcat 충돌 로그를 사용하여 메타데이터의 활성 번들을 상관관계화하십시오.

app_anr

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

안드로이드 애플리케이션 응답이 중단된 이벤트.

무엇을 해야 합니까?

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

app_killed_low_memory

What it means

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

What to do

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

app_killed_excessive_resource_usage

OS가 앱을 과도한 리소스 사용으로 죽였다.

What to do

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

app_initialization_failure

app_initialization_failure

업데이터 또는 런타임이 준비되기 전에 실패했다.

What to do

무엇을 해야 하나요

실패한 단계와 오류 메시지를 확인하세요.

app_memory_warning

이게 무슨 뜻인가요

iOS 메모리 경고.

무엇을 해야 하나요

업데이트 후 메모리 사용량을 줄이기 위해 메타데이터의 메모리 컨텍스트를 확인하세요.

webview_javascript_error

이게 무슨 뜻인가요

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

무엇을 해야 하나요

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

webview_unhandled_rejection

이것은 무슨 뜻인가요?

WebView에서 처리되지 않은 약속 거부입니다.

무엇을 해야 하나요?

JS와 네이티브 에러 리포팅을 사용하여 비동기 실패를 캡처하세요.

webview_resource_error

이것은 무슨 뜻인가요?

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

무엇을 해야 하나요?

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

webview_security_policy_violation

이것은 무슨 뜻인가요?

내용 보안 정책으로 인해 리소스가 차단되었습니다.

무엇을 할까요?

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

webview_unclean_restart

무엇을 의미하는가

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

무엇을 할까요?

재시작 전후에 충돌 및 웹뷰 오류 이벤트와 관련시켜 보세요.

webview_render_process_gone

무엇을 의미하는가

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

무엇을 할까요?

__CAPGO_KEEP_0__을 사용하여 렌더러 충돌 신호를 메타데이터 및 네이티브 로그에서 검사합니다.

webview_content_process_terminated

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

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

무엇을 해야 합니까?

__CAPGO_KEEP_0__을 사용하여 활성 번들 및 페이지 URL을 메타데이터에서 검사합니다.

환경 및 채널 컨텍스트

디바이스 측면의 컨텍스트 이벤트가 OS, 네이티브 버전 또는 채널 변경과 관련된 업데이트 동작을 도와줍니다.

os_version_changed

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

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

native_app_version_changed

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__ 버전이 변경되었습니다. native vs web bundle 변경을 구분하기 위해.

getChannel

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__의 현재 채널을 확인했습니다.

setChannel

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__의 채널이 성공적으로 설정되었습니다.

uninstall

__CAPGO_KEEP_0__

Capgo이 삭제되거나 데이터가 지워졌습니다.

Bundle 상태

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

디바이스 로그 이해

디버그 명령어

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

npx @capgo/cli@latest app debug

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

iOS 원시 로그

Xcode에서 로그를 찾기 위해

Xcode에서 장치 로그 가져오기

Android 원시 로그

Android Studio에서 로그를 찾기 위해

로그캣으로 로그 보기

원시 로그 단어 매핑

• Failed to download from maps to download_fail
• notifyAppReady was not called, roll back current bundle maps to update_fail

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

iOS

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

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

Xcode Window 메뉴에서 Devices와 Simulators를 선택하세요.

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

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

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

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

앱이 재부팅된 후에는 2개의 폴더에 버전이 있습니다.

library/NoCloud/ionic_built_snapshots __CAPGO_KEEP_0__

그리고 documents/versions 핫 리로드를 위해

안드로이드

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

• 보기 > 도구 창 > 장치 파일 탐색기 또는 도구 창 바의 장치 파일 탐색기 버튼을 클릭하여 장치 파일 탐색기를 열어 주세요.
• 장치 목록에서 장치를 선택하세요.
• 경로를 열어 주세요. APP_NAME은 앱 ID입니다. 안드로이드 스튜디오 장치 파일 탐색기에서 앱 데이터 디렉토리를 보여줍니다. APP_NAME

그런 다음 versions 모든 버전을 확인하기 위해 폴더를 찾으세요

알고 계셨나요?

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

IOS 프로덕션 크래시 로그 이해하기

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

Debugging에서 계속 진행하세요

Debugging에서 계속 진행하세요 Capgo를 사용하고 계신가요? native 플러그인 작업을 계획하기 위해, 그것을 연결하세요. @capgo/capacitor-업데이터를 사용하여 @capgo/capacitor-업데이터를 사용하여 native 기능을 사용하는 경우, Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리에서 제품 워크플로우를 사용하는 경우, Capacitor 플러그인들에 의해 Capgo Capacitor 플러그인들에 의해 Capgo에서 구현 세부 정보를 사용하는 경우, 플러그인을 추가하거나 업데이트 플러그인을 추가하거나 업데이트하는 구현 세부 정보를 사용하는 경우, Ionic Enterprise 플러그인 대체품 Ionic Enterprise 플러그인 대체품을 사용하는 제품 워크플로우를 사용하는 경우,