Debugging
Ein Setup-Prompt mit den Installationsanweisungen und der vollständigen Markdown-Dokumentation für diesen Plugin kopieren.
Verstehen Sie Cloud-Protokolle
Abschnitt mit dem Titel „Verstehen Sie Cloud-Protokolle“Wenn Sie ein Cloud-Absagen erhalten code und tiefergehende Remediation-Anleitungen benötigen, sehen Sie Häufige Update-Probleme.
Capgo-Protokolle können Metadaten für das Ereignis enthalten. Im Dashboard filtern Sie nach dem snake_case-Aktionstitel 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 Prozesszustand, den Speicherdruck oder die plattformabhängige Ursache enthalten können. Ältere Protokolle können noch Legacy-CamelCase-Aliase in Klammern aufweisen.
Jeder Abschnittstitel entspricht der Aktion code im Konsole-Protokoll-Tabelle, sodass Sie direkt darauf verweisen können.
Planbegrenzungen und normale Antworten
Abschnitt „Planbegrenzungen und normale Antworten“Hintergrundverweigerungen im Zusammenhang mit Rechnungsstellung, Drosselung oder Nicht-Fehlerzuständen.
InvalidIp
Abschnitt „InvalidIp“Was bedeutet das?
Capgo wurde Traffic erkannt, der wie von Google oder Cloud-Infrastruktur stammen könnte. Aktualisierungen unter vier Stunden alt werden ignoriert, damit Bot-Traffic nicht als abrechnungsfähige 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.
needPlanUpgrade
Abschnitt „needPlanUpgrade“Was bedeutet das?
Ihre Organisation hat die Plangrenze oder die Gerätegrenze erreicht. Das Gerät erhält keine Updates, bis Sie eine Upgrade durchführen 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
Der Gerät hat bereits die neueste Bundle verfügbar für seinen Kanal. Dies ist ein normaler Zustand, kein Fehler.
rateLimited
Abschnitt mit dem Titel “rateLimited”Was bedeutet das
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. Rufen Sie sie setChannel / getChannel nur von Benutzeraktionen aus an und setzen Sie defaultChannel in capacitor.config.
Version-Format
Abschnitt mit dem Titel „Version format“Hintergrundabnahmen 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 Build-Zielsetzung
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 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 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 an anderer Stelle.
disableProdBuild
Abschnitt mit dem Titel „disableProdBuild“Was bedeutet es
Ein Produktionsbuild wurde aufgerufen /updatesaber Produktionsupdates werden für diesen Kanal blockiert.
Was tun
Produktionsupdates in diesem Kanal zulassen, wenn dies versehentlich geschah, oder Produktionsbuilds auf den richtigen Kanal umleiten.
disableDevice
Abschnitt mit dem Titel “disableDevice”Was bedeutet
Ein echter Smartphone oder Tablet wurde blockiert, weil dieser Kanal echte Geräte blockiert.
Was tun
Echtzeit-Geräte-Updates zulassen, wenn dies versehentlich geschah, oder die Einschränkung beibehalten und echte Geräte auf einen anderen Kanal umleiten.
disableEmulator
Abschnitt mit dem Titel “disableEmulator”Was bedeutet
Das Gerät ist ein Emulator, aber Emulator-Updates sind für diesen Kanal deaktiviert.
Was tun
Aktiviere Emulatoren-Updates in einem Testkanal oder halte diesen Kanal für Emulatoren blockiert und verwende einen anderen Kanal für die Emulatorevaluation.
Automatische Aktualisierungen von Kompatibilitätsregeln
Abschnitt mit dem Titel „Automatische Aktualisierungen von Kompatibilitätsregeln“Hintergrundablehnungen, wenn semver- oder Metadateregeln das 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 Kanalkompatibilitätsrichtlinie für automatische Aktualisierungen, um deine geplante Rollout-Strategie 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 nativ Version ist unter diesem Schwellenwert.
Was tun
Setzen Sie min_update_version auf dem Ziel-Bundle oder Release von einem neueren nativen Version.
disableAutoUpdateToMajor
Abschnitt mit dem Titel „disableAutoUpdateToMajor“Was bedeutet es
Der Kanal blockiert große Versionshops, zum Beispiel 1.x.x zu 2.x.x.
Was tun
Passen Sie die Kanalstrategie mit Ihrem großen Rollout-Plan an oder lassen Sie große Sprünge für diesen Track zu. Siehe Häufige Update-Probleme.
disableAutoUpdateToMinor
Abschnitt mit dem Titel “disableAutoUpdateToMinor”Was bedeutet es
Der Kanal blockiert Versionshops in der Mino-Version relativ zur Geräte-Standard-Basis (version_buildzu 1.2.3 Was tun 1.3.0.
See also
Synchronisieren Sie die Kanalstrategie mit Ihrem Rollout-Plan der Minderjährigen oder lassen Sie für diesen Track Minderjährige Sprünge zu.
disableAutoUpdateToPatch
Abschnitt mit dem Titel “disableAutoUpdateToPatch”Was bedeutet das
Die Kanäle blockieren Änderungen auf Patch-Ebene, während die gleiche Präfix-Änderung zulässig ist. MAJOR.MINOR.PATCH Was tun
Synchronisieren Sie die Veröffentlichungsrate mit der Kanalpolitik oder lassen Sie für diesen Track Patch-Sprünge zu.
Kanalsetup
Abschnitt mit dem Titel “Channel setup”
Hintergrundablehnungen aufgrund fehlender oder inkompatibler Kanalkonfiguration.Abschnitt mit dem Titel “cannotUpdateViaPrivateChannel”
cannotUpdateViaPrivateChannel
Was bedeutet dasAbschnitt mit dem Titel “Channel setup”
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 der Bundle disable_auto_update: "version_number" ist null, so __CAPGO_KEEP_0__ kann nicht entscheiden, welche Geräte aktualisiert werden sollten. 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 es
Keine Standardkanal ist konfiguriert und das Gerät hat keine Kanal-Überschreibung.
Was tun
Setzen Sie einen Standardkanal im Dashboard oder konfigurieren Sie defaultChannel im Build.
Bündel liefern und verschlüsseln
Abschnitt mit dem Titel “Bündel liefern und verschlüsseln”Hintergrundablehnungen, wenn Capgo nicht liefern oder entschlüsseln kann.
cannotGetBundle
Abschnitt mit dem Titel “Bündel nicht erhalten”Was bedeutet es
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: kein external_url, kein r2_path, keine integrierte Version und keine Einträge im Manifest.
Was tun
Rebuild und laden Sie die Version neu hoch, 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_id, und version.
Was tun
Vergleichen Sie die Geräte- und Bundle-Schlüssel-IDs im Konsole. Veröffentlichen Sie mit demselben Schlüssel und den übereinstimmenden CLI/Plugin-Versionen.
Anwendungskonfiguration und Legacy-Kunden
Abschnitt mit dem Titel “Anwendungskonfiguration und Legacy-Kunden”Hintergrundablehnungen aufgrund von Anwendungskonfiguration oder nicht unterstützten Updater-Versionen.
customIdBlocked
Abschnitt mit dem Titel “customIdBlocked”Was bedeutet das
Die Anwendung hat ein benutzerdefiniertes Geräte-ID gesendet, aber diese Anwendung 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.
blocked_by_server_url
Abschnitt mit dem Titel “blocked_by_server_url”Was bedeutet es
server.url wird in der Capacitor Konfiguration festgelegt, so dass 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
Internes Testereignis zur Verifizierung des Stats-Pipelines
Was bedeutet das
Capgo hat dem Gerät Informationen über eine neue Version zum Herunterladen gesendet.
Was bedeutet das
Ein Bundle wurde auf dem Gerät aktiviert.
Was bedeutet es
Ein Bundle konnte sich auf dem Gerät nicht aktivieren.
Was tun
Überprüfe die native Logs mit npx @capgo/cli@latest app debug und überprüfe die Bundle-Integrität, Pfade und notifyAppReady den Datenfluss.
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 InstallationsfehlerGeräte-seitige Ereignisse für das Herunterladen des Fortschritts, der Archiv-Validierung und der Installationsfehler.
download_0
Abschnitt: download_0Was bedeutet es
Die Herunterladesequenz begann bei 0% Fortschritt.
download_10
Abschnitt: download_10Was bedeutet es
Ein neuer Bundle wurde heruntergeladen — Fortschritt angezeigt bei 10%.
download_20
Abschnitt: download_20Was bedeutet es
Ein neuer Bundle wurde heruntergeladen — Fortschritt angezeigt bei 20%.
download_30
Sektion mit dem Titel „herunterladen_30“Was bedeutet es
Ein neuer Bundle wurde heruntergeladen — Fortschritt angezeigt bei 30%.
download_40
Sektion mit dem Titel „herunterladen_40“Was bedeutet es
Ein neuer Bundle wurde heruntergeladen — Fortschritt angezeigt bei 40%.
download_50
Sektion mit dem Titel „herunterladen_50“Was bedeutet es
Ein neuer Bundle wurde heruntergeladen — Fortschritt angezeigt bei 50%.
download_60
Sektion mit dem Titel „herunterladen_60“Was bedeutet es
Ein neuer Bundle wurde heruntergeladen — Fortschritt angezeigt bei 60%.
download_70
Abschnitt mit dem Titel “herunterladen_70”Was bedeutet es
Ein neuer Bundle wurde heruntergeladen – Fortschritt angezeigt bei 70%.
download_80
Abschnitt mit dem Titel “herunterladen_80”Was bedeutet es
Ein neuer Bundle wurde heruntergeladen – Fortschritt angezeigt bei 80%.
download_90
Abschnitt mit dem Titel “herunterladen_90”Was bedeutet es
Ein neuer Bundle wurde heruntergeladen – Fortschritt angezeigt bei 90%.
download_complete
Abschnitt mit dem Titel “herunterladen_abgeschlossen”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 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 dem Titel „download_zip_start“Was bedeutet das
Das Gerät begann mit dem Herunterladen des Archivs.
download_zip_complete
Abschnitt mit dem Titel „download_zip_complete“Was bedeutet das
Das Gerät hat das Archiv heruntergeladen.
download_manifest_file_fail
Abschnitt mit dem Titel „download_manifest_file_fail“Was bedeutet es
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
Abschnitt mit dem Titel „download_manifest_checksum_fail“Was bedeutet es
Ein Manifest-Datei-Prüfsummenprüfung fehlgeschlagen.
Was tun
Laden Sie das Bundle mit der aktuellen CLI-Version hoch und überprüfen Sie die Manifest-Prü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, also Capgo wurde zurückgerollt.
Was tun
Call notifyAppReady() nachdem Ihre App sich gebootet hat. Native Log Text notifyAppReady was not called, roll back current bundle wird auf diesen code abgebildet.
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 darstellen.
Was tun
Wiederherstellen 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üsselungs-Schlü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-Style-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 das
Die 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 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
Abschnitt mit dem Titel “low_mem_fail”Was bedeutet das
Der Download fehlgeschlagen, weil das Gerät an Energie ging.
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
Abschnitt mit dem Titel “Anwendungszustand und WebView-Ereignisse”Geräteseitige Fehler, Speicher- und WebView-Diagnose. Inspektion der Metadaten-JSON im Dashboard immer anwenden.
app_moved_to_background
Abschnitt mit dem Titel “app_moved_to_background”Was bedeutet das
Die Anwendung wurde in den Hintergrund geschoben.
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-Crash. 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. 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-Crash. Die Metadaten können eine Plattform, einen Grund, einen Stapel und Details zum Prozess enthalten.
Was tun
Verwenden Sie Xcode oder Logcat-Crash-Protokolle und korrelieren Sie sie mit dem aktiven Bundle aus den Metadaten.
Was bedeutet es
Android-Application-Not-Responding-Ereignis
Was tun
Überprüfen Sie die ANR-Tracks in Logcat und reduzieren Sie nach Aktualisierungen die Blockierung der Haupt-Thread-Arbeit.
app_killed_low_memory
Abschnitt mit dem Titel “app_killed_low_memory”Was bedeutet es
Das Betriebssystem hat die App nach Druck auf die Speicherfläche getötet.
Was tun
Reduzieren Sie den Speicherbedarf nach Aktivierung der Aktualisierung 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
Der 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 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 es
iOS-Memory-Warnung.
Was tun
Überprüfen Sie den Speicherzustand im 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 Nachricht, eine Quell-URL, eine Zeile, eine Spalte und einen Stapel enthalten.
Was tun
Installieren Sie eine Fehlerberichterstattung 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 das
Unbehandelter Versprechenabbruch im WebView.
Was tun
Fangen Sie Asynchronfehler mit JS und native Fehlerberichterstattung auf.
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 Metadaten-URL und die Statusdetails, um beschädigte Assets oder Netzwerkregeln zu beheben.
webview_security_policy_violation
Abschnitt mit dem Titel “webview_security_policy_violation”Was bedeutet das
Der Inhalts-Sicherheits-Policy blockierte eine Ressource.
Was tun
Passen Sie den CSP mithilfe der Metadaten-Direktive und der URI-Details 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 einer Aktualisierung 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 Crash-Signale 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
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?
Geräte-Betriebssystemversion wurde zwischen den Überprüfungen geändert.
native_app_version_changed
Abschnitt: native_app_version_changedWas bedeutet das?
Nativ-App-Store-Version geändert, hilft dabei, native vs Web-Bundle-Änderungen zu trennen.
getChannel
Abschnitt: getChannelWas bedeutet das?
Das Gerät hat seinen aktuellen Kanal abgefragt.
setChannel
Abschnitt mit dem Titel „setChannel”Was es bedeutet
Ein Kanal wurde erfolgreich für das Gerät gesetzt.
uninstall
Abschnitt mit dem Titel „uninstall”Was es bedeutet
Die App wurde uninstalliert oder Capgo Daten wurden gelöscht.
Bundle-Status
Abschnitt mit dem Titel „Bundle status”SUCCESS: Bundle installiert, fertigERROR: 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 Befehl können Sie alle Ereignisse im App überprüfen und eine Lösung finden, wenn Updates nicht erfolgen.
iOS-native Protokolle
Sektion mit dem Titel “iOS-native Protokolle”um Ihre Protokolle auf Xcode zu finden
Android-native-Protokolle
Abschnitt „Android-native-Protokolle“um Ihre Protokolle auf Android Studio zu finden
Abbildung von Native-Log-Phrasen
Abschnitt „Abbildung von Native-Log-Phrasen“Failed to download fromentsprichtdownload_failnotifyAppReady was not called, roll back current bundleentsprichtupdate_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 das App-Programm auf Ihrem Computer auslagern, Sie können es wie folgt tun:
Xcode verfügt über eine eingebaute Funktion zum 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 "Geräte" aus.
- 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 "Download einer Snapshot" auswählen.
Wird Download-Container… herunterladen und exportieren Sie einen Snapshot des Dateisystems als .xcappdata-Datei, 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-Datenvorrat und Sie sollten jetzt einige Verzeichnisse wie Dokumente, Bibliothek, tmp usw. sehen.
Sie finden dann eine Version in 2 Ordner:
library/NoCloud/ionic_built_snapshots erforderlich nach dem App-Neustart
und documents/versions für Hot-Reload
Um auf Android zu debuggen, müssen Sie den Gerätezugriff von Android Studio aus nutzen:
- Klicken Sie auf Ansicht > Werkzeugfenster > Geräte-Datei-Explorer oder klicken Sie auf den Geräte-Datei-Explorer-Button in der Werkzeugfensterleiste, 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/ wobei APP_NAME ist Ihre App-ID.
Finden Sie dann das versions Fachordner, um alle Versionen zu sehen
iOS-Produktionscrash-Logs verstehen
Verstehen Sie iOS-Produktionscrash-LogsWeiter von Debugging
Verstehen Sie "Weiter von Debugging"Wenn Sie " Debugging um native Plugin-Arbeit zu planen, 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.