Debugging

Cloud-Logs verstehen:

Vom Backend gesendet

Code	Beschreibung
InvalidIp	Der Benutzer befindet sich in einem Google-Rechenzentrum und das Update ist weniger als 4 Stunden alt. Dies verhindert, dass Google-Bot-Geräte als Geräte in Ihrem Konto gezählt werden
needPlanUpgrade (früher needUpgrade)	Zeigt an, dass Sie das Limit Ihres Plans erreicht haben und das Gerät keine Updates erhält, bis Sie upgraden oder bis zum nächsten Monat
noNew	Das Gerät hat die neueste verfügbare Version
disablePlatformIos	Das Gerät läuft auf der iOS-Plattform, aber diese ist in den Kanaleinstellungen deaktiviert
disablePlatformAndroid	Das Gerät läuft auf der Android-Plattform, aber diese ist in den Kanaleinstellungen deaktiviert
disableAutoUpdate	”major"
disableAutoUpdateUnderNative	Das Gerät hat Version (123), und der Kanal hat ein Update (122) unter der Geräteversion zum Senden, aber dies ist in den Kanaleinstellungen deaktiviert
disableDevBuild	Das Gerät hat einen Dev-Build, aber dies ist in den Kanaleinstellungen deaktiviert
disableEmulator	Das Gerät ist ein Emulator, aber dies ist in den Kanaleinstellungen deaktiviert

Vom Gerät gesendet

Code	Beschreibung
get	Informationen zum Herunterladen der neuen Version wurden an das Gerät gesendet
delete	Ein Bundle wurde auf dem Gerät gelöscht
set	Ein Bundle wurde auf dem Gerät eingerichtet
set_fail	Das Bundle konnte nicht eingerichtet werden
reset	Das Gerät wurde auf das builtin-Bundle zurückgesetzt
download_XX	Ein neues Bundle wurde heruntergeladen - Fortschritt angezeigt durch XX% (in 10%-Schritten)
download_complete	Das neue Bundle wurde vollständig heruntergeladen
download_fail	Das neue Bundle konnte nicht heruntergeladen werden
update_fail	Das neue Bundle wurde installiert, konnte aber notifyAppReady nicht aufrufen
checksum_fail	Das neue Bundle konnte die Prüfsumme nicht validieren. Wenn Sie Capgo Cloud verwenden und diesen Fehler erhalten, bedeutet dies normalerweise, dass Ihre App-Version einen anderen Prüfsummentyp erwartet. Die neueste Version der CLI und Plugins (Version 6.25.0 oder 7+) verwendet SHA256-Prüfsummen, während ältere Plugins CRC32 verwendeten. Wenn Sie einen Prüfsummenfehler sehen, überprüfen Sie, ob die Prüfsumme CRC32 (ein kürzerer Hash) anstelle von SHA256 ist. Dies weist normalerweise darauf hin, dass das Bundle mit einer alten Version der CLI hochgeladen wurde. Überprüfen Sie Ihre Bundle-Version im Capgo-Dashboard - Bundles, die seit Version 6.25.0/7 erstellt wurden, sollten SHA256 verwenden. Wenn Sie CRC32-Prüfsummen sehen, stellen Sie sicher, dass Sie die neueste Plugin-Version lokal installiert haben (die CLI prüft Ihre lokale Plugin-Version, um zu bestimmen, welchen Prüfsummentyp hochgeladen werden soll), aktualisieren Sie dann Ihre CLI und laden Sie das Bundle erneut hoch.
windows_path_fail	Die ZIP-Datei enthält unzulässige Windows-Pfade
canonical_path_fail	Der Pfad der Dateien ist nicht kanonisch
directory_path_fail	Es gibt einen Fehler im Pfad der ZIP-Dateien
unzip_fail	Entpacken fehlgeschlagen
low_mem_fail	Download aufgrund von niedrigem Gerätespeicher fehlgeschlagen

Bundle-Status

• SUCCESS: Bundle-Installation abgeschlossen
• ERROR: Installation oder Download fehlgeschlagen
• PENDING: Download abgeschlossen, wartet auf Freigabe
• DELETED: Bundle gelöscht, wird noch für Statistiken angezeigt
• DOWNLOADING: Bundle wird gerade heruntergeladen

Geräte-Logs verstehen:

Debug-Befehl:

Es gibt einen Debug-Befehl für Capgo Cloud-Benutzer

npx @capgo/cli@latest app debug

Damit können Sie alle Ereignisse in der App überprüfen und eine Lösung finden, wenn Updates nicht funktionieren

iOS

So finden Sie Ihre Logs in Xcode

Getting the Device Log in Xcode

Android:

So finden Sie Ihre Logs in Android Studio

View logs with Logcat

Erklärungen zu den Logs

• Failed to download from => gleich wie download_fail
• notifyAppReady was not called, roll back current bundle => gleich wie update_fail

Heruntergeladenes Bundle auf Ihrem Gerät finden

iOS

Zum Debuggen unter iOS müssen Sie die App auf Ihren Computer exportieren. Das geht so:

Xcode hat eine eingebaute Funktion zur Überprüfung des Dateisystems von Entwickler-installierten Apps auf einem iOS-Gerät

So gehen Sie vor:

1. Verbinden Sie Ihr Gerät mit dem Mac und wählen Sie Fenster > Geräte in der Xcode-Menüleiste
2. Wählen Sie Ihr Gerät im linken Bereich unter Geräte aus
3. Dies zeigt eine Liste der entwicklerinstallierten Apps für dieses Gerät
4. Wählen Sie die App aus, die Sie überprüfen möchten, und klicken Sie auf das Zahnrad-Symbol unten im Bildschirm
5. Hier können Sie das aktuelle Dateisystem durch Auswahl von Container anzeigen oder einen Snapshot davon herunterladen

Wenn Sie Container herunterladen wählen, wird ein Snapshot des Dateisystems als xcappdata-Datei heruntergeladen, die Sie durchsuchen können

Klicken Sie mit der rechten Maustaste auf diese Datei und wählen Sie Paketinhalt anzeigen, um den Ordner zu öffnen

Öffnen Sie den App Data-Ordner, und Sie sollten nun einige Ordner wie Documents, Library, tmp usw. sehen

Dann finden Sie eine Version in 2 Ordnern:

library/NoCloud/ionic_built_snapshots wird nach dem App-Neustart benötigt

und documents/versions für Hot Reload

Android

Zum Debuggen unter Android müssen Sie über Android Studio auf das Gerät zugreifen:

1. Klicken Sie auf Ansicht > Werkzeugfenster > Gerätedatei-Explorer oder klicken Sie auf die Schaltfläche Gerätedatei-Explorer in der Werkzeugleiste
2. Wählen Sie ein Gerät aus der Dropdown-Liste
3. Öffnen Sie den Pfad data/data/APP_NAME/ wobei APP_NAME Ihre App-ID ist

Dann finden Sie den Ordner versions, um alle Versionen zu sehen

Wussten Sie?

Unter Android werden alle Versionen in einem Ordner gespeichert, anders als bei iOS, wo sie an zwei Stellen dupliziert werden müssen

iOS Produktions-Absturzprotokolle verstehen

How to review your app's crash logs