Understanding cloud logs:
Sent from the backend
|InvalidIp||The user is located in a Google data center and the update is less than 4 hours old. This is done to prevent Google bots’ devices from counting as devices in your account.|
|needPlanUpgrade (previously needUpgrade)||Indicates that you have reached the limit of your plan, and the device will not receive updates until you upgrade or until the next month.|
|noNew||The device has the latest available version.|
|disablePlatformIos||The device is on the iOS platform, but that is disabled in the channel settings.|
|disablePlatformAndroid||The device is on the Android platform, but that is disabled in the channel settings.|
|disableAutoUpdateToMajor||The device has version (|
|disableAutoUpdateUnderNative||The device has version (|
|disableDevBuild||The device has a dev build, but that is disabled in the channel settings.|
|disableEmulator||The device is an emulator, but that is disabled in the channel settings.|
Sent from the device
|get||Info for downloading the new version has been sent to the device.|
|delete||One bundle has been deleted on the device.|
|set||A bundle has been set on the device.|
|set_fail||The bundle failed to set.|
|reset||The device reset to the |
|download_XX||A new bundle has been downloaded - progress indicated by XX% (increments of 10%).|
|download_complete||The new bundle has finished downloading.|
|download_fail||The new bundle failed to download.|
|update_fail||The new bundle has been installed but failed to call |
|checksum_fail||The new bundle failed to validate the checksum.|
SUCCESS: install bundle done
ERROR: install or download failed
PENDING: Download done, pending release
DELETED: Bundle deleted still present for stats
DOWNLOADING: Currently downloading a bundle
Understanding device logs:
There is a debug command for Capgo cloud users.
npx @capgo/cli@latest app debug
This will allow you to check all event happening in app and find solution if update don’t happen.
to find your logs on Xcode
to find your logs on Android studio
Failed to download from=> same as download_fail
notifyAppReady was not called, roll back current bundle=> same as as update_fail
Finding the downloaded bundle in your device
To debug on iOS, you need to dump the app on your computer, you can do it like that :
Xcode has a built-in feature for inspecting the file system of developer installed apps on an iOS device.
To achieve this:
- Connect your device to your Mac and select Window > Devices in the Xcode menubar.
- Select your device in the left pane under the Devices section.
- This will show a list of developer installed apps for that device.
- Select the app you want to inspect and then the select the gear icon near the bottom of the screen.
- Here you can view the current file system by selecting Show Container or download a snapshot of it.
Selecting Download Container… will download and export a snapshot of the file system as a .xcappdata file that you can browse through.
Right-click on this file and select Show Package Contents to open the folder.
Open the App Data folder, and you should now see a few folders like Documents, Library, tmp, etc.
Then you will find version in 2 folders:
library/NoCloud/ionic_built_snapshots who is necessary after app reboot
documents/versions for hot reload
To debug on Android, you need to access the device from Android Studio:
- 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.
- Open the path data/data/APP_NAME/ where APP_NAME is your app ID.
Then Find the
versions folder to see all the folder versions