デバッグ
클라우드 로그 이해하기:
Section titled “클라우드 로그 이해하기:”백엔드에서 전송됨
Section titled “백엔드에서 전송됨”| code | 설명 |
|---|---|
| InvalidIp | 사용자가 Google 데이터 센터에 위치해 있고 업데이트가 4시간 미만인 경우입니다. 이는 Google 봇 기기가 계정의 기기로 집계되는 것을 방지하기 위함입니다 |
| needPlanUpgrade (이전의 needUpgrade) | 플랜 한도에 도달했으며, 업그레이드하거나 다음 달까지 기기가 업데이트를 받지 못함을 나타냅니다 |
| noNew | 기기가 최신 버전을 사용 중입니다 |
| disablePlatformIos | 기기가 iOS 플랫폼이지만 채널 설정에서 비활성화되어 있습니다 |
| disablePlatformAndroid | 기기가 Android 플랫폼이지만 채널 설정에서 비활성화되어 있습니다 |
| disableAutoUpdate | ”major" |
| disableAutoUpdateUnderNative | 기기가 버전(123)을 가지고 있고, 채널에 기기 버전 아래의 업데이트(122)가 있지만 채널 설정에서 비활성화되어 있습니다 |
| disableDevBuild | 기기가 개발 빌드이지만 채널 설정에서 비활성화되어 있습니다 |
| disableEmulator | 기기가 에뮬레이터이지만 채널 설정에서 비활성화되어 있습니다 |
기기에서 전송됨
Section titled “기기에서 전송됨”| code | 설명 |
|---|---|
| get | 새 버전 다운로드 정보가 기기로 전송되었습니다 |
| delete | 기기에서 번들이 삭제되었습니다 |
| set | 기기에 번들이 설정되었습니다 |
| set_fail | 번들 설정에 실패했습니다 |
| reset | 기기가 builtin 번들로 초기화되었습니다 |
| download_XX | 새 번들이 다운로드되었습니다 - XX%로 진행률 표시 (10% 단위로 증가) |
| download_complete | 새 번들 다운로드가 완료되었습니다 |
| download_fail | 새 번들 다운로드에 실패했습니다 |
| update_fail | 새 번들이 설치되었지만 notifyAppReady 호출에 실패했습니다 |
| checksum_fail | 새 번들의 체크섬 검증에 실패했습니다. Capgo Cloud를 사용하고 이 오류가 발생하는 경우, 일반적으로 앱 버전이 다른 체크섬 유형을 기대하고 있음을 의미합니다. 최신 버전의 CLI 및 플러그인(버전 6.25.0 또는 7+)은 SHA256 체크섬을 사용하지만 이전 플러그인은 CRC32를 사용했습니다. 체크섬 실패가 표시되면 체크섬이 SHA256이 아닌 CRC32(더 짧은 해시)인지 확인하세요. 이는 일반적으로 오래된 버전의 CLI로 번들이 업로드되었음을 나타냅니다. Capgo 대시보드에서 번들 버전을 확인하세요 - 버전 6.25.0/7 이후로 생성된 번들은 SHA256을 사용해야 합니다. CRC32 체크섬이 표시되면 최신 플러그인 버전이 로컬에 설치되어 있는지 확인하세요(CLI는 로컬 플러그인 버전을 확인하여 업로드할 체크섬 유형을 결정합니다), 그런 다음 CLI를 업그레이드하고 번들을 다시 업로드하세요. |
| windows_path_fail | zip 파일에 잘못된 Windows 경로가 포함되어 있습니다 |
| canonical_path_fail | 파일 경로가 정규화되지 않았습니다 |
| directory_path_fail | zip 파일 경로에 오류가 있습니다 |
| unzip_fail | 압축 해제에 실패했습니다 |
| low_mem_fail | 기기의 메모리 부족으로 다운로드에 실패했습니다 |
SUCCESS: 번들 설치 완료ERROR: 설치 또는 다운로드 실패PENDING: 다운로드 완료, 배포 대기 중DELETED: 번들 삭제됨, 통계를 위해 표시됨DOWNLOADING: 현재 번들 다운로드 중
기기 로그 이해하기:
Section titled “기기 로그 이해하기:”디버그 명령어:
Section titled “디버그 명령어:”Capgo 클라우드 사용자를 위한 디버그 명령어가 있습니다
npx @capgo/cli@latest app debug이를 통해 앱에서 발생하는 모든 이벤트를 확인하고 업데이트가 되지 않는 경우 해결책을 찾을 수 있습니다
Xcode에서 로그를 찾는 방법
Android:
Section titled “Android:”Android Studio에서 로그를 찾는 방법
Failed to download from=> download_fail과 동일notifyAppReady was not called, roll back current bundle=> update_fail과 동일
기기에서 다운로드된 번들 찾기
Section titled “기기에서 다운로드된 번들 찾기”iOS에서 디버깅하려면 앱을 컴퓨터에 덤프해야 합니다. 다음과 같이 할 수 있습니다:
Xcode에는 iOS 기기에 개발자가 설치한 앱의 파일 시스템을 검사하는 기능이 내장되어 있습니다
이를 위해:
- 기기를 Mac에 연결하고 Xcode 메뉴바에서 Window > Devices를 선택합니다
- Devices 섹션에서 왼쪽 창에 있는 기기를 선택합니다
- 해당 기기에 대한 개발자 설치 앱 목록이 표시됩니다
- 검사하려는 앱을 선택한 다음 화면 하단의 기어 아이콘을 선택합니다
- 여기서 Show Container를 선택하여 현재 파일 시스템을 보거나 스냅샷을 다운로드할 수 있습니다
Download Container를 선택하면 xcappdata 파일로 파일 시스템의 스냅샷을 다운로드하고 내보냅니다
이 파일을 우클릭하고 Show Package Contents를 선택하여 폴더를 엽니다
App Data 폴더를 열면 Documents, Library, tmp 등의 폴더가 보입니다
그런 다음 2개의 폴더에서 버전을 찾을 수 있습니다:
library/NoCloud/ionic_built_snapshots는 앱 재부팅 후 필요합니다
그리고 documents/versions는 핫 리로드용입니다
Android
Section titled “Android”Android에서 디버깅하려면 Android Studio에서 기기에 접근해야 합니다:
- View > Tool Windows > Device File Explorer를 클릭하거나 도구 창 바에서 Device File Explorer 버튼을 클릭하여 Device File Explorer를 엽니다
- 드롭다운 목록에서 기기를 선택합니다
- data/data/APP_NAME/ 경로를 엽니다. 여기서 APP_NAME은 앱 ID입니다
그런 다음 versions 폴더에서 모든 버전을 확인할 수 있습니다