Debugging

Verständnis von Cloud-Protokollen

Wenn Sie eine Cloud-Verweigerung erhalten code und eine umfassendere Ermittlung benötigen, sehen Sie sich Gemeinsame Update-Probleme.

Capgo-Protokolle können Metadaten für das Ereignis enthalten. Im Dashboard filtern Sie nach dem Unterstrich-Action-code und klicken Sie auf die Metadaten-Zelle, um die vollständige JSON-Payload zu kopieren. Metadaten sind besonders nützlich für Crash- und WebView-Ereignisse, da sie den Fehlercode, die Quell-URL, die Zeilen- und Spaltennummer, den Prozessstatus, den Speicherdruck oder die plattformabhängige Ursache enthalten können. Ältere Protokolle können noch Legacy-Camel-Case-Aliase in Klammern auflisten.

Jeder Abschnittstitel entspricht der Aktion code im Konsole-Protokoll-Tabelle, sodass Sie direkt darauf verweisen können.

Planbegrenzungen und normale Antworten

Hinweise des Backends im Zusammenhang mit der Abrechnung, der Einschränkung oder nicht-fehlerhaften Zuständen.

InvalidIp

Was bedeutet das?

Capgo hat Verkehr erkannt, der wie von Google oder der Cloud-Infrastruktur aussieht. Updates unter vier Stunden alt werden ignoriert, damit Bot-Verkehr nicht als abrechnungspflichtige Geräte gezählt wird.

Was tun?

Ignorieren Sie dies bei echten Benutzern. Versuchen Sie es erneut von normalen Netzwerken und echten Geräten aus oder warten Sie und überprüfen Sie es später erneut.

provider_infrastructure_request_blocked

Was bedeutet das?

Ihre App ist so konfiguriert, dass Anforderungen von bekannten Google- und Apple-Datacenter-IP-Adressen blockiert werden. Die Schutzmaßnahmen gelten für Update-Überprüfungen, Statistiken und Anfragen an den Kanal selbst, sodass cloud-gesteuerte Proben und Anbieter-Runner auch dann auf diese Antwort antworten können, wenn die App-Konfiguration ansonsten gültig ist.

Was tun?

Versuchen Sie es erneut von einem physischen Gerät auf einem normalen Benutzer-Netzwerk aus. Wenn der provider-herkommende Traffic absichtlich ist, deaktivieren Sie temporär Provider-Infrastruktur-Anfragen blockieren im App-Bereich Informationen Dann aktivieren Sie es erneut nach dem Test. Neue Apps aktivieren diese Einstellung standardmäßig; bestehende Apps behalten ihre vorherige deaktivierte Einstellung, bis sie geändert werden.

needPlanUpgrade

Was bedeutet das?

Ihre Organisation hat das Plan- oder Gerätelimit erreicht. Das Gerät erhält keine Updates, bis Sie das Abonnement aufstocken oder der nächste Abrechnungszyklus die Verwendung zurücksetzt.

Was tun?

Stellen Sie Ihr Abonnement im Dashboard auf oder warten Sie auf den nächsten Abrechnungszyklus.

noNew

Was bedeutet das?

Das Gerät hat bereits die neueste Bundle-Version für seinen Kanal. Dies ist ein normaler Zustand und kein Fehler.

rateLimited

Was bedeutet es

Der Gerät hat zu viele Update- oder Kanal-Anfragen in kurzer Zeit gesendet.

Was tun

Stoppen Sie die Aufrufe von Update-APIs innerhalb von Render-Schleifen. Rufen Sie sie setChannel / getChannel nur von Benutzeraktionen aus und setzen Sie defaultChannel in capacitor.config.

Version-Format

Hintergrundabnahmen aufgrund ungültiger native Versionsmetadaten.

semver_error

Was bedeutet es

Die native App-Version in der Konfiguration fehlt oder ist nicht gültig im semver-Format (x.y.z).

Was tun

Einstellung plugins.CapacitorUpdater.version auf gültige SemVer, überprüfen Sie es in der SemVer-Tester, dann erneut aufbauen und die native App neu installieren

Plattform und Zielgerät

Hintergrundabnahmen, wenn die Kanalrichtlinie eine Plattform, einen Buildtyp oder eine Gerätekategorie blockiert

disablePlatformIos

Was bedeutet es

Das Gerät läuft unter iOS, aber iOS-Updates sind für diesen Kanal deaktiviert

Was tun

Stellen Sie iOS im Kanal aktiv, wenn dies versehentlich geschah, oder leiten Sie iOS-Builds in einen dedizierten Kanal ein, wenn das Blockieren beabsichtigt ist.

disablePlatformAndroid

Was bedeutet es

Der Geräte läuft unter Android, aber Android-Updates sind für diesen Kanal deaktiviert.

Was tun Sie

Stellen Sie Android im Kanal aktiv, wenn dies versehentlich geschah, oder leiten Sie Android-Builds in einen dedizierten Kanal ein, wenn das Blockieren beabsichtigt ist.

disablePlatformElectron

Was bedeutet es

Der Geräte läuft unter Electron, aber Electron-Updates sind für diesen Kanal deaktiviert.

Was tun Sie

Stellen Sie Electron im Kanal aktiv, wenn dies versehentlich geschah, oder leiten Sie Electron-Builds in einen dedizierten Kanal ein, wenn das Blockieren beabsichtigt ist.

disableDevBuild

What bedeutet es

Das Gerät ist ein Entwicklungsbuild, aber Entwicklungsbuilds sind für diesen Kanal blockiert.

Was tun

Entwicklungsbuilds in einem Testkanal zulassen oder diesen Kanal nur auf Releases beschränken und Entwicklungsgeräte anderswo platzieren.

disableProdBuild

Was bedeutet es

Eine Produktionsversion genannt /updates, aber Produktionsupdates für diesen Kanal blockiert sind.

Was tun

Produktionsupdates in dem Kanal zulassen, wenn dies versehentlich geschah, oder Produktionsbuilds auf den richtigen Kanal umleiten.

disableDevice

Was bedeutet es

A ein echtes Telefon oder Tablet wurde blockiert, weil dieser Kanal echte Geräte blockiert.

Was tun?

Stellen Sie sicher, dass die Aktualisierungen für echte Geräte aktiviert sind, wenn dies versehentlich passiert ist, oder lassen Sie die Einschränkung bestehen und leiten Sie echte Geräte in einen anderen Kanal um.

disableEmulator

Was bedeutet das?

Das Gerät ist ein Emulator, aber Emulator-Aktualisierungen sind für diesen Kanal deaktiviert.

Was tun?

Stellen Sie sicher, dass die Emulator-Aktualisierungen in einem Testkanal aktiviert sind, oder lassen Sie diesen Kanal weiterhin auf Emulatoren blockiert und verwenden Sie einen anderen Kanal für die Emulator-Validierung.

Automatische Aktualisierungs-Kompatibilitätsregeln

Hintergrundablehnungen, wenn semver- oder Metadaten-Regeln die Ziel-Paket-aktualisierung blockieren.

disableAutoUpdate

Was bedeutet es

Die automatische Aktualisierung ist durch die Kanal-Kompatibilitätsrichtlinie deaktiviert. Die Metadaten enthalten auto_update mit einer passenden Regel wie major, minor, patch, metadata, oder none.

Was tun

Ändern Sie die Kanal-Aktualisierungsrichtlinie, um Ihre geplante Rollout-Strategie zuzulassen.

disableAutoUpdateUnderNative

Was bedeutet es

Der Kanal hat ein Paket, das älter ist als das Geräte-Grundlage und blockiert die Aktualisierung unter der nativen Version.

Was tun

Veröffentlichen Sie ein Paket bei oder über der nativen Basis, oder deaktivieren Sie die unter-nativen Schutzfunktion im Kanal.

disableAutoUpdateMetadata

What bedeutet

Der Kanal erfordert min_update_version, aber die Geräte-native Version liegt unter diesem Schwellenwert.

Was tun

Setzen min_update_version auf dem Zielbundle oder Release aus einer neueren native Version.

disableAutoUpdateToMajor

Was bedeutet

Der Kanal blockiert Sprünge auf Hauptversionen, zum Beispiel 1.x.x zu 2.x.x.

context: Live Updates Produktseite. Rolle: Kurze UI-Bezeichnung oder Navigationspunkt. Nachrichten Schlüssel `live_update_dynamic_label_to` (Live Update Dynamic Label To).

Was tun Common Update Problems.

disableAutoUpdateToMinor

Was bedeutet das

Der Kanal blockiert Sprünge auf Minor-Versionen im Vergleich zum Geräte-Standard (version_build), zum Beispiel 1.2.3 zu 1.3.0.

Was tun

Passen Sie die Kanalstrategie mit Ihrem Minor-Rollout-Plan an oder lassen Sie Minor-Sprünge für diesen Track zu.

disableAutoUpdateToPatch

Was bedeutet das

Der Kanal blockiert Änderungen auf Patch-Ebene, während die gleiche Präfix-Nummer beibehalten wird; nur Änderungen auf der Suffix-Ebene sind erlaubt. MAJOR.MINOR.PATCH Der Kanal blockiert Änderungen auf Patch-Ebene, während die gleiche Präfix-Nummer beibehalten wird; nur Änderungen auf der Suffix-Ebene sind erlaubt.

Was tun

Die Veröffentlichungszyklus mit der Kanalpolitik abstimmen oder für diesen Track Patch-Sprünge zulassen

Kanal einrichten

Hintergrundabnahmen aufgrund fehlender oder inkompatibler Kanalkonfiguration

cannotUpdateViaPrivateChannel

Was bedeutet das

Das Gerät versuchte, sich selbst mit einem privaten Kanal zu verbinden, der keine Geräte-Selbstzuweisung zulässt ("ist false) und der Kanal ist nicht öffentlichallow_device_self_set Was tun

Aktivieren

auf dem Kanal oder das Gerät auf einen öffentlichen oder zulässigen Kanal umschalten allow_device_self_set Abschnitt mit dem Titel "cannotUpdateViaPrivateChannel"

channelMisconfigured

Was bedeutet das

Der Kanal verwendet disable_auto_update: "version_number" aber die Paketversion min_update_version ist null, so kann Capgo nicht entscheiden, welche Geräte aktualisiert werden sollen.

Was tun

Füllen Sie die fehlende Konfiguration für diese Regel oder wechseln Sie zu einem einfacheren Auto-Update-Modus.

NoChannelOrOverride

Was bedeutet das

Kein Standardkanal ist konfiguriert und das Gerät hat keinen Kanal-Überschreibung.

Was tun

Setzen Sie einen Standardkanal im Dashboard oder konfigurieren Sie defaultChannel im Bau.

Bundle-Lieferung und -Verschlüsselung

Hintergrundabnahmen, wenn Capgo die Bundle nicht bereitstellen oder entschlüsseln kann.

cannotGetBundle

Was bedeutet das?

Capgo konnte keine gültige signierte Download-URL generieren und es war kein Manifest-Backup verfügbar.

Was tun?

Das Bundle erneut hochladen, Manifeste neu generieren und die Einstellungen für R2 oder das öffentliche Bundle überprüfen.

missingBundle

Was bedeutet das?

Das dem Kanal zugewiesene Bundle enthält keine herunterladbaren Inhalte: keine external_url, nein r2_path, kein inbauerischer Version, und keine Manifest-Einträge.

Was tun

Rebuild und die Version erneut hochladen, dann bestätigen, dass das Bundle echte Dateien enthält.

keyMismatch

Was es bedeutet

Die Geräteverschlüsselungspublik- Key passt nicht zum Schlüssel, der zum Verschlüsseln des Bundles verwendet wurde. Die Metadaten können device_key_id, bundle_key_id, und version.

Was tun

Geräte- und Bundle-Schlüssel-IDs im Konsole vergleichen. Mit demselben Schlüssel und den passenden CLI/Plugin-Versionen veröffentlichen.

Anwendungs-Konfiguration und Legacy-Kunden

Hinweise des Backends aufgrund der Anwendungs-Konfiguration oder nicht unterstützter Updater-Versionen.

customIdBlocked

Was bedeutet es

Die App hat ein benutzerdefiniertes Geräte-ID gesendet, aber diese App akzeptiert keine benutzerdefinierten IDs, daher wird die ID ignoriert.

Was tun

Die Sendung von benutzerdefinierten IDs stoppen oder nur dann benutzerdefinierte IDs aktivieren, wenn dies in Ihrem Workflow erforderlich ist.

blocked_by_server_url

Was bedeutet es

server.url ist in der Capacitor Konfiguration festgelegt, daher lädt die WebView eine remote URL statt lokaler Bundle-Dateien. Capgo Live-Updates erfordern lokale Dateien und server.url ist in der Produktion nicht empfohlen.

Was tun

Entfernen oder löschen server.url für Produktionsbuilds und halten Sie die Aktualisierungsdaten lokal. Dies code kann als Backend-Verweigerung oder als Geräteseiteneinstellung auftreten.

backend_refusal

Was bedeutet es

Der Updater-Plugin ist v4, das der Backend nicht mehr akzeptiert.

Was tun

Aktualisieren Sie das Plugin und CLI auf v5+ (vorzugsweise v8) mit Capacitor v5+, rebuilden und das Bundle-Metadaten neu veröffentlichen.

Aktualisierungslebenzyklus

Geräteseitige Ereignisse für den normalen Aktualisierungsfluss, Aktivierung und Rollover.

ping

Was bedeutet es

Interne Testaktion zur Überprüfung des Statistikpipeline.

get

Was bedeutet das

Capgo hat dem Gerät Informationen über eine neue Version zum Herunterladen gesendet.

set

Was bedeutet das

Ein Bundle wurde auf dem Gerät aktiviert.

set_fail

Was bedeutet das

Was tun

Überprüfen Sie die native Protokolle mit

und überprüfen Sie die Integrität, Pfade und npx @capgo/cli@latest app debug des Bundles. notifyAppReady flow.

reset

Was bedeutet das

Das Gerät wurde auf die integrierte Bundle zurückgesetzt.

delete

Was bedeutet das

Herunterladen und Installationsfehler

Abschnitt mit dem Titel “Herunterladen und Installationsfehler”

Abschnitt mit dem Titel “Herunterladen_0”

download_0

Herunterladen und Installationsfehler

Die Herunterladesequenz begann bei 0% Fortschritt.

download_10

Was bedeutet das?

Ein neuer Bundle wurde heruntergeladen — Fortschritt angezeigt bei 10%.

download_20

Was bedeutet das?

Ein neuer Bundle wurde heruntergeladen — Fortschritt angezeigt bei 20%.

download_30

Was bedeutet das?

Ein neuer Bundle wurde heruntergeladen — Fortschritt angezeigt bei 30%.

download_40

Was bedeutet das?

Aus einem neuen Bundle wurde heruntergeladen — Fortschritt angezeigt bei 40%.

download_50

Was bedeutet das

Aus einem neuen Bundle wurde heruntergeladen — Fortschritt angezeigt bei 50%.

download_60

Was bedeutet das

Aus einem neuen Bundle wurde heruntergeladen — Fortschritt angezeigt bei 60%.

download_70

Was bedeutet das

Aus einem neuen Bundle wurde heruntergeladen — Fortschritt angezeigt bei 70%.

download_80

Was bedeutet das

Aus einem neuen Bundle wurde heruntergeladen — Fortschritt angezeigt bei 80%.

download_90

Was bedeutet das?

Aus einem neuen Bundle wurde heruntergeladen — Fortschritt angezeigt bei 90%.

download_complete

Was bedeutet das?

Die Bundle-Herunterladung war erfolgreich abgeschlossen.

download_manifest_start

Was bedeutet das?

Das Gerät begann mit der Herunterladung des Update-Manifests.

download_manifest_complete

Was bedeutet das?

Das Gerät hat das Update-Manifest heruntergeladen.

download_zip_start

Was bedeutet das?

Das Gerät hat das Bundle-Archiv heruntergeladen.

download_zip_complete

Was bedeutet das?

Das Gerät hat das Bundle-Archiv heruntergeladen.

download_manifest_file_fail

Was bedeutet das?

Eines der Manifest-Einträge konnte nicht heruntergeladen werden. version_name wird verwendet version:fileName um das Asset zu identifizieren.

Was tun

Die fehlende oder blockierte Asset korrigieren, das Manifest neu generieren und das Bundle erneut hochladen.

download_manifest_checksum_fail

Was bedeutet das

Ein Manifest-Datei fehlte die Prüfsummenvalidierung.

Was tun

Das Bundle mit der aktuellen CLI Version erneut hochladen und die Manifest-Prüfsummen überprüfen.

download_manifest_brotli_fail

Was bedeutet das

Ein Manifest-Datei fehlte die Brotli-Entschlüsselung.

Was tun

Die Komprimierungseinstellungen überprüfen und die betroffenen Assets erneut hochladen.

download_fail

Was bedeutet es

Der Bundle konnte nicht heruntergeladen werden.

Was tun

Überprüfen Sie die Netzwerkverbindung, die Ablaufzeit des signierten Links, die Erreichbarkeit des Content Delivery Networks (CDN) und die Speicherung des Geräts.

update_fail

Was bedeutet es

Der Bundle wurde installiert, aber die App rief nie notifyAppReady, also Capgo wurde zurückgerollt.

Was tun

Rufen Sie nach dem Abschluss der App-Initialisierung notifyAppReady() Wie in Appflow aufgerufen. Rufen Sie nach dem Abschluss der App-Initialisierung auf, um die App zu aktualisieren. notifyAppReady was not called, roll back current bundle mappiert sich auf diesen code.

checksum_fail

Was bedeutet das

Die heruntergeladene Bundle hat die Prüfsummenvalidierung nicht bestanden. Häufige Ursachen: CRC32 vs SHA256-Mismatch von einem alten CLI-Upload, oder Verschlüsselungsschlüssel-Mismatch bei älteren Plugins, die Verschlüsselungsfehler als Prüfsummenfehler darstellen.

Was tun

Neu hochladen mit einem aktuellen CLI/Plugin (SHA256). Wenn Verschlüsselung verwendet wird, überprüfen Sie, ob die App-Publik-Schlüssel mit dem Upload-Schlüssel übereinstimmen, oder aktualisieren Sie auf Plugin 8.3.0+ für explizite keyMismatch Sektion mit dem Titel “Fehlschlag der Entschlüsselung”

decrypt_fail

Die heruntergeladene Bundle ist nicht entschlüsselt worden.

Was tun

Überprüfen Sie die Verschlüsselungsschlüssel und laden Sie das Bundle erneut mit dem passenden Schlüsselpaar hoch.

Section titled “decrypt_fail”

windows_path_fail

Was bedeutet das

Die Zip enthält illegale Windows-Pfade.

Was tun

Bauen Sie die Bundle auf Unix-Pfaden oder reinigen Sie die Archivpfade vor dem Hochladen.

canonical_path_fail

Was bedeutet das

Die Dateipfade innerhalb der Zip sind nicht kanonisch.

Was tun

Beheben Sie die Pfadgenerierung des Archivs vor dem Hochladen.

directory_path_fail

Was bedeutet das

Der Zip-Ordner enthält ungültige Verzeichnispfade.

Was tun?

Stellen Sie die Archivstruktur vor dem Upload sicher.

unzip_fail

Was bedeutet das?

Das Gerät ist beim Entpacken des heruntergeladenen Bundles gescheitert.

Was tun?

Überprüfen Sie die Integrität des Archivs und unterstützte Komprimierung.

low_mem_fail

Was bedeutet das?

Der Download ist fehlgeschlagen, weil das Gerät nicht genug Speicherplatz hatte.

Was tun?

Reduzieren Sie die Größe des Bundles oder versuchen Sie es auf einem Gerät mit mehr freiem Speicher.

Anwendungszustand und WebView-Ereignisse

Geräteseitige Crash-, Speicher- und WebView-Diagnosen. Inspektorieren Sie immer die Metadaten-JSON-Daten im Dashboard.

app_moved_to_background

Was bedeutet es

Die Anwendung wurde in den Hintergrund geschoben.

app_moved_to_foreground

Was bedeutet es

Die Anwendung wurde in den Vordergrund geschoben.

app_crash

Was bedeutet es

JavaScript oder Capacitor Layer abstürzt. Die Metadaten können eine Nachricht, einen Stapel, eine Quelle und den aktiven Bundle-Kontext enthalten.

Was tun

Überprüfen Sie die Metadaten und die native Logs. Kombinieren Sie die Fehlerberichterstattung von JS und native (z.B. Sentry) um den fehlerhaften code Pfad zu lokalisieren.

app_crash_native

Was bedeutet es

Native Plattform abstürzt. Die Metadaten können eine Plattform, einen Grund, einen Stapel und Details zum Prozess enthalten.

Was tun

Verwenden Sie Xcode oder Logcat-Crash-Logs und korrelieren Sie sie mit dem aktiven Bundle aus den Metadaten.

app_anr

Was bedeutet es

Android-Anwendung nicht reagiert (ANR).

Was tun

Überprüfen Sie die ANR-Protokolle in Logcat und reduzieren Sie die Blockierung der Haupt-Schleife nach Updates.

app_killed_low_memory

Was bedeutet es

Der Betriebssystem hat die App nach Druck auf die Speicherfläche getötet.

Was tun

Reduzieren Sie den Speicherbedarf nach Aktivierung des Updates und überprüfen Sie die Metadaten auf verfügbare Speicherzeichen.

app_killed_excessive_resource_usage

Was bedeutet es

Das Betriebssystem hat die App wegen übermäßiger Ressourcenverwendung getötet.

Was tun

Überprüfen Sie die Metadaten für den Ressourcentyp oder die Plattformgründe.

app_initialization_failure

Was bedeutet es

Der Updater oder die Startphase ist vor der normalen Laufzeit fehlgeschlagen.

Was tun

Überprüfen Sie die Metadaten für den fehlgeschlagenen Schritt und die Fehlermeldung.

app_memory_warning

Was bedeutet es

iOS-Memory-Warnung.

Was tun

Überprüfen Sie den Speicherkontext in den Metadaten und reduzieren Sie die Spitzenlast nach Updates.

webview_javascript_error

Was bedeutet es

Uncaught JavaScript-Fehler im WebView. Die Metadaten können eine Meldung, eine Quell-URL, eine Zeile, eine Spalte und einen Stapel enthalten.

Was tun

Installieren Sie die Fehlerberichterstellung in JS- und native Layers, um die genaue fehlende Zeile in der Produktion zu erfassen.

webview_unhandled_rejection

Was bedeutet es

Unbehandelter Versprechenabbruch im WebView.

Was tun

Fehler bei asynchronen Vorgängen mit JS- und native Fehlerberichterstellung erfassen.

webview_resource_error

Was bedeutet es

Ein WebView-Ressource konnte nicht geladen werden.

Was tun

Verwenden Sie die Metadaten-URL und die Statusdetails, um beschädigte Assets oder Netzwerkregeln zu beheben.

webview_security_policy_violation

Was bedeutet es

Der Inhaltssicherheitspolizist blockierte eine Ressource.

Was tun

Anpassen Sie den CSP mithilfe der Metadatadirktive und den Details der blockierten URI.

webview_unclean_restart

Was bedeutet es

Die vorherige WebView-Sitzung schloss sich nicht sauber, was auf Crash-Schleifen nach einem Update hindeuten kann.

Was tun

Korrelieren Sie mit Crash- und WebView-Fehlerereignissen vor und nach dem Neustart.

webview_render_process_gone

Was bedeutet es

Android WebView Renderer-Prozess beendet.

Was tun

Überprüfen Sie die Crashsignale im Metadaten- und Native-Log.

webview_content_process_terminated

Was bedeutet es

iOS WebView-Inhaltprozess beendet.

Was tun

Überprüfen Sie die aktuelle Bundle und die Seite-URL aus den Metadaten.

Umgebung und Kanal-Kontext

Geräteseitige Kontextereignisse, die helfen, das Updateverhalten mit der Betriebssystemversion, der nativen Version oder den Kanaländerungen zu korrelieren.

os_version_changed

Was bedeutet es

Die Geräte-OS-Version wurde zwischen den Überprüfungen geändert.

native_app_version_changed

Was bedeutet es

Die native App-Store-Version wurde geändert, wodurch native und Web-Bundle-Änderungen getrennt werden können.

getChannel

Was bedeutet es

Das Gerät hat seine aktuelle Kanalabfrage durchgeführt.

setChannel

Was bedeutet es

Ein Kanal wurde erfolgreich für das Gerät gesetzt.

uninstall

Was bedeutet das

Die App wurde deinstalliert oder die Capgo Daten wurden gelöscht.

Bundle-Status

• SUCCESS: Bundle installieren abgeschlossen
• ERROR: Installieren oder herunterladen fehlgeschlagen
• PENDING: Herunterladen abgeschlossen, Veröffentlichung steht noch aus
• DELETED: Bundle wurde gelöscht, aber noch für Statistiken angezeigt
• DOWNLOADING: Aktuell wird ein Bundle heruntergeladen

Geräteprotokolle verstehen

Debug-Befehl

Für Capgo-Cloud-Nutzer gibt es einen Fehlertreiber.

npx @capgo/cli@latest app debug

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

iOS-Native-Protokolle

Um Ihre Protokolle in Xcode zu finden

Geräteprotokoll in Xcode abrufen

Android-Native-Protokolle

Um Ihre Protokolle in Android Studio zu finden

Protokollierung mit Logcat anzeigen

Nativlogausdruckskartierung

• Failed to download from entspricht download_fail
• notifyAppReady was not called, roll back current bundle entspricht update_fail

Das heruntergeladene Bundle auf einem Gerät finden

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 integrierte Funktion zum Aufrufen des Dateisystems von Entwickler-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 "Devices"-Sektion.
• Dies zeigt eine Liste der von Entwicklern installierten Apps für das Gerät an.
• Wählen Sie die App, die Sie untersuchen möchten, und wählen Sie dann das 3-Punkte-Symbol in der unteren Ecke des Bildschirms.
• Hier können Sie das aktuelle Dateisystem anzeigen, indem Sie "Download a snapshot of it" auswählen.

Durch Auswahl von "Download Container…" wird ein Snapshot des Dateisystems heruntergeladen und als .xcappdata-Datei exportiert, die Sie durchsuchen können.

Rechtsklicken Sie auf diese Datei und wählen Sie "Show Package Contents" aus, um den Ordner zu öffnen.

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

Dann finden Sie eine Version in 2 Ordner:

library/NoCloud/ionic_built_snapshots ist erforderlich, nachdem das App-Neustart

und documents/versions für Hot-Reload

für Android

Um auf Android zu debuggen, müssen Sie Zugriff auf das Gerät von Android Studio haben:

• 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 data/data/APP_NAME/ wo APP_NAME ist Ihre App-ID.

Dann finden Sie das versions Verzeichnis, um alle Versionen zu sehen

Haben Sie das gewusst?

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

IOS-Produktionscrash-Protokolle verstehen

Ihr App-Crash-Protokolle überprüfen

Weitermachen von Debugging

Wenn Sie native Plugin-Arbeit planen Debugging um native Plugin-Arbeit zu planen, verbinden Sie es mit Verwenden Sie @capgo/capacitor-Updater für die native Fähigkeit in Verwenden Sie @capgo/capacitor-Updater Capgo Plugin-Verzeichnis für den Produktworkflow in Capgo Plugin-Verzeichnis Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins von Capgo Hinzufügen oder Aktualisieren von Plugins für die Implementierungsdetails in Hinzufügen oder Aktualisieren von Plugins, und Ionic Enterprise Plugin Alternativen für das Produktworkflow in Ionic Enterprise Plugin Alternativen.