Debugging
Kopieren Sie eine Einrichtungsanleitung mit den Installationsanweisungen und der vollständigen Markdown-Guideline für diesen Plugin.
Verständnis von Cloud-Protokollen
Abschnitt mit dem Titel “Verständnis von Cloud-Protokollen”Wenn Sie eine Cloud-Verweigerung code erhalten und eine tiefergehende Remediation-Anleitung 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-Case-Aktion code und klicken Sie auf die Metadaten-Zelle, um die vollständige JSON-Payload zu kopieren. Metadaten sind insbesondere für Crash- und WebView-Ereignisse nützlich, 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-Protokolle-Table, sodass Sie direkt darauf verweisen können.
Planbegrenzungen und normale Antworten
Abschnitt mit dem Titel “Planbegrenzungen und normale Antworten”Hinweise des Backends im Zusammenhang mit Rechnungsstellung, Einschränkung oder nicht fehlerhaften Zuständen.
InvalidIp
Abschnitt mit dem Titel „InvalidIp“Was bedeutet das?
Capgo hat Verkehr erkannt, der wie von Google oder der Cloud-Infrastruktur aussieht. Updates, die weniger als vier Stunden alt sind, werden ignoriert, damit der Verkehr von Bots nicht als abrechnungspflichtige Geräte gezählt wird.
Was tun?
Ignorieren Sie dies bei echten Benutzern. Versuchen Sie es erneut von einem normalen Netzwerk und einem echten Gerät aus, oder warten Sie und überprüfen Sie es später erneut.
provider_infrastructure_request_blocked
Abschnitt mit dem Titel „provider_infrastructure_request_blocked“Was bedeutet das?
Ihre App ist so konfiguriert, dass sie Anforderungen von bekannten Google- und Apple-Datacenter-IP-Adressen blockiert. Die Schutzfunktion gilt für Updates, Statistiken und Anfragen an den Kanal selbst, sodass Cloud-Hosted-Proben und Provider-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 Verkehr absichtlich ist, deaktivieren Sie temporär Provider-Infrastruktur-Anfragen blockieren In der App-Ansicht, 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. Abschnitt mit dem Titel ‘needPlanUpgrade’ Was bedeutet es
Was tun
Erhöhen Sie Ihr Plan in der Dashboard oder warten Sie auf den nächsten Abrechnungszyklus.
Abschnitt mit dem Titel ‘noNew’
Was bedeutet es
Abschnitt mit dem Titel ‘rateLimited’
In der App-Ansicht, 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.
What bedeutet es
Der Gerät hat zu viele Update- oder Kanal-Anfragen in einem kurzen Zeitfenster gesendet.
Was tun
Stoppen Sie die Aufrufe von Update-APIs innerhalb von Render-Schleifen. Aufrufen Sie sie setChannel / getChannel nur aus Benutzeraktionen aus und setzen Sie defaultChannel in capacitor.config.
Version-Format
Abschnitt mit dem Titel “Version-Format”Hintergrundabnahmen aufgrund ungültiger nativer Versionsmetadaten.
semver_error
Abschnitt mit dem Titel “semver_error”Was bedeutet es
Die native App-Version in der Konfiguration fehlt oder ist nicht gültig semver (x.y.z).
Was tun
Setzen plugins.CapacitorUpdater.version auf gültige SemVer, überprüfen Sie es im SemVer-Tester, dann erneut aufbauen und die native App neu installieren
Plattform und Zielsetzung
Abschnitt mit dem Titel “Plattform und Zielsetzung”Hintergrundabnahmen, wenn die Kanalrichtlinie eine Plattform, einen Buildtyp oder eine Gerätekategorie blockiert
disablePlatformIos
Abschnitt mit dem Titel “disablePlatformIos”Was bedeutet das
Das Gerät läuft unter iOS, aber iOS-Updates sind für diesen Kanal deaktiviert
Was tun
Aktivieren Sie iOS im Kanal, wenn dies versehentlich geschah, oder leiten Sie iOS-Builds in einen dedizierten Kanal ein, wenn das Blockieren beabsichtigt ist.
disablePlatformAndroid
Abschnitt mit dem Titel "disablePlatformAndroid"Was bedeutet das?
Das Gerät läuft unter Android, aber Android-Updates sind für diesen Kanal deaktiviert.
Was tun?
Aktivieren Sie Android im Kanal, wenn dies versehentlich geschah, oder leiten Sie Android-Builds in einen dedizierten Kanal ein, wenn das Blockieren beabsichtigt ist.
disablePlatformElectron
Abschnitt mit dem Titel "disablePlatformElectron"Was bedeutet das?
Das Gerät läuft unter Electron, aber Electron-Updates sind für diesen Kanal deaktiviert.
Was tun?
Aktivieren Sie Electron im Kanal, wenn dies versehentlich geschah, oder leiten Sie Electron-Builds in einen dedizierten Kanal ein, wenn das Blockieren beabsichtigt ist.
disableDevBuild
Abschnitt mit dem Titel "disableDevBuild"Was bedeutet das
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 anderswohin umstellen.
disableProdBuild
Abschnitt mit dem Titel „disableProdBuild“Was bedeutet das
Ein Produktionsbuild heißt /updates, aber Produktionsupdates für diesen Kanal blockiert sind.
Was tun
Produktionsupdates im Kanal zulassen, wenn dies versehentlich geschah, oder Produktionsbuilds auf den richtigen Kanal umleiten.
disableDevice
Abschnitt mit dem Titel „disableDevice“Was bedeutet das
A ein echter Telefon oder Tablet wurde blockiert, weil dieser Kanal echte Geräte blockiert.
Was tun?
Stellen Sie sicher, dass die Echtgeräte-Updates aktiviert sind, wenn dies versehentlich passiert ist, oder lassen Sie die Einschränkung bestehen und leiten Sie die Echtgeräte in einen anderen Kanal um.
disableEmulator
Abschnitt mit dem Titel “disableEmulator”Was bedeutet das?
Das Gerät ist ein Emulator, aber Emulator-Updates sind für diesen Kanal deaktiviert.
Was tun?
Stellen Sie sicher, dass die Emulator-Updates 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
Abschnitt mit dem Titel “Auto-update compatibility rules”Hintergrund-Verweigerungen, wenn semver oder Metadaten-Regeln das Ziel-Paket blockieren.
disableAutoUpdate
Abschnitt mit dem Titel “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
Abschnitt mit dem Titel „disableAutoUpdateUnderNative“Was bedeutet es
Der Kanal hat ein Paket, das älter ist als das Geräte-Grundlage und verhindert die Übertragung von Updates 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
Abschnitt mit dem Titel „disableAutoUpdateMetadata“Was bedeutet das
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
Abschnitt mit dem Titel “disableAutoUpdateToMajor”Was bedeutet das
Der Kanal blockiert Sprünge in der Hauptversion, zum Beispiel 1.x.x bis zu 2.x.x.
Was tun
Passen Sie die Kanalstrategie mit Ihrem Hauptausrollplan ab, oder lassen Sie Sprünge in der Hauptversion für diesen Track zu. Siehe Common Update Problems.
disableAutoUpdateToMinor
Sektion: „disableAutoUpdateToMinor“Was bedeutet das
Der Kanal blockiert Sprünge auf der Ebene der Minor-Versionen im Vergleich zum nativen Gerätegrundlage (version_build), zum Beispiel 1.2.3 zum 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
Sektion: „disableAutoUpdateToPatch“Was bedeutet das
Der Kanal blockiert Änderungen auf der Ebene der Patches, während die gleiche MAJOR.MINOR.PATCH Präfix bleibt; nur Suffix-Änderungen sind erlaubt.
Was tun
Die Veröffentlichungszyklus mit der Kanalpolitik abstimmen oder für diesen Track Patch-Sprünge zulassen.
Kanal einrichten
Abschnitt mit dem Titel "Kanal einrichten"Hintergrundabnahmen aufgrund fehlender oder inkompatibler Kanalkonfiguration.
cannotUpdateViaPrivateChannel
Abschnitt mit dem Titel "kann nicht über privaten Kanal aktualisiert werden"Was bedeutet das
Das Gerät versuchte, sich mit einem privaten Kanal zu verbinden, der die Geräte-Selbstzuweisung nicht zulässt (ist falsch) und der Kanal ist nicht öffentlich.allow_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 "was es bedeutet"
channelMisconfigured
Abschnitt mit dem Titel ‘Kanalfehler’Was bedeutet das
Der Kanal verwendet disable_auto_update: "version_number" aber die Paketdatei min_update_version ist null, also kann Capgo nicht entscheiden, welche Geräte aktualisiert werden sollten
Was tun
Füllen Sie die fehlende Konfiguration für diese Regel oder wechseln Sie zu einem einfacheren automatischen Update-Modus
NoChannelOrOverride
Abschnitt mit dem Titel ‘Kein Kanal oder Übertrag’Was bedeutet das
Kein Standardkanal ist konfiguriert und das Gerät hat keinen Kanal-Übertrag
Was tun
Ein Standardkanal im Dashboard einrichten oder konfigurieren defaultChannel im Build.
Bundlelieferung und -verschlüsselung
Abschnitt: "Bundlelieferung und -verschlüsselung"Hintergrundabnahmen, wenn Capgo die Bundle nicht bereitstellen oder entschlüsseln kann.
cannotGetBundle
Abschnitt: "kannBundleNichtHerunterladen"Was bedeutet das?
Capgo konnte keine gültige signierte Herunterladelink generieren und es war kein Manifest-Alternativfall verfügbar.
Was tun?
Das Bundle erneut hochladen, Manifeste erneut generieren und R2- oder öffentliche Bundle-Einstellungen überprüfen.
missingBundle
Abschnitt: "fehlendesBundle"Was bedeutet das?
Das dem Kanal zugewiesene Bundle enthält keine herunterladbaren Inhalte: keine external_urlKeine r2_pathKeine native Version und keine Manifest-Einträge.
Was tun
Die Version neu erstellen und hochladen und bestätigen, dass die Bundle echte Dateien enthält.
keyMismatch
Abschnitt mit dem Titel “keyMismatch”Was bedeutet
Die öffentliche Verschlüsselungsschlüssel des Geräts entspricht nicht dem Schlüssel, der zum Verschlüsseln des Bundles verwendet wurde. Die Metadaten können device_key_id, bundle_key_idund version.
Was tun
Die Gerätschlüssel- und Bundelschlüssel-IDs im Konsole vergleichen. Mit dem gleichen Schlüssel und den übereinstimmenden CLI/Plugin-Versionen veröffentlichen.
Anwendungskonfiguration und Legacy-Kunden
Abschnitt mit dem Titel “Anwendungskonfiguration und Legacy-Kunden”Hinweise des Backends aufgrund der Anwendungs-Konfiguration oder nicht unterstützter Updater-Versionen.
customIdBlocked
Sektion mit dem Titel “customIdBlocked”Was bedeutet
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
Sektion mit dem Titel “blocked_by_server_url”Was bedeutet
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 lokale Aktualisierungsdaten. Dieser code kann als Backend-Verweigerung oder als Geräteseitenevent auftreten.
backend_refusal
Abschnitt mit dem Titel “backend_refusal”Was bedeutet es
Der Updater-Plugin ist v4, was das Backend nicht mehr akzeptiert.
Was tun
Das Plugin und CLI auf v5+ (vorzugsweise v8) aktualisieren, mit Capacitor v5+ neu bauen und das Bundle-Metadaten neu veröffentlichen.
Aktualisierungslebenzyklus
Abschnitt mit dem Titel “Update lifecycle”Geräteseitige Ereignisse für den normalen Aktualisierungsfluss, Aktivierung und Rollover.
Was bedeutet es
Interne Testaktion zur Überprüfung des Statistikpipeline.
Was bedeutet das
Capgo hat dem Gerät Informationen über eine neue Version zum Download geschickt.
Was bedeutet das
Ein Bundle wurde auf dem Gerät aktiviert.
Was bedeutet das
Was tun
Überprüfen Sie native Protokolle mit
und überprüfen Sie die Integrität, Pfade und npx @capgo/cli@latest app debug des Bundles notifyAppReady flow.
Was bedeutet es
Das Gerät wurde auf die integrierte Bundle zurückgesetzt.
Was bedeutet es
Ein Bundle wurde auf dem Gerät gelöscht.
Herunterladen und Installationsfehler
Abschnitt mit dem Titel “Herunterladen und Installationsfehler”Geräte-seitige Ereignisse für den Download-Progress, Archiv-Validierung und Installationsfehler.
Was bedeutet es
Der Download-Prozess begann bei 0% Fortschritt.
download_10
Abschnitt mit dem Titel "download_10"Was bedeutet das?
Ein neuer Bundle wurde heruntergeladen — Fortschritt angezeigt bei 10%.
download_20
Abschnitt mit dem Titel "download_20"Was bedeutet das?
Ein neuer Bundle wurde heruntergeladen — Fortschritt angezeigt bei 20%.
download_30
Abschnitt mit dem Titel "download_30"Was bedeutet das?
Ein neuer Bundle wurde heruntergeladen — Fortschritt angezeigt bei 30%.
download_40
Abschnitt mit dem Titel "download_40"Was bedeutet das?
Ein neuer Bundle wurde heruntergeladen — Fortschritt angezeigt bei 40%.
download_50
Abschnitt mit dem Titel “download_50”Was bedeutet das
Ein neuer Bundle wurde heruntergeladen — Fortschritt angezeigt bei 50%.
download_60
Abschnitt mit dem Titel “download_60”Was bedeutet das
Ein neuer Bundle wurde heruntergeladen — Fortschritt angezeigt bei 60%.
download_70
Abschnitt mit dem Titel “download_70”Was bedeutet das
Ein neuer Bundle wurde heruntergeladen — Fortschritt angezeigt bei 70%.
download_80
Abschnitt mit dem Titel “download_80”Was bedeutet das
Ein neuer Bundle wurde heruntergeladen — Fortschritt angezeigt bei 80%.
download_90
Abschnitt mit dem Titel “download_90”Was bedeutet das
Ein neuer Bundle wurde heruntergeladen — Fortschritt angezeigt bei 90%.
download_complete
Abschnitt mit dem Titel “download_complete”Was bedeutet das
Das Bundle-Download war erfolgreich abgeschlossen.
download_manifest_start
Abschnitt mit dem Titel “download_manifest_start”Was bedeutet das
Das Gerät begann mit dem Herunterladen des Update-Manifests.
download_manifest_complete
Abschnitt mit dem Titel “download_manifest_complete”Was bedeutet das
Das Gerät hat das Update-Manifest heruntergeladen.
download_zip_start
Abschnitt mit der Überschrift "download_zip_start"Was bedeutet das?
Das Gerät hat das Bundle-Archiv heruntergeladen.
download_zip_complete
Abschnitt mit der Überschrift "download_zip_complete"Was bedeutet das?
Das Gerät hat das Bundle-Archiv heruntergeladen.
download_manifest_file_fail
Abschnitt mit der Überschrift "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 Ressource korrigieren, das Manifest neu generieren und das Bundle erneut hochladen.
download_manifest_checksum_fail
Abschnitt mit dem Titel “download_manifest_checksum_fail”Was bedeutet
Ein Manifest-Datei-Prüfsummen-Übereinstimmung fehlgeschlagen ist.
Was tun
Das Bundle mit einer aktuellen CLI-Version erneut hochladen und Manifest-Prüfsummen überprüfen.
download_manifest_brotli_fail
Abschnitt mit dem Titel “download_manifest_brotli_fail”Was bedeutet
Ein Manifest-Datei-Entpacken-Brotli fehlgeschlagen ist.
Was tun
Kompressions-Einstellungen überprüfen und betroffene Assets erneut hochladen.
download_fail
Abschnitt mit dem Titel ‘download_fail’Was bedeutet das
Der Bundle konnte nicht heruntergeladen werden
Was tun
Überprüfen Sie die Netzwerkverbindung, die Ablaufzeit der signierten URL, die CDN-Erreichbarkeit und die Speicherung des Geräts
update_fail
Abschnitt mit dem Titel ‘update_fail’Was bedeutet das
Der Bundle wurde installiert, aber die App rief nie notifyAppReady, also wurde Capgo zurückgerollt
Was tun
Rufen Sie nach dem Abschließen der App-Initialisierung auf notifyAppReady() nach Ihrer App-Initialisierung notifyAppReady was not called, roll back current bundle code
checksum_fail
Abschnitt mit dem Titel ‘Fehlschlag der Prüfsumme’Was bedeutet das
Die heruntergeladene Bundle hat die Prüfsummenvalidierung nicht bestanden. Häufige Ursachen: CRC32 vs SHA256-Mismatch aus einem alten CLI-Upload, oder Verschlüsselungsschlüsselmismatch bei älteren Plugins, die Verschlüsselungsfehler als Prüfsummenfehler ausgeben.
Was tun
Wiederherunterladen mit einem aktuellen CLI/Plugin (SHA256). Wenn Verschlüsselung verwendet wird, überprüfen Sie, ob die App-Öffentliche-Schlüssel mit dem Upload-Schlüssel übereinstimmen, oder aktualisieren Sie auf Plugin 8.3.0+ für explizite keyMismatch Abschnitt mit dem Titel ‘Fehlschlag der Entschlüsselung’
decrypt_fail
Was bedeutet dasDie heruntergeladene Bundle ist nicht entschlüsselt worden.
Was tun
Überprüfen Sie die Verschlüsselungsschlüssel und laden Sie das Bundle mit dem passenden Schlüsselpaar erneut herunter.
Abschnitt mit dem Titel ‘Fehlschlag der Entschlüsselung’
windows_path_fail
Abschnitt mit dem Titel “windows_path_fail”Was bedeutet das?
Der Zip-Ordner enthält illegale Windows-Pfade.
Was tun?
Bauen Sie das Bundle auf Unix-Pfaden oder reinigen Sie die Archivpfade vor dem Hochladen.
canonical_path_fail
Abschnitt mit dem Titel “canonical_path_fail”Was bedeutet das?
Die Dateipfade im Zip-Ordner sind nicht kanonisch.
Was tun?
Beheben Sie die Pfadgenerierung im Archiv vor dem Hochladen.
directory_path_fail
Abschnitt mit dem Titel “directory_path_fail”Was bedeutet das?
Der Zip-Ordner enthält ungültige Verzeichnispfade.
Was tun?
Behebe die Archivstruktur vor dem Upload.
unzip_fail
Sektion mit dem Titel „unzip_fail“Was bedeutet das?
Das Gerät ist beim Entpacken des heruntergeladenen Bundles gescheitert.
Was tun?
Überprüfe die Integrität des Archivs und unterstützte Komprimierung.
low_mem_fail
Sektion mit dem Titel „low_mem_fail“Was bedeutet das?
Der Download ist fehlgeschlagen, weil das Gerät keinen Speicherplatz mehr hatte.
Was tun?
Kleiner Bundle-Größe oder Wiederholen auf einem Gerät mit mehr freiem Speicher.
Anwendungszustand und WebView-Ereignisse
Abschnitt mit dem Titel ‘Anwendungszustand und WebView-Ereignisse’Geräteseitige Crash-, Speicher- und WebView-Diagnosen. Inspektorische Überprüfung der Metadaten-JSON im Dashboard immer anwenden.
app_moved_to_background
Abschnitt mit dem Titel ‘app_moved_to_background’Was bedeutet es
Die Anwendung ist in den Hintergrund gegangen.
app_moved_to_foreground
Abschnitt mit dem Titel ‘app_moved_to_foreground’Was bedeutet es
Die Anwendung ist in den Vordergrund gegangen.
app_crash
Abschnitt mit dem Titel ‘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. Koppeln Sie die JS- und native Fehlerberichterstellung (z. B. Sentry) zum lokalisieren des fehlenden code Weges.
app_crash_native
Abschnitt mit dem Titel ‘app_crash_native’Was bedeutet es
Native Plattform abstürzt. Die Metadaten können Plattform, Grund, Stapel und Prozessdetails enthalten.
Was tun
Verwenden Sie Xcode oder Logcat-Crash-Logs und korrelieren Sie sie mit dem aktiven Bundle aus den Metadaten.
Was bedeutet es
Android-Anwendung nicht reagiert (ANR).
Was tun
Überprüfen Sie die ANR-Protokolle in Logcat und reduzieren Sie die Blockierung der Hauptthread nach Updates.
app_killed_low_memory
Abschnitt mit dem Titel “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 für verfügbare Speichersignale.
app_killed_excessive_resource_usage
Abschnitt mit dem Titel “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
Abschnitt mit dem Titel “app_initialization_failure”Was bedeutet das?
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
Abschnitt mit dem Titel “app_memory_warning”Was bedeutet das?
iOS-Memory-Warnung.
Was tun?
Überprüfen Sie den Speicherkontext in den Metadaten und reduzieren Sie die Spitzenlast nach Updates.
webview_javascript_error
Abschnitt mit dem Titel “webview_javascript_error”Was bedeutet das?
Unbehandelter 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
Abschnitt mit dem Titel “webview_unhandled_rejection”Was bedeutet es
Eine unbehandelte Promise-Ablehnung im WebView.
Was tun
Fangen Sie Asynchronfehler mit JS- und native Fehlerberichterstellung auf.
webview_resource_error
Abschnitt mit dem Titel “webview_resource_error”Was bedeutet es
Ein WebView-Ressourcen-Loadvorgang ist fehlgeschlagen.
Was tun
Verwenden Sie Metadaten-URL und Statusdetails, um beschädigte Assets oder Netzwerkregeln zu beheben.
webview_security_policy_violation
Abschnitt mit dem Titel “webview_security_policy_violation”Was bedeutet es
Der Inhaltssicherheitspolicy hat eine Ressource blockiert.
Was tun
Anpassen Sie den CSP mithilfe der Metadaten-Direktive und den Details der blockierten URI.
webview_unclean_restart
Abschnitt mit dem Titel “webview_unclean_restart”Was bedeutet es
Die vorherige WebView-Sitzung wurde nicht sauber beendet, 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
Abschnitt mit dem Titel “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
Abschnitt mit dem Titel „webview_content_process_terminated“Was bedeutet das?
iOS WebView-Inhaltprozess beendet.
Was tun?
Überprüfen Sie die aktuelle Bundle und die Seite-URL aus den Metadaten.
Umgebung und Kanalkontext
Abschnitt mit dem Titel „Environment and channel context“Geräteseitige Kontextereignisse, die helfen, das Updateverhalten mit dem Betriebssystem, der nativen Version oder den Kanaländerungen zu korrelieren.
os_version_changed
Abschnitt mit dem Titel „os_version_changed“Was bedeutet das
Die Geräte-OS-Version wurde zwischen den Überprüfungen geändert.
native_app_version_changed
Abschnitt mit dem Titel “native_app_version_changed”Was bedeutet das
Die native App-Store-Version wurde geändert, wodurch native und Web-Bundle-Änderungen getrennt werden können.
getChannel
Abschnitt mit dem Titel “getChannel”Was bedeutet das
Das Gerät hat seine aktuelle Kanalabfrage durchgeführt.
setChannel
Abschnitt mit dem Titel “setChannel”Was bedeutet das
Ein Kanal wurde erfolgreich für das Gerät gesetzt.
uninstall
Abschnitt mit dem Titel “uninstall”Was bedeutet das
Die App wurde deinstalliert oder die Capgo Daten wurden gelöscht.
Bundle-Status
Abschnitt mit dem Titel „Bundle-Status“SUCCESS: Installationsbundle erfolgreich installiertERROR: Installieren oder herunterladen fehlgeschlagenPENDING: Herunterladen erfolgreich, Freigabe noch ausstehendDELETED: Bundle wurde gelöscht, aber noch für Statistiken angezeigtDOWNLOADING: Aktuell wird ein Bundle heruntergeladen
Geräteprotokolle verstehen
Abschnitt mit dem Titel „Geräteprotokolle verstehen“Debug-Befehl
Abschnitt mit dem Titel “Fehlertreiber”Für Capgo-Cloud-Nutzer gibt es einen Fehlertreiber.
npx @capgo/cli@latest app debugMit 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 findenGeräteprotokoll in Xcode abrufen
Um Ihre Protokolle in Android Studio zu finden
Geräteprotokolle in Android Studio abrufenAbschnitt mit dem Titel “iOS native Protokolle”
Native Protokollierungsphrasenabbildung
Abschnitt mit dem Titel "Native Protokollierungsphrasenabbildung"Failed to download fromentsprichtdownload_failnotifyAppReady was not called, roll back current bundleentsprichtupdate_fail
Das heruntergeladene Bundle auf einem Gerät finden
Abschnitt mit dem Titel "Das heruntergeladene Bundle auf einem Gerät finden"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 zur Inspektion 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 aus, die Sie untersuchen möchten, und wählen Sie dann das 3-Punkte-Symbol in der unteren Ecke des Bildschirms aus.
- Hier können Sie das aktuelle Dateisystem anzeigen, indem Sie "Download a snapshot of it" auswählen.

Durch "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
Abschnitt mit dem Titel „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 Ordner, um alle Versionen zu sehen
Verständnis von ios-Produktionscrash-Protokollen
Abschnitt mit dem Titel ‘Verständnis von ios-Produktionscrash-Protokollen’Fortsetzen Sie von Debugging
Abschnitt mit dem Titel ‘Fortsetzen Sie von Debugging’Wenn Sie native Plugin-Arbeiten durchführen Debugging um native Plugin-Arbeiten 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.