Debugging

Understanding cloud logs:

code	Description
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.
disableAutoUpdate	”major"
disableAutoUpdateUnderNative	The device has version (`1.2.3`), and the channel has an update (`1.2.2`) under the device version to send, but that is disabled in the channel settings.
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.

code	Description
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 `builtin` bundle.
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 `notifyAppReady`.
checksum_fail	The new bundle failed to validate the checksum.
windows_path_fail	The zip has files who contain windows path who are illegal
canonical_path_fail	The path of files is not canonical
directory_path_fail	There is an error in the path of zip files
unzip_fail	unzip failed
low_mem_fail	Download failed because of low memory in the device

There is a debug command for Capgo cloud users.

npx @capgo/cli@latest app debug

This will allow you to check all events happening in the app and find a solution if updates 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

To debug on iOS, you need to dump the app on your computer, you can do it like this:

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 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 a version in 2 folders:

library/NoCloud/ionic_built_snapshots is necessary after the app reboot

and 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 versions