Fehlernachverfolgung

Cloud-Protokolle verstehen:

Wenn Sie eine Cloud-Verweigerung code erhalten und konkrete Abhilfeschritte benötigen, sehen Sie sich Häufige Update-Probleme.

Von der Backend-Instanz gesendet

code	Beschreibung
InvalidIp	Der Benutzer befindet sich in einem Google-Datencenter und das Update ist weniger als 4 Stunden alt. Dies wird durchgeführt, um Google-Bots-Geräte als Geräte in Ihrem Konto zu vermeiden.
needPlanUpgrade (vorher) bedarfEinerAktualisierung)	Zeigt an, dass Sie die Grenzen Ihres Plans erreicht haben und das Gerät keine Updates erhalten wird, bis Sie sich aktualisieren oder bis zum nächsten Monat.
keineNeuigkeiten	Das Gerät hat die neueste verfügbare Version.
disablePlatformIos	Das Gerät ist auf dem iOS-Plattform, aber diese ist in den Kanal-Einstellungen deaktiviert.
disablePlatformAndroid	Das Gerät ist auf der Android-Plattform, aber diese ist in den Kanal-Einstellungen deaktiviert.
disableAutoUpdate	major
disableAutoUpdateUnderNative	Das Gerät hat Version (1.2.3), und das Kanal hat eine Aktualisierung (1.2.2) unter der Geräteversion zum Senden, aber das ist in den Kanal-Einstellungen deaktiviert.
disableDevBuild	Das Gerät hat eine Entwicklerversion, aber das ist in den Kanal-Einstellungen deaktiviert.
disableEmulator	Das Gerät ist ein Emulator, aber das ist in den Kanal-Einstellungen deaktiviert.
cannotGetBundle	Es ist nicht möglich, eine gültige signierte URL für die Bundle-Download zu generieren. Dies tritt auf, wenn die Bundle-URL-Generierung fehlschlägt oder eine ungültige URL (die nicht mit http/https beginnt) zurückgibt und keine Manifest-Datei als Ausfallsicherheit verfügbar ist.
cannotUpdateViaPrivateChannel	Das Gerät versuchte, sich mit einem privaten Kanal selbst zu verbinden, aber die Kanal-Einstellungen erlauben keine Geräte-Self-Verbindung (allow_device_self_set is false) und der Kanal ist nicht öffentlich.
channelMisconfigured	Die Kanal-Einstellung verhindert die automatische Aktualisierung durch Versionsnummer (disable_auto_update: 'version_number') min_update_version aber das Feld des Pakets ist null, sodass es unmöglich ist, zu bestimmen, welche Geräte die Aktualisierung erhalten sollen.
__CAPGO_KEEP_0__	Die automatische Aktualisierung ist durch Versionsnummer-Metadaten deaktiviert. Der Kanal erfordert, dass die Geräteversion mindestens min_update_version__CAPGO_KEEP_0__
ist, aber die aktuelle Geräteversion ist niedriger als dieser Schwellenwert.	__CAPGO_KEEP_0__ disable_auto_update: 'major' Kanal-Einstellung
verhindert Aktualisierungen, die die Hauptversionsnummer erhöhen (z.B. Blockieren von 1.x.x, um auf 2.x.x zu aktualisieren).	__CAPGO_KEEP_0__ disable_auto_update: 'minor' Kanal-Einstellung verhindert Aktualisierungen, die die Versionsnummer erhöhen (z.B. Blockieren von 1.2.x, um auf 1.3.x zu aktualisieren).
__CAPGO_KEEP_0__	Kanal-Einstellung disable_auto_update: 'patch' Verhindert Updates, die die Versionsnummer im Patcheschritt erhöhen würden, oder ermöglicht nur Updates auf Patchebene innerhalb derselben Haupt- und Minorversion (z.B. 1.2.3 kann auf 1.2.4, aber nicht auf 1.2.2 oder 1.3.0 aktualisiert werden).
__CAPGO_KEEP_1__	Der zugeordnete Bundle hat keine herunterladbaren Inhalte. Das bedeutet, dass das Bundle keine external_urlkeine r2_pathes ist keine integrierte Version und es stehen keine Manifesteinträge zum Herunterladen zur Verfügung.
__CAPGO_KEEP_2__	Kein Standardkanal ist für diese App konfiguriert und das Gerät hat keine spezifische Kanal-Übernahme zugewiesen. Zumindest einer muss vorhanden sein, damit Updates funktionieren.
__CAPGO_KEEP_3__	Das Gerät wurde aufgrund von übermäßigen Anfragen rate limitiert.
__CAPGO_KEEP_4__	Die öffentliche Verschlüsselungsschlüssel des Geräts entspricht nicht dem Schlüssel, der zum Verschlüsseln des Pakets verwendet wurde. Dies tritt auf, wenn: (1) Der öffentliche Schlüssel in Ihrer App von dem verwendet wird, der zum Hochladen des Pakets verwendet wurde, oder (2) Sie Ihre Verschlüsselungsschlüssel rotiert haben, aber noch nicht alle Geräte aktualisiert haben. Die Antwort enthält sowohl den öffentlichen als auch den privaten Schlüssel (die ersten 4 Zeichen jedes öffentlichen Schlüssels) zur Identifizierung des Missmatch. Um dies zu beheben, stellen Sie sicher, dass das gleiche Schlüsselpaar sowohl zum Hochladen von Paketen als auch in der App verwendet wird (__CAPGO_KEEP_0__ verwendet den privaten Schlüssel und __CAPGO_KEEP_1__.config.json enthält den öffentlichen Schlüssel). capacitor.config.json Abschnitt mit dem Titel "Von dem Gerät gesendet" deviceKeyId __CAPGO_KEEP_0__ bundleKeyId (first 4 characters of each public key) to help identify the mismatch. To fix this, ensure the same key pair is used both for uploading bundles (CLI uses private key) and in the app (capacitor.config.json contains public key).

ping

code	Die Informationen für das Herunterladen der neuen Version wurden an das Gerät gesendet.
Beschreibung	ping
Internes Testaktion, die verwendet wird, um die Funktionsweise des Statistiksystems zu überprüfen.	get
löschen	Ein Bundle wurde auf dem Gerät gelöscht.
setzen	Ein Bundle wurde auf dem Gerät gesetzt.
setzen_fehlerhaft	Das Bundle konnte nicht gesetzt werden.
zurücksetzen	Das Gerät wurde auf die builtin Bundle.
herunterladen_XX	Ein neues Bundle wurde heruntergeladen - Fortschritt angezeigt durch XX% (Zehner-Schritte).
herunterladen_abgeschlossen	Die neue Bundle ist heruntergeladen.
__CAPGO_KEEP_0__	Das Gerät begann, das Update-Manifest herunterzuladen.
__CAPGO_KEEP_0__	Das Gerät hat das Update-Manifest heruntergeladen.
__CAPGO_KEEP_0__	Das Gerät begann, das Bundle-Archiv herunterzuladen.
__CAPGO_KEEP_0__	Das Gerät hat das Bundle-Archiv heruntergeladen.
Ein Manifest-Eintrag konnte nicht heruntergeladen werden; die Statistik-Payload enthält	in der Form version_name __CAPGO_KEEP_0__ version:fileName um den Asset zu lokalisieren.
__CAPGO_KEEP_0__	Der Manifestdatei fehlte die Überprüfung der Prüfsumme.
Der Manifestdatei fehlte die Entschlüsselung mit Brotli.	Der neue Bundle konnte nicht heruntergeladen werden.
Der neue Bundle wurde installiert, aber fehlte die Anrufung.	__CAPGO_KEEP_0__
Der neue Bundle konnte die Prüfsumme nicht überprüfen. Dies kann auf mehrere Gründe zurückzuführen sein:	1) Prüfsummentypen stimmen nicht überein: notifyAppReady.
1) Prüfsummentypen stimmen nicht überein:	1) Prüfsummentypen stimmen nicht überein: 1) Prüfsummentypen stimmen nicht überein: The neueste Version der CLI und Plugins (Version 5.10.0+, 6.25.0+ oder 7+) verwenden SHA256-Prüfsummen, während ältere Plugins CRC32 verwendeten. Wenn Sie eine Prüfsummenfehler sehen, überprüfen Sie, ob die Prüfsumme CRC32 (eine kürzere Hash) anstatt SHA256 ist. Dies deutet normalerweise darauf hin, dass das Bundle mit einer alten Version der CLI hochgeladen wurde. Überprüfen Sie die Version Ihres Bundles im Capgo-Dashboard - Bundles, die seit Version 5.10.0/6.25.0/7 erstellt wurden, sollten SHA256 verwenden. Wenn Sie CRC32-Prüfsummen sehen, stellen Sie sicher, dass Sie die neueste Pluginversion lokal installiert haben (das CLI überprüft Ihre lokale Pluginversion, um zu bestimmen, welcher Prüfsummentyp hochgeladen werden soll), dann aktualisieren Sie Ihre CLI und laden Sie das Bundle erneut hoch. 2) Verschlüsselungs-Schlüsselmangels (auf Plugin-Versionen unter 8.3.0 oder 5/6/7.38.0): Bei älteren Plugin-Versionen wird die Verschlüsselung fehlschlagen, wenn der öffentliche Schlüssel des Geräts nicht mit dem Schlüssel übereinstimmt, der zum Verschlüsseln des Bundles verwendet wurde. Wenn Sie Verschlüsselung verwenden und sehen checksum_failüberprüfen Sie, ob der öffentliche Schlüssel in Ihrer App capacitor.config.json mit dem privaten Schlüssel übereinstimmt, der zum Hochladen des Bundles verwendet wurde. Die Aktualisierung auf Plugin-Version 8.3.0+ (oder 5/6/7.38.0+) gibt Ihnen ein ordentliches keyMismatch fehlermeldung vom Server, was diese Probleme einfacher zu diagnostizieren macht.
windows_path_fail	Die Zip enthält Dateien, die illegale Windows-Pfade enthalten.
canonical_path_fail	Der Pfad der Dateien ist nicht kanonisch.
directory_path_fail	Es gibt ein Fehler im Pfad der Zip-Dateien.
unzip fehlgeschlagen	unzip fehlgeschlagen
low_mem_fail	Der Download fehlgeschlagen, weil auf dem Gerät zu wenig Speicherplatz vorhanden ist.
Die Anwendung wurde in den Hintergrund versetzt.	Die Anwendung wurde in den Vordergrund versetzt.
decrypt_fail	Der Versuch, das heruntergeladene Bundle zu entschlüsseln, ist fehlgeschlagen.
Der aktuelle Kanal für das Gerät wurde abgefragt.	__CAPGO_KEEP_0__
__CAPGO_KEEP_0__	__CAPGO_KEEP_0__
Kanal setzen	Ein Kanal wurde erfolgreich für das Gerät gesetzt.
Entfernen	Die Anwendung wurde entfernt oder Capgo Daten gelöscht.
Server-URL	Server.url ist in Ihrer capacitor Konfiguration vorhanden, was bedeutet, dass Capacitor remote URLs und lokale Dateien ignoriert, während unser Updater mit lokalen Dateien funktioniert. Server.url wird von Capacitor Entwicklern als schlechte Praxis in der Produktion angesehen und kann zu vielen Problemen und nicht funktionierenden Plugins führen.

Bundle-Status

• SUCCESS: Bundle installiert
• ERROR: Installieren oder herunterladen fehlgeschlagen
• PENDING: Herunterladen abgeschlossen, Release noch nicht veröffentlicht
• DELETED: Bundle gelöscht, aber für Statistiken noch vorhanden
• DOWNLOADING: Aktuell wird ein Bundle heruntergeladen

Geräteprotokolle verstehen:

Debug-Befehl:

Für Capgo Cloud-Nutzer gibt es einen Debug-Befehl.

npx @capgo/cli@latest app debug

Mit diesem können Sie alle Ereignisse im App abrufen und eine Lösung finden, wenn Updates nicht erfolgen.

iOS

um Ihre Protokolle in Xcode zu finden

Geräteprotokoll in Xcode abrufen

Android:

Ihre Protokolle in Android Studio finden

Protokolle mit Logcat anzeigen

Erklärungen zu Protokollen

• Failed to download from => gleichbedeutend download_fail => gleichbedeutend
• notifyAppReady was not called, roll back current bundle update_fail Das heruntergeladene Bundle auf Ihrem Gerät finden

protectedTokens

iOS

Um auf iOS zu debuggen, müssen Sie das App-Programm auf Ihrem Computer auswerten, Sie können es wie folgt tun:

Xcode verfügt über eine eingebaute Funktion zum Inspektorieren des Dateisystems von Entwickler-Installations-Apps auf einem iOS-Gerät.

Um dies zu erreichen:

• Verbinden Sie Ihr Gerät mit Ihrem Mac und wählen Sie in der Xcode-Menüleiste „Window > Devices“.
• Wählen Sie Ihr Gerät in der linken Spalte unter der „Geräte“-Sektion aus.
• Dies zeigt eine Liste der von Entwicklern installierten Apps für dieses Gerät an.
• Wählen Sie die App aus, die Sie inspizieren möchten, und wählen Sie dann das 3-Punkte-Symbol in der unteren Ecke der Bildschirmleiste aus.
• Hier können Sie das aktuelle Dateisystem anzeigen, indem Sie eine Snapshot-Datei herunterladen.

Beim Auswahl von "Download Container…" wird ein Snapshot des Dateisystems als .xcappdata-Datei heruntergeladen und exportiert, die du durchsuchen kannst.

Rechtsklicke auf diese Datei und wähle "Show Package Contents" aus, um den Ordner zu öffnen.

Öffne das App-Daten-Ordner und du solltest jetzt einige Ordner wie Dokumente, Bibliothek, tmp usw. sehen.

Dann findest du eine Version in 2 Ordner:

library/NoCloud/ionic_built_snapshots erforderlich nach dem App-Neustart

und documents/versions für Hot-Reload

Android

Um auf Android zu debuggen, müssen Sie den Gerätezugriff von Android Studio aus nutzen:

• Klicken Sie auf Ansicht > Werkzeuge > Geräte-Datei-Explorer oder klicken Sie auf den Geräte-Datei-Explorer-Button in der Werkzeugleiste, um den Geräte-Datei-Explorer zu öffnen.
• Wählen Sie ein Gerät aus der Dropdown-Liste.
• Öffnen Sie den Pfad __CAPGO_KEEP_0__ wobei __CAPGO_KEEP_0__

Android Studio Geräte-Datei-Explorer zeigt App-Datenspeicherort an versions Dann finden Sie das

Wussten Sie das? Wussten Sie das?

Auf Android werden alle Versionen in einem Ordner gespeichert, im Gegensatz zu IOS, wo es dupliziert werden muss in zwei Orten.

__CAPGO_KEEP_0__

Wie man die Crash-Protokolle seiner App überprüft