Debugging
Kopieren Sie einen Einrichtungsbefehl mit den Installationsanweisungen und der vollständigen Markdown-Dokumentation für diesen Plugin.
Verständnis von Cloud-Protokollen
Abschnitt mit dem Titel „Verständnis von Cloud-Protokollen“Wenn Sie ein Cloud-Verweigerungsverhalten code erhalten und tiefergehende Remediation-Anleitungen benötigen, sehen Sie sich an Gemeinsame Update-Probleme.
Capgo-Protokolle können Metadaten für das Ereignis enthalten. In der Dashboard-Ansicht filtern Sie nach dem snake_case-Aktionstyp code und klicken Sie auf die Metadaten-Zelle, um den vollständigen JSON-Payload zu kopieren. Metadaten sind insbesondere bei Crash- und WebView-Ereignissen nützlich, da sie den Fehlercode, die Quell-URL, die Zeilen- und Spaltennummer, den Prozessstatus, den Speicherdruck oder die plattform-spezifische Ursache enthalten können. Ältere Protokolle können noch Legacy-CamelCase-Aliase in Klammern auflisten.
Jeder Abschnittstitel entspricht der Aktion code im Protokoll-Tab, sodass Sie direkt darauf verweisen können.
Planbegrenzungen und normale Antworten
Abschnitt mit dem Titel “Planbegrenzungen und normale Antworten”Hintergrundverweigerungen im Zusammenhang mit Abrechnung, Drosselung oder Nichtfehlerzuständen
InvalidIp
Abschnitt mit dem Titel “InvalidIp”Was bedeutet das?
Capgo hat Traffic erkannt, der wie von Google oder Cloud-Infrastruktur stammt. Updates unter vier Stunden alt werden ignoriert, damit Bot-Traffic nicht als abrechenbare 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
Abschnitt mit dem Titel “provider_infrastructure_request_blocked”What bedeutet es
Deine App ist so konfiguriert, dass sie Anfragen von bekannten Google- und Apple-Datencenter-IP-Adressen blockiert. Die Schutzeinstellung gilt für Aktualisierungsprüfungen, Statistiken und channel-self-Anfragen, sodass Cloud-Hosted-Proben und Provider-Runner diese Antwort auch erhalten können, wenn die App-Konfiguration ansonsten gültig ist.
Was tun
Versuche es erneut von einem physischen Gerät auf einem normalen Benutzer-Netzwerk. Wenn der provider-herkommende Traffic absichtlich ist, deaktiviere temporär Blockiere Anfragen an Provider-Infrastruktur im App’s Informationen Registerkarte, dann aktiviere sie wieder nach dem Test. Neue Apps aktivieren diese Einstellung standardmäßig; bestehende Apps behalten ihre vorherige deaktivierte Einstellung, bis sie geändert werden.
needPlanUpgrade
Abschnitt mit dem Titel “needPlanUpgrade”Was bedeutet es
Deine Organisation hat ihre Plangeschätzung oder Gerätebegrenzung erreicht. Das Gerät erhält keine Updates, bis du dich aktualisierst oder der nächste Abrechnungszyklus die Nutzung zurücksetzt.
Was tun
Upgrade your Plan im Dashboard oder warten Sie auf das nächste Abrechnungszyklus.
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
Abschnitt mit dem Titel “rateLimited”Was bedeutet das
Was tun
Stoppen Sie die Aufrufe von Update-APIs innerhalb von Render-Schleifen. Rufen Sie sie
nur von Benutzeraktionen aus an und setzen Sie setChannel / getChannel in defaultChannel Version-Format capacitor.config.
_CAPGO_KEEP_0_
Abschnitt mit dem Titel „Version format“Hintergrund-Verweigerungen aufgrund ungültiger Native-Version-Metadaten.
semver_error
Abschnitt mit dem Titel „semver_error“Was bedeutet das
Die Native-App-Version in der Konfiguration fehlt oder ist nicht gültig (x.y.z).
Was tun
Setzen plugins.CapacitorUpdater.version zu einer gültigen semver, überprüfen Sie es in der SemVer-Tester, dann neu erstellen und die Native-App neu installieren.
Plattform und Zielsetzung für die Erstellung
Abschnitt mit dem Titel „Platform and build targeting“Hintergrundabnahmen, wenn der 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 absichtlich 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 absichtlich ist.
disablePlatformElectron
Abschnitt mit dem Titel „disablePlatformElectron“Was bedeutet es
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 absichtlich ist.
disableDevBuild
Abschnitt mit dem Titel “disableDevBuild”Was bedeutet es
Das Gerät ist ein Entwicklungsbuild, aber Entwicklungsbuilds sind für diesen Kanal blockiert.
Was tun
Lassen Sie Entwicklungsbuilds in einem Testkanal zu, oder halten Sie diesen Kanal release-only und bewegen Sie Entwicklungsgeräte anderswohin.
disableProdBuild
Abschnitt mit dem Titel “disableProdBuild”Was bedeutet es
Ein Produktionsbuild wurde aufgerufen /updates, aber Produktionsupdates werden für diesen Kanal blockiert.
Was tun
Erlauben Sie Produktionsupdates im Kanal, wenn dies versehentlich geschah, oder leiten Sie Produktionsbuilds auf den richtigen Kanal um.
disableDevice
Abschnitt mit dem Titel “disableDevice”Was bedeutet es
Ein echter Smartphone oder Tablet wurde blockiert, weil dieser Kanal echte Geräte blockiert.
Was tun
Aktivieren Sie die Updates für echte Geräte, wenn dies versehentlich geschah, oder lassen Sie die Einschränkung bestehen und leiten Sie echte Geräte auf einen anderen Kanal um.
disableEmulator
Abschnitt mit dem Titel “disableEmulator”Was bedeutet es
Das Gerät ist ein Emulator, aber Emulator-Updates sind für diesen Kanal deaktiviert.
Was tun
Aktiviere Emulatorenaktualisierungen in einem Testkanal oder halte diesen Kanal auf Emulatorenblockierungen und verwende einen anderen Kanal für die Emulatorenvalidierung.
Automatische Aktualisierungen von Kompatibilitätsregeln
Abschnitt mit dem Titel „Automatische Aktualisierungen von Kompatibilitätsregeln“Hintergrundablehnungen, wenn semver- oder Metadatenaufgaben die Zielbundle blockieren.
disableAutoUpdate
Abschnitt mit dem Titel „disableAutoUpdate“Was bedeutet das?
Automatische Aktualisierungen sind durch die Kanalkompatibilitätsrichtlinie deaktiviert. Die Metadaten enthalten auto_update mit einer entsprechenden Regel wie major, minor, patch, metadataoder none.
Was tun?
Ändere die Kanalrichtlinie für automatische Aktualisierungen, um deine geplante Rollout zuzulassen.
disableAutoUpdateUnderNative
Abschnitt mit dem Titel „disableAutoUpdateUnderNative“Was bedeutet es
Der Kanal hat ein Bundle, das älter ist als das Geräte-Baseline und blockiert die Übertragung von Updates unter der nativen Version.
Was tun
Veröffentlichen Sie ein Bundle bei oder über der nativen Basislinie oder deaktivieren Sie die unter-nativen Schutzfunktion im Kanal.
disableAutoUpdateMetadata
Abschnitt mit dem Titel „disableAutoUpdateMetadata“Was bedeutet es
Der Kanal erfordert min_update_version, aber die Geräte-nativen Version ist unter diesem Schwellenwert.
Was tun
Setzen Sie min_update_version auf dem Ziel-Bundle oder Release von einer neueren nativen Version.
disableAutoUpdateToMajor
Abschnitt mit dem Titel „disableAutoUpdateToMajor“Was bedeutet es
Der Kanal blockiert Sprung in die nächste Hauptversion, zum Beispiel 1.x.x zu 2.x.x.
Was tun
Passen Sie die Kanalstrategie mit Ihrem Hauptrollout-Plan an oder lassen Sie Sprünge in die nächste Hauptversion für diesen Kanal zu. Siehe Häufige Update-Probleme.
disableAutoUpdateToMinor
Abschnitt mit dem Titel “disableAutoUpdateToMinor”Was bedeutet es
Der Kanal blockiert Sprünge in die nächste Minorversion relativ zur Geräte-Standard-Basis (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 kleine Sprünge für diesen Track zu.
disableAutoUpdateToPatch
Abschnitt mit dem Titel “disableAutoUpdateToPatch”Was bedeutet das
Die Kanäle blockieren Änderungen auf Patch-Ebene, während die gleiche MAJOR.MINOR.PATCH Präfix; nur Suffix-Änderungen sind erlaubt.
Was tun
Passen Sie die Release-Frequenz mit der Kanalpolitik an oder lassen Sie Patch-Sprünge für diesen Track zu.
Kanal-Einstellungen
Abschnitt mit dem Titel “Channel setup”Hintergrundablehnungen aufgrund fehlender oder inkompatibler Kanal-Konfiguration.
cannotUpdateViaPrivateChannel
Abschnitt mit dem Titel “cannotUpdateViaPrivateChannel”Was bedeutet das
Das Gerät versuchte, sich mit einem privaten Kanal zu verbinden, der die Geräte-Selbstzuweisung nicht zulässt ("is false") und der Kanal ist nicht öffentlich.allow_device_self_set Was tun
Aktivieren Sie
auf dem Kanal oder wechseln Sie das Gerät auf einen öffentlichen oder zulässigen Kanal. allow_device_self_set Abschnitt mit dem Titel “channelMisconfigured”
channelMisconfigured
Was bedeutet dasDer Kanal verwendet
aber das Bundle disable_auto_update: "version_number" ist null, daher kann __CAPGO_KEEP_0__ nicht entscheiden, welche Geräte aktualisiert werden sollen. min_update_version is null, so Capgo cannot decide which devices should update.
Füllen Sie die fehlende Konfiguration für diese Regel oder wechseln Sie zu einem einfacheren Auto-Update-Modus.
Abschnitt mit dem Titel “channelMisconfigured”
NoChannelOrOverride
Abschnitt mit dem Titel “Keine Kanal oder Überschreibung”Was bedeutet das
Keine Standardkanal ist konfiguriert und das Gerät hat keine Kanalüberschreibung.
Was tun
Setze einen Standardkanal in der Dashboard oder konfiguriere defaultChannel in der Build.
Bündel Lieferung und Verschlüsselung
Abschnitt mit dem Titel “Bündel Lieferung und Verschlüsselung”Hintergrund Ablehnungen wenn Capgo nicht liefern oder entschlüsseln kann.
cannotGetBundle
Abschnitt mit dem Titel “kann nicht Bundle holen”Was bedeutet das
Capgo konnte keine gültige signierte Download-URL generieren und keine Manifest-Alternative war verfügbar.
Was tun
Laden Sie die Bundle neu hoch, generieren Sie die Manifeste neu und überprüfen Sie die Einstellungen für R2 oder das öffentliche Bundle.
missingBundle
Abschnitt mit dem Titel „missingBundle“Was bedeutet das
Das dem Kanal zugewiesene Bundle enthält keine herunterladbaren Inhalte: keine external_url, keine r2_path, keine integrierte Version und keine Einträge im Manifest.
Was tun
Bauen und neu hochladen Sie die Version, dann bestätigen Sie, dass das Bundle echte Dateien enthält.
keyMismatch
Abschnitt mit dem Titel „keyMismatch“Was bedeutet das
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_idWas tun version.
Im Konsolenfenster werden die Geräte- und Bundle-Schlüssel-IDs verglichen. Veröffentlichen Sie mit demselben Schlüssel und den übereinstimmenden __CAPGO_KEEP_0__/Plugin-Versionen.
Compare device and bundle key IDs in the console. Publish with the same key and matching CLI/plugin versions.
Abschnitt mit dem Titel „Anwendungskonfiguration und Legacy-Clients“
Hintergrundabnahmen aufgrund von Anwendungskonfigurationen oder nicht unterstützten Updater-Versionen.Abschnitt mit dem Titel „customIdBlocked“
customIdBlocked
Was bedeutetDie App hat ein benutzerdefiniertes Geräte-ID gesendet, aber diese App akzeptiert keine benutzerdefinierten IDs, daher wird die ID ignoriert.
Was tun
Stoppen Sie das Senden von benutzerdefinierten IDs oder aktivieren Sie benutzerdefinierte IDs nur, wenn Ihr Workflow sie erfordert.
Abschnitt mit dem Titel „blocked_by_server_url“
blocked_by_server_url
Was tunWas bedeutet es
server.url wird in der Capacitor Konfiguration festgelegt, sodass die WebView eine remote URL anstatt lokaler Bundle-Dateien lädt. Capgo Live-Updates erfordern lokale Dateien und server.url wird in der Produktion abgeraten.
Was tun
Entfernen oder löschen server.url für Produktionsbuilds und behalten Sie die Update-Payloads lokal. Diese code kann als Backend-Verweigerung oder als Geräteseitensignal erscheinen.
backend_refusal
Abschnitt mit dem Titel “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 die Bundle-Metadaten neu veröffentlichen.
Update-Lifecycle
Abschnitt mit dem Titel “Update-Lebenszyklus”Geräte-seitige Ereignisse für den normalen Update-Flow, Aktivierung und Rollover.
Was bedeutet das
Interne Testaktion, um die Stats Pipeline zu überprüfen.
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 es
Ein Bundle ist auf dem Gerät nicht aktiviert worden.
Was tun
Überprüfe native Logs mit npx @capgo/cli@latest app debug und überprüfe die Bundle-Integrität, Pfade und notifyAppReady Fluss.
Was bedeutet es
Das Gerät wurde auf das Standard- Bundle zurückgesetzt.
Was bedeutet es
Ein Bundle wurde auf dem Gerät gelöscht.
Herunterladen und Installationsfehler
Abschnitt: 'Herunterladen und Installationsfehler'Geräte-seitige Ereignisse für das Herunterladen des Fortschritts, der Archiv-Validierung und Installationsfehler.
download_0
Abschnitt: 'download_0'Was bedeutet das
Der Herunterladungsprozess begann bei 0% Fortschritt.
download_10
Abschnitt: 'download_10'Was bedeutet das
Ein neuer Bundle wurde heruntergeladen – Fortschritt angezeigt bei 10%.
download_20
Abschnitt: 'download_20'Was bedeutet das
Ein neuer Bundle wurde heruntergeladen – Fortschritt angezeigt bei 20%.
download_30
Abschnitt mit dem Titel “herunterladen_30”Was bedeutet es
Ein neuer Bundle wurde heruntergeladen – Fortschritt angezeigt bei 30%.
download_40
Abschnitt mit dem Titel “herunterladen_40”Was bedeutet es
Ein neuer Bundle wurde heruntergeladen – Fortschritt angezeigt bei 40%.
download_50
Abschnitt mit dem Titel “herunterladen_50”Was bedeutet es
Ein neuer Bundle wurde heruntergeladen – Fortschritt angezeigt bei 50%.
download_60
Abschnitt mit dem Titel “herunterladen_60”Was bedeutet es
Ein neuer Bundle wurde heruntergeladen – Fortschritt angezeigt bei 60%.
download_70
Abschnitt mit dem Titel “download_70”Was bedeutet es
Ein neuer Bundle wurde heruntergeladen — Fortschritt angezeigt bei 70%.
download_80
Abschnitt mit dem Titel “download_80”Was bedeutet es
Ein neuer Bundle wurde heruntergeladen — Fortschritt angezeigt bei 80%.
download_90
Abschnitt mit dem Titel “download_90”Was bedeutet es
Ein neuer Bundle wurde heruntergeladen — Fortschritt angezeigt bei 90%.
download_complete
Abschnitt mit dem Titel “download_complete”Was bedeutet es
Der Bundle-Download war erfolgreich abgeschlossen.
download_manifest_start
Abschnitt mit dem Titel "download_manifest_start"Was bedeutet das?
Das Gerät begann, das Update-Manifest herunterzuladen.
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 dem Titel "download_zip_start"Was bedeutet das?
Das Gerät begann, das Archivbundle herunterzuladen.
download_zip_complete
Abschnitt mit dem Titel "download_zip_complete"Was bedeutet das?
Das Gerät hat das Archivbundle heruntergeladen.
download_manifest_file_fail
Sektion mit dem Titel „download_manifest_file_fail“Was bedeutet das
Ein Manifesteintrag konnte nicht heruntergeladen werden. version_name wird verwendet version:fileName um den Asset zu identifizieren.
Was tun
Fixieren Sie den fehlenden oder blockierten Asset, regenerieren Sie das Manifest und laden Sie das Bundle erneut hoch.
download_manifest_checksum_fail
Sektion mit dem Titel „download_manifest_checksum_fail“Was bedeutet das
Ein Manifestdatei hat die Prüfsummenvalidierung nicht bestanden.
Was tun
Laden Sie das Bundle mit einer aktuellen CLI Version hoch und überprüfen Sie die Manifestprüfsummen.
download_manifest_brotli_fail
Abschnitt mit dem Titel "download_manifest_brotli_fail"Was bedeutet das?
Ein Manifest-File ist bei der Brotli-Entschlüsselung gescheitert.
Was tun?
Überprüfen Sie die Komprimierungs-Einstellungen und laden Sie die betroffenen Assets erneut hoch.
download_fail
Abschnitt mit dem Titel "download_fail"Was bedeutet das?
Die Bundle-Datei konnte nicht heruntergeladen werden.
Was tun?
Überprüfen Sie die Netzwerkverbindung, die Ablaufzeit der signierten URL, die Erreichbarkeit des CDN und die Speicherung auf dem Gerät.
update_fail
Abschnitt mit dem Titel "update_fail"Was bedeutet das?
Die Bundle wurde installiert, aber die App rief sie nie auf. notifyAppReady, so Capgo wurde zurückgerollt.
Was tun
Call notifyAppReady() nachdem die App sich gebootet hat. Native Log Text notifyAppReady was not called, roll back current bundle mappen sich auf diesen code.
checksum_fail
Abschnitt mit dem Titel „checksum_fail“Was bedeutet das
Die heruntergeladene Bundle hat die Prüfung der Checksumme 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 Checksummfehler ausgeben.
Was tun
Wiederherunterladen mit einem aktuellen CLI/Plugin (SHA256). Wenn Verschlüsselung verwendet wird, überprüfen Sie, ob die App-Publiksschlüssel mit dem Upload-Schlüssel übereinstimmt, oder aktualisieren Sie auf Plugin 8.3.0+ für explizite keyMismatch Fehler.
decrypt_fail
Abschnitt mit dem Titel “decrypt_fail”Was bedeutet das
Der heruntergeladene Bundle konnte nicht entschlüsselt werden.
Was tun
Überprüfen Sie die Verschlüsselungsschlüssel und laden Sie das Bundle mit dem passenden Schlüsselpaar erneut hoch.
windows_path_fail
Abschnitt mit dem Titel “windows_path_fail”Was bedeutet das
Der Zip 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
Dateien innerhalb der Zip sind nicht kanonisch.
Was tun
Beheben Sie die Erzeugung des Archivpfads vor dem Upload.
directory_path_fail
Abschnitt mit dem Titel „directory_path_fail“Was bedeutet es
Das Zip enthält ungültige Verzeichnispfade.
Was tun
Beheben Sie die Archivstruktur vor dem Upload.
unzip_fail
Abschnitt mit dem Titel „unzip_fail“Was bedeutet es
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
Abschnitt mit dem Titel “low_mem_fail”Was bedeutet das
Der Download ist fehlgeschlagen, weil das Gerät an Speicherplatz ausgelaufen ist.
Was tun
Reduzieren Sie die Größe des Bundles oder versuchen Sie es auf einem Gerät mit mehr freiem Speicherplatz.
Anwendungs- und WebView-Ereignisse
Abschnitt mit dem Titel “Anwendungs- und WebView-Ereignisse”Geräteseitige Crash-, Speicher- und WebView-Diagnosen. Inspektorieren Sie immer die Metadaten-JSON-Daten im Dashboard.
app_moved_to_background
Abschnitt mit dem Titel “app_moved_to_background”Was bedeutet das
Die Anwendung ist in den Hintergrund gerückt.
app_moved_to_foreground
Abschnitt mit dem Titel “app_moved_to_foreground”Was bedeutet es
Die App wurde in den Vordergrund gebracht.
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 einen aktiven Bundle-Kontext enthalten.
Was tun
Überprüfen Sie die Metadaten und die native Logs. Verbinden Sie die JS- und native Fehlerberichterstattung (z.B. Sentry) zum Lokalisieren des fehlerhaften code Pfads.
app_crash_native
Abschnitt mit dem Titel “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 der aktiven Bundle aus den Metadaten.
Was bedeutet das
Android-Anwendung nicht reagiert (ANR) Ereignis.
Was tun
Überprüfen Sie die ANR-Tracks in Logcat und reduzieren Sie nach Updates die Blockierung der Haupt-Thread-Arbeit.
app_killed_low_memory
Abschnitt mit dem Titel “app_killed_low_memory”Was bedeutet das
Das Betriebssystem hat die App nach Druck auf die Speicherfläche getötet.
Was tun
Reduzieren Sie den Speicherbedarf nach Aktivierung von Updates und überprüfen Sie die Metadaten auf 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äßigem Ressourcenverbrauch beendet.
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 es
Der Updater oder der Startvorgang ist vor der normalen Laufzeit bereitgestellt.
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 es
iOS-Memory-Warnung.
Was tun
Speichereinbindung in der Metadaten überprüfen und Peak-Nutzung nach Updates reduzieren.
webview_javascript_error
Abschnitt mit dem Titel “webview_javascript_error”Was bedeutet das
Unbehandelter JavaScript-Fehler im WebView. Die Metadaten können eine Nachricht, die Quell-URL, die Zeile, die Spalte und die Stack-Informationen enthalten.
Was tun
Fehlerberichts-Installation in JS- und native Layers durchführen, um die genaue fehlende Zeile in der Produktion zu erfassen.
webview_unhandled_rejection
Abschnitt mit dem Titel “webview_unhandled_rejection”Was bedeutet das
Unbehandelter Promise-Versprechen im WebView.
Was tun
Asynchrone Fehler mit JS- und native Fehlerberichts-Installation erfassen.
webview_resource_error
Abschnitt mit dem Titel “webview_resource_error”Was bedeutet das
Ein WebView-Ressource konnte nicht geladen werden.
Was tun
Verwenden Sie die URL und die Statusdetails der Metadaten, um beschädigte Assets oder Netzwerkregeln zu beheben.
webview_security_policy_violation
Abschnitt mit dem Titel “webview_security_policy_violation”Was bedeutet das
Der Inhaltssicherheitspolicy blockierte eine Ressource.
Was tun
Passen Sie den CSP mit der Metadaten-Direktive und den Details der blockierten URI an.
webview_unclean_restart
Abschnitt mit dem Titel “webview_unclean_restart”Was bedeutet das
Der 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 das
Android WebView-Renderer-Prozess beendet.
Was tun
Überprüfen Sie die Renderer-Crash-Signale in den Metadaten und den native Logs.
webview_content_process_terminated
Abschnitt mit dem Titel “webview_content_process_terminated”Was bedeutet das
iOS WebView-Inhaltprozess wurde beendet.
Was tun
Aktive Bundle und Seite URL aus Metadaten überprüfen.
Umgebung und Kanalkontext
Abschnitt: Umgebung und KanalkontextGeräteseitige Kontextereignisse, die helfen, Aktualisierungsverhalten mit Betriebssystem, nativer Version oder Kanaländerungen zu korrelieren.
os_version_changed
Abschnitt: os_version_changedWas bedeutet das?
Das Geräte-Betriebssystemversion wurde zwischen den Überprüfungen geändert.
native_app_version_changed
Abschnitt: native_app_version_changedWas bedeutet das?
Die native App-Store-Version wurde geändert, wodurch native vs Web-Bundle-Änderungen getrennt werden können.
getChannel
Abschnitt: getChannelWas bedeutet das?
The device queried its current channel.
setChannel
Sektion: "setChannel"Was bedeutet das
Eine Kanal-Einstellung wurde erfolgreich für das Gerät durchgeführt.
uninstall
Sektion: "uninstall"Was bedeutet das
Die App wurde uninstalliert oder Capgo Daten wurden gelöscht.
Bundle-Status
Sektion: "Bundle status"SUCCESS: Bundle installiertERROR: Installieren oder herunterladen fehlgeschlagenPENDING: Herunterladen abgeschlossen, Freigabe wartetDELETED: Paket wurde gelöscht, aber noch für Statistiken angezeigtDOWNLOADING: Ein Bundle wird derzeit heruntergeladen
Geräteprotokolle verstehen
Sektion mit dem Titel “Geräteprotokolle verstehen”Debug-Befehl
Sektion mit dem Titel “Debug-Befehl”Für Capgo Cloud-Nutzer gibt es einen Debug-Befehl.
npx @capgo/cli@latest app debugMit diesem können Sie alle Ereignisse im App abrufen und eine Lösung finden, wenn Updates nicht erfolgen.
iOS-native Protokolle
Sektion mit dem Titel “iOS-native Protokolle”um Ihre Protokolle in Xcode zu finden
Android-native-Protokolle
Abschnitt „Android-native-Protokolle“um Ihre Protokolle in Android Studio zu finden
Abbildung von Native-Logausdrücken
Abschnitt „Abbildung von Native-Logausdrücken“Failed to download frommappen zudownload_failnotifyAppReady was not called, roll back current bundlemappen zuupdate_fail
Das heruntergeladene Bundle auf einem Gerät finden
Abschnitt „Das heruntergeladene Bundle auf einem Gerät finden“Um auf iOS zu debuggen, müssen Sie die App auf Ihrem Computer auslagern, Sie können es wie folgt tun:
Xcode verfügt über eine eingebaute 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 im Xcode-Menüband "Window > Geräte".
- 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 linken Ecke der Anzeige aus.
- Hier können Sie das aktuelle Dateisystem anzeigen, indem Sie "Ein Snapshot herunterladen" auswählen.

Wird das Download-Container… herunterladen und eine Snapshot des Dateisystems als .xcappdata-Datei exportieren, die Sie durchsuchen können.

Klicken Sie mit der rechten Maustaste auf diese Datei und wählen Sie "Show Package Contents" aus, um das Verzeichnis zu öffnen.
Öffnen Sie das App-Daten-Verzeichnis und Sie sollten jetzt einige Verzeichnisse wie Dokumente, Bibliothek, tmp usw. sehen.

Dann finden Sie eine Version in 2 Verzeichnissen:
library/NoCloud/ionic_built_snapshots erforderlich nach dem App-Neustart
und documents/versions für Hot-Reload
Zum Debuggen auf Android müssen Sie den Zugriff auf das Gerät über Android Studio erhalten:
- 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/__CAPGO_KEEP_0__/ wo __CAPGO_KEEP_0__ ist Ihre App-ID.

Dann finden Sie das versions Verzeichnis, um alle Versionen zu sehen
iOS-Produktionscrash-Logs verstehen
Verstehen Sie iOS-Produktionscrash-LogsWeiter von Debugging
Verstehen Sie "Weiter von Debugging"Wenn Sie " Debugging für die Planung von native Plug-in-Arbeiten verwenden, verbinden Sie es mit Mit @capgo/capacitor-Updater für die native Fähigkeit in Mit @capgo/capacitor-Updater, Capgo-Plugin-Verzeichnis für den Produktworkflow in Capgo-Plugin-Verzeichnis, Capacitor Plugins by Capgo for the implementation detail in Capacitor Plugins by Capgo, Plugins hinzufügen oder aktualisieren für die Implementierungsdetails in Plugins hinzufügen oder aktualisieren, und Alternativen zu Ionic Enterprise Plugins für den Produktworkflow in Alternativen zu Ionic Enterprise Plugins.