콘텐츠로 건너뛰기

デバッグ

클라우드 로그 이해하기:

백엔드에서 전송됨

code설명
InvalidIp사용자가 Google 데이터 센터에 위치해 있고 업데이트가 4시간 미만인 경우입니다. 이는 Google 봇 기기가 계정의 기기로 집계되는 것을 방지하기 위함입니다
needPlanUpgrade (이전의 needUpgrade)플랜 한도에 도달했으며, 업그레이드하거나 다음 달까지 기기가 업데이트를 받지 못함을 나타냅니다
noNew기기가 최신 버전을 사용 중입니다
disablePlatformIos기기가 iOS 플랫폼이지만 채널 설정에서 비활성화되어 있습니다
disablePlatformAndroid기기가 Android 플랫폼이지만 채널 설정에서 비활성화되어 있습니다
disableAutoUpdate”major"
disableAutoUpdateUnderNative기기가 버전(123)을 가지고 있고, 채널에 기기 버전 아래의 업데이트(122)가 있지만 채널 설정에서 비활성화되어 있습니다
disableDevBuild기기가 개발 빌드이지만 채널 설정에서 비활성화되어 있습니다
disableEmulator기기가 에뮬레이터이지만 채널 설정에서 비활성화되어 있습니다

기기에서 전송됨

code설명
get새 버전 다운로드 정보가 기기로 전송되었습니다
delete기기에서 번들이 삭제되었습니다
set기기에 번들이 설정되었습니다
set_fail번들 설정에 실패했습니다
reset기기가 builtin 번들로 초기화되었습니다
download_XX새 번들이 다운로드되었습니다 - XX%로 진행률 표시 (10% 단위로 증가)
download_complete새 번들 다운로드가 완료되었습니다
download_fail새 번들 다운로드에 실패했습니다
update_fail새 번들이 설치되었지만 notifyAppReady 호출에 실패했습니다
checksum_fail새 번들의 체크섬 검증에 실패했습니다
windows_path_failzip 파일에 잘못된 Windows 경로가 포함되어 있습니다
canonical_path_fail파일 경로가 정규화되지 않았습니다
directory_path_failzip 파일 경로에 오류가 있습니다
unzip_fail압축 해제에 실패했습니다
low_mem_fail기기의 메모리 부족으로 다운로드에 실패했습니다

번들 상태

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

기기 로그 이해하기:

디버그 명령어:

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

Terminal window
npx @capgo/cli@latest app debug

이를 통해 앱에서 발생하는 모든 이벤트를 확인하고 업데이트가 되지 않는 경우 해결책을 찾을 수 있습니다

IOS

Xcode에서 로그를 찾는 방법

Android:

Android Studio에서 로그를 찾는 방법

로그 설명

  • Failed to download from => download_fail과 동일
  • notifyAppReady was not called, roll back current bundle => update_fail과 동일

기기에서 다운로드된 번들 찾기

iOS

iOS에서 디버깅하려면 앱을 컴퓨터에 덤프해야 합니다. 다음과 같이 할 수 있습니다:

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

이를 위해:

  1. 기기를 Mac에 연결하고 Xcode 메뉴바에서 Window > Devices를 선택합니다
  2. Devices 섹션에서 왼쪽 창에 있는 기기를 선택합니다
  3. 해당 기기에 대한 개발자 설치 앱 목록이 표시됩니다
  4. 검사하려는 앱을 선택한 다음 화면 하단의 기어 아이콘을 선택합니다
  5. 여기서 Show Container를 선택하여 현재 파일 시스템을 보거나 스냅샷을 다운로드할 수 있습니다

Download Container를 선택하면 xcappdata 파일로 파일 시스템의 스냅샷을 다운로드하고 내보냅니다

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

App Data 폴더를 열면 Documents, Library, tmp 등의 폴더가 보입니다

image

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

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

그리고 documents/versions는 핫 리로드용입니다

Android

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

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

image

그런 다음 versions 폴더에서 모든 버전을 확인할 수 있습니다

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