Debugging
이 플러그인의 설치 단계와 전체 마크다운 가이드를 포함한 설정 지시서를 복사하세요.
클라우드 로그 이해:
클라우드 로그 이해:클라우드 거부 code이 발생하고 구체적인 개선 단계가 필요하다면, 일반 업데이트 문제.
Capgo 로그에는 이벤트에 대한 메타데이터가 포함될 수 있습니다. 대시보드에서 액션 필터를 사용하여 code 아래에 나열된 스네이크 케이스 액션으로 필터링하고 메타데이터 셀을 클릭하여 전체 JSON 페이로드를 복사하세요. 메타데이터는 특히 오류 메시지, 소스 URL, 라인, 열, 프로세스 상태, 메모리 압박 또는 플랫폼에 종속된 이유와 같은 컨텍스트를 포함하는 크래시 및 WebView 이벤트에 특히 유용합니다. 이전 로그도 여전히 레거시 camelCase 별칭을 포함하는 괄호로 표시됩니다.
백엔드에서 전송됨
백엔드에서 전송됨| code | 설명 |
|---|---|
| invalid_ip (유효하지 않은 IP) | Google 데이터 센터에 사용자가 위치하고 업데이트가 4시간 이내일 경우에 이 작업을 수행합니다. Google 봇의 장치가 사용자의 계정에 포함되지 않도록 하기 위함입니다. |
| need_plan_upgrade (needPlanUpgrade, 이전에 needUpgrade) | 계획의 제한을 초과하였으며, 장치가 업그레이드 또는 다음 달까지 업데이트를 받지 못합니다. |
| no_new_version_available (noNew) | 최신 버전이 설치되어 있습니다. |
| semver_error | 예상되는 시맨틱 버전 형식에 맞지 않는 네이티브 버전입니다. |
| disabled_platform_ios (iOS 플랫폼이 비활성화되었습니다.) | iOS 플랫폼이 설정된 채널에서 비활성화되어 있습니다. |
| Android 플랫폼이 비활성화되었습니다. (Android 플랫폼이 설정된 채널에서 비활성화되어 있습니다.) | 자동 업데이트 정책으로 인해 자동 업데이트 기능이 비활성화되었습니다. |
| 자동 업데이트 기능이 비활성화되었습니다. 메타데이터는 (와 같은 규칙과 일치합니다.) | 또는 auto_update 자동 업데이트 기능이 Native 앱에서 비활성화되었습니다. major, minor, patch, metadata__CAPGO_KEEP_0__ none. |
| __CAPGO_KEEP_0__ (__CAPGO_KEEP_0__) | __CAPGO_KEEP_0__ 버전이 있고, __CAPGO_KEEP_1__ 채널은 __CAPGO_KEEP_0__ 버전보다 업데이트가 있습니다. 하지만 채널 설정에서 업데이트를 비활성화했습니다.1.2.3__CAPGO_KEEP_2__1.2.2__CAPGO_KEEP_2__ |
| __CAPGO_KEEP_3__ (__CAPGO_KEEP_4__) | __CAPGO_KEEP_5__ |
| __CAPGO_KEEP_6__ 채널 설정에서 개발 빌드를 비활성화했습니다. (__CAPGO_KEEP_7__) | __CAPGO_KEEP_7__ |
| __CAPGO_KEEP_8__는 유효한 서명 URL을 생성할 수 없습니다. 이는 __CAPGO_KEEP_8__ URL 생성이 실패하거나 유효하지 않은 URL을 반환할 때 발생하며, 대체로 매니페스트가 없을 때 발생합니다. (__CAPGO_KEEP_9__) | __CAPGO_KEEP_10__ |
| 개인 채널을 통해 업데이트할 수 없습니다 (cannotUpdateViaPrivateChannel) | 장치가 개인 채널과 자체 연관을 시도했지만, 채널 설정은 장치 자체 연관을 허용하지 않으며 (allow_device_self_set is false) 채널이 공개적이지 않습니다. |
| 채널 설정이 잘못되었습니다 (channelMisconfigured) | 버전 번호 (disable_auto_update: 'version_number')에 의한 자동 업데이트 기능이 비활성화되어 있지만, 업데이트 패키지의 min_update_version field는 null로 설정되어 있어, 업데이트를 받을 장치의 버전을 확인할 수 없습니다. |
| disable_auto_update_to_metadata (disableAutoUpdateMetadata) | 버전 번호 메타데이터에 의한 자동 업데이트 기능이 비활성화되어 있습니다. 채널은 장치의 버전이 최소로 설정되어야 합니다. min_update_version__CAPGO_KEEP_0__ |
| 메이저 버전 업데이트를 차단합니다. (disableAutoUpdateToMajor) | 메이저 버전 업데이트를 차단합니다. disable_auto_update: 'major' 채널 설정 1.x.x 메이저 버전 업데이트를 차단합니다. 예를 들어 __CAPGO_KEEP_0__ 2.x.x. |
| __CAPGO_KEEP_0__ (메이저 버전 업데이트를 차단합니다.) | 채널 설정 disable_auto_update: 'minor' 메이저 버전 업데이트를 차단합니다. 예를 들어 __CAPGO_KEEP_0__ 1.2.x __CAPGO_KEEP_0__ 1.3.x. |
| 메이저 버전 업데이트를 차단합니다. (disableAutoUpdateToPatch) | 채널 설정 disable_auto_update: 'patch' patch 버전 번호를 증가시키는 업데이트를 차단하거나, 동일한 major.minor 버전 내에서 패치 수준 업데이트만 허용합니다. |
| missing_bundle (missingBundle) | assign된 채널이 다운로드 가능한 콘텐츠가 없는 것으로 지정되어 있습니다. 이는 채널이 내장 버전이 아니며, 다운로드 가능한 매니페스트 항목이 없기 때문입니다. external_urlno r2_pathno |
| it is not a built-in version, and there are no manifest entries available for download. (no_channel) | NoChannelOrOverride |
| 이 앱과 장치에 대한 기본 채널이 구성되어 있지 않고, 장치에 채널 오버라이드가 지정되어 있지 않습니다. 업데이트가 작동하려면 적어도 하나가 필요합니다. (__CAPGO_KEEP_0__) | __CAPGO_KEEP_0__ |
| key_id_mismatch (keyMismatch) | __CAPGO_KEEP_1__ device_key_id, bundle_key_id__CAPGO_KEEP_1__ version __CAPGO_KEEP_2__ |
__CAPGO_KEEP_2__
__CAPGO_KEEP_3__| code | __CAPGO_KEEP_4__ |
|---|---|
| __CAPGO_KEEP_4__ | __CAPGO_KEEP_0__ 시스템이 정상적으로 작동하는지 확인하기 위해 내부 테스트 액션을 사용합니다. |
| get | __CAPGO_KEEP_0__에 대한 다운로드 정보가 기기로 전송되었습니다. |
| delete | 기기에 하나의 번들만 삭제되었습니다. |
| set | 기기에 번들이 설정되었습니다. |
| set_fail | 번들이 설정되지 못했습니다. |
| reset | 기기는 "__CAPGO_KEEP_0__"로 리셋되었습니다. builtin bundle |
| 다운로드_XX | XX%로 표시되는 XX%의 진행률로 새로운 버블이 다운로드되었습니다. |
| 다운로드 완료 | 새로운 버블이 다운로드가 완료되었습니다. |
| 업데이트 매니페스트 다운로드 시작 | 디바이스가 업데이트 매니페스트 다운로드를 시작했습니다. |
| 업데이트 매니페스트 다운로드 완료 | 디바이스가 업데이트 매니페스트 다운로드를 완료했습니다. |
| 배달 아카이브 다운로드 시작 | 디바이스가 배달 아카이브 다운로드를 시작했습니다. |
| 배달 아카이브 다운로드 완료 | 디바이스가 배달 아카이브 다운로드를 완료했습니다. |
| 다운로드 매니페스트 파일 실패 | 한 개 이상의 매니페스트 항목이 다운로드되지 않았습니다; stats 페이로드는 version_name 형식으로 version:fileName 자산을 식별하기 위해. |
| 다운로드 매니페스트 체크섬 실패 | 매니페스트 파일이 체크섬 검증에 실패했습니다. |
| 다운로드 매니페스트 브로틀리 실패 | 매니페스트 파일이 브로틀리 압축 해제에 실패했습니다. |
| 새로운 번들 다운로드 실패 | 새로운 번들이 설치되었지만 호출에 실패했습니다. |
| 업데이트 실패 | 새로운 번들이 설치되었지만 호출에 실패했습니다. notifyAppReady. |
| 체크섬 실패 | 새로운 번들에 체크섬이 유효하지 않습니다. 여러 가지 이유로 발생할 수 있습니다. 1) 체크섬 타입 불일치: CLI의 최신 버전과 플러그인 (버전 5.10.0+, 6.25.0+ 또는 7+)은 SHA256 체크섬을 사용하지만, 이전 버전의 플러그인은 CRC32을 사용합니다. 체크섬 실패를 보게 되면 체크섬이 CRC32(짧은 해시)인지 SHA256인지 확인하세요. 일반적으로 번들이 업로드된 CLI의 이전 버전일 때 발생합니다. Capgo 대시보드에서 번들의 버전을 확인하세요 - 버전 5.10.0/6.25.0/7 이후로 업로드된 번들은 SHA256을 사용합니다. CRC32 체크섬을 보게 되면 CLI에서 로컬 플러그인 버전을 확인하여 업로드할 체크섬 타입을 결정하고, CLI을 업그레이드하고 번들을 다시 업로드하세요. 2) 암호화 키 불일치 (플러그인 버전 8.3.0 또는 5/6/7.38.0 미만): 플러그인 버전이 이전 버전일 때, 장치의 공개 키와 암호화된 번들의 키가 일치하지 않으면, 암호화가 실패하고 체크섬 실패를 발생시킵니다. 암호화를 사용하고 체크섬 실패를 보게 되면, __CAPGO_KEEP_4__의 공개 키가 __CAPGO_KEEP_5__에 업로드한 개인 키와 일치하는지 확인하세요. 플러그인 버전을 8.3.0+ (또는 5/6/7.38.0+)로 업그레이드하면, 서버에서 올바른 에러 메시지를 반환하여 이 문제를 더 쉽게 진단할 수 있습니다. checksum_fail윈도우즈 경로 실패 capacitor.config.json zip에 포함된 파일이 윈도우즈 경로를 포함하고 있습니다. keyMismatch 캐노니컬 경로 실패 |
| __CAPGO_KEEP_0__ | __CAPGO_KEEP_1__ |
| __CAPGO_KEEP_2__ | 파일 경로가 정규화되지 않았습니다. |
| __CAPGO_KEEP_0__ | 압축 파일 경로에 오류가 있습니다. |
| __CAPGO_KEEP_1__ | 압축 해제 실패 |
| __CAPGO_KEEP_2__ | 기기 내의 메모리가 부족하여 다운로드가 실패했습니다. |
| __CAPGO_KEEP_3__ | 앱이 백그라운드 상태로 전환되었습니다. |
| __CAPGO_KEEP_4__ | 앱이 전면 상태로 전환되었습니다. |
| __CAPGO_KEEP_5__ | Capacitor layer에서 JavaScript 또는 Capacitor layer에서 발생한 충돌이 보고되었습니다. 메타데이터에는 메시지, 스택, 소스 및 활성 번들 컨텍스트가 포함될 수 있습니다. |
| app_crash_native | __CAPGO_KEEP_0__ layer에서 플랫폼 충돌이 보고되었습니다. 메타데이터에는 플랫폼, 이유, 스택 및 프로세스 세부 정보가 포함될 수 있습니다. |
| app_anr | Android에서 Application Not Responding 이벤트가 보고되었습니다. 메타데이터에는 ANR 이유, 스레드 또는 트레이스 요약이 포함될 수 있습니다. |
| app_killed_low_memory | __CAPGO_KEEP_0__ 프로세스가 낮은 메모리 압박 후 종료되었습니다. 메타데이터에는 사용 가능한 메모리 및 플랫폼 신호가 포함될 수 있습니다. |
| app_killed_excessive_resource_usage | OS가 __CAPGO_KEEP_0__의 과도한 리소스 사용으로 인해 종료되었습니다. 메타데이터에는 리소스 유형 또는 플랫폼 이유가 포함될 수 있습니다. |
| app_initialization_failure | 업데이터 또는 앱 시작 흐름이 정상 런타임이 준비되기 전에 실패했습니다. 메타데이터에는 실패한 단계 및 오류 메시지가 포함될 수 있습니다. |
| app_memory_warning | iOS에서 메모리 경고가 발생했습니다. 메타데이터에는 활성 번들 및 메모리 컨텍스트가 포함될 수 있습니다. |
| __CAPGO_KEEP_0__ | 웹뷰에서 JavaScript 오류가 발생했습니다. 메타데이터에는 오류 메시지, 소스 URL, 라인, 열, 스택이 포함될 수 있습니다. |
| 웹뷰에서 미처 처리되지 않은 프라미스 거부가 발생했습니다. 메타데이터에는 거부 사유, 소스 URL, 스택이 포함될 수 있습니다. | 웹뷰 리소스가 로드되지 않았습니다. 메타데이터에는 URL, 상태 __CAPGO_KEEP_0__, 리소스 타입, 오류 메시지가 포함될 수 있습니다. |
| 웹뷰에서 콘텐츠 보안 정책 위반을 보고했습니다. 메타데이터에는 차단된 URI, 지시문, 문서 URL이 포함될 수 있습니다. | A WebView resource failed to load. Metadata can include the URL, status code, resource type, and error message. |
| 웹뷰 렌더링 프로세스가 종료되었습니다. | __CAPGO_KEEP_0__ |
| __CAPGO_KEEP_0__ | __CAPGO_KEEP_0__ |
| __CAPGO_KEEP_0__ | Android는 WebView 렌더러 프로세스가 종료되었다고 보고했습니다. 메타데이터에는 렌더러가 충돌했는지 여부와 렌더러 우선순위가 포함될 수 있습니다. |
| __CAPGO_KEEP_0__ | iOS는 WebView 콘텐츠 프로세스가 종료되었다고 보고했습니다. 메타데이터에는 활성 번들 및 페이지 URL이 있을 때 사용할 수 있습니다. |
| __CAPGO_KEEP_0__ | 다운로드한 번들이 암호화되지 않았습니다. |
| __CAPGO_KEEP_0__ (현재 장치의 채널을 조회했습니다.) | __CAPGO_KEEP_0__ |
| 장치에 채널을 성공적으로 설정했습니다. (__CAPGO_KEEP_0__) | 장치에서 채널을 제거했습니다. |
| __CAPGO_KEEP_0__ | The application was uninstalled or Capgo data cleared. |
| __CAPGO_KEEP_0__ blocked_by_server_url | capacitor config에 Server.url이 존재합니다. 이로 인해 Capacitor은 remote url을 serve하고 local 파일을 무시하게 되며, 우리의 업데이터는 local 파일과 작동하도록 설계되어 있습니다. Server.url은 Capacitor 제작자들에 의해 프로덕션에서 나쁜 관행으로 간주되고, 많은 문제와 플러그인이 올바르게 작동하지 않도록 할 수 있습니다. |
Bundle 상태
Bundle 상태SUCCESS: bundle 설치 완료ERROR: bundle 설치 또는 다운로드 실패PENDING: 다운로드 완료, pending releaseDELETED: Bundle 삭제, 통계를 위해 여전히 표시됨DOWNLOADING: 현재 bundle 다운로드 중
장치 로그 이해:
장치 로그 이해:Debug command:
Debug command:Capgo 클라우드 사용자에게는 디버그 명령어가 있습니다.
npx @capgo/cli@latest app debug앱 내에서 발생하는 모든 이벤트를 확인하고 업데이트가 이루어지지 않는 경우 해결책을 찾을 수 있도록 합니다.
IOS
IOSXcode에서 로그를 찾기 위해
Android:
Android:Android Studio에서 로그를 찾으세요
설명 로그
설명 로그Failed to download from=> 동일 다운로드 실패notifyAppReady was not called, roll back current bundle=> 동일 업데이트 실패
다운로드한 패키지를 장치에서 찾으세요
다운로드한 패키지를 장치에서 찾으세요iOS
iOSiOS에서 디버깅을 하려면, 앱을 컴퓨터에 덤프해야 합니다. 이처럼 할 수 있습니다.
iOS 기기에서 개발자 설치한 앱의 파일 시스템을 검사하는 Xcode 내장 기능이 있습니다.
이것을 달성하려면:
- Mac에 연결된 기기를 선택하고 Xcode 메뉴바의 Window > Devices를 선택합니다.
- 왼쪽 패널의 Devices 섹션 아래에 있는 기기를 선택합니다.
- 이것은 해당 기기의 개발자 설치한 앱 목록을 보여줍니다.
- 검사하고자 하는 앱을 선택하고 화면의 아래쪽에 있는 3개의 점 아이콘을 선택합니다.
- 현재 파일 시스템을 검사하려면 Download a snapshot of it을 선택합니다.
다운로드한 xcappdata 파일에서 Show Package Contents 컨텍스트 메뉴를 선택합니다.
이 파일을 오른쪽 클릭하고 Show Package Contents를 선택하여 폴더를 열어보세요.
애플리케이션 데이터 폴더를 열어보세요. 이제 문서, 라이브러리, tmp와 같은 몇 개의 폴더를 볼 수 있을 것입니다.
앱이 재부팅되면 2개의 폴더에서 버전을 찾을 수 있습니다:
library/NoCloud/ionic_built_snapshots 앱이 재부팅된 후 필요합니다.
핫 리로드를 위해 필요합니다. documents/versions Android
Android에서 디버깅을 하려면 Android Studio에서 장치에 접근해야 합니다:
View > Tool Windows > Device File Explorer를 클릭하거나 Tool Window Bar의 Device File Explorer 버튼을 클릭하여 Device File Explorer를 열어보세요.장치 목록에서 장치를 선택하세요.
- 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.
- Select a device from the dropdown list.
- __CAPGO_KEEP_0__ 경로를 열어주세요. __CAPGO_KEEP_0__는 앱 ID입니다. Android Studio Device File Explorer에서 앱 데이터 디렉토리를 보여주는 화면 그 다음
__CAPGO_KEEP_0__ versions __CAPGO_KEEP_0__
iOS 프로덕션 크래시 로그를 이해하는 방법
__CAPGO_KEEP_0__디버깅에서 계속
디버깅에서 계속디버깅을 사용하여 디버깅 자연 플러그인 작업을 계획하기 위해 @capgo/capacitor-업데이터 @capgo/capacitor-업데이터 Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리 Capacitor 플러그인들에 의해 Capgo Capacitor 플러그인들에 의해 Capgo 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트 구현 세부 사항에 대해, 및 아이오닉 엔터프라이즈 플러그인 대체 아이오닉 엔터프라이즈 플러그인 제품 워크플로에 대해.