Fehlersuche
Kopieren Sie einen Einstellungsprompt 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 Ermittlung durchgehen möchten, 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-Protokollen-Table, sodass Sie direkt darauf verweisen können.
Planbegrenzungen und normale Antworten
Abschnitt mit dem Titel “Planbegrenzungen und normale Antworten”Hinweise auf der Backend-Seite zu Rechnungsfragen, Einschränkungen oder nicht fehlerhaften Zuständen.
InvalidIp
Abschnitt mit dem Titel „InvalidIp“Was bedeutet das?
Capgo hat Traffic erkannt, der wie von Google oder Cloud-Infrastruktur stammen könnte. Updates, die weniger als vier Stunden alt sind, 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.
provider_infrastructure_request_blocked
Abschnitt mit dem Titel „provider_infrastructure_request_blocked“Was bedeutet das?
Ihre App ist so konfiguriert, dass sie Anfragen von bekannten Google- und Apple-Datacenter-IP-Adressen blockiert. Die Schutzfunktion gilt für Update-Überprüfungen, Statistiken und Anfragen an den Kanal selbst, sodass Cloud-hostete 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 Traffic absichtlich ist, deaktivieren Sie temporär Provider-Infrastruktur-Anfragen blockieren In der App unter "Informationen", aktivieren Sie es dann 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?
Stellen Sie Ihr Abonnement im Dashboard auf oder warten Sie auf den nächsten Abrechnungszyklus.
Abschnitt mit dem Titel "noNew"
Was bedeutet es?
Abschnitt mit dem Titel "rateLimited"
In der App unter "Informationen", aktivieren Sie es dann erneut nach dem Test. Neue Apps aktivieren diese Einstellung standardmäßig; bestehende Apps behalten ihre vorherige deaktivierte Einstellung, bis sie geändert werden.
rateLimited
Abschnitt mit dem Titel "needPlanUpgrade"Was bedeutet es
Der Geräteversand 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 nur von Benutzeraktionen aus an und setzen Sie sie setChannel / getChannel nur von Benutzeraktionen aus und setzen Sie sie defaultChannel in capacitor.config.
Version-Format
Abschnitt mit dem Titel “Version-Format”Hintergrundabnahmen aufgrund von ungültigen native 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 Zielplattformen
Abschnitt mit dem Titel “Plattform und Zielplattformen”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
iOS in der Kanal aktivieren, wenn dies versehentlich war, oder iOS-Builds auf einen dedizierten Kanal routen, wenn das Blockieren absichtlich ist.
disablePlatformAndroid
Abschnitt mit dem Titel “disablePlatformAndroid”Was bedeutet es
Das Gerät läuft unter Android, aber Android-Updates sind für diesen Kanal deaktiviert.
Was tun Sie
iOS in der Kanal aktivieren, wenn dies versehentlich war, oder iOS-Builds auf einen dedizierten Kanal routen, 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 Sie
Electron in der Kanal aktivieren, wenn dies versehentlich war, oder Electron-Builds auf einen dedizierten Kanal routen, wenn das Blockieren absichtlich 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 echtes 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.
Auto-Update-Kompatibilitätsregeln
Abschnitt mit dem Titel “Auto-update compatibility rules”Hintergrundablehnungen, wenn semver- oder Metadatenregeln das Zielbundle 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 Grundlage, 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 zu 2.x.x.
Was tun
Passen Sie die Kanalstrategie mit Ihrem Hauptrollout-Plan an oder lassen Sie Sprünge in der Hauptversion für diesen Track zu. Siehe Gemeinsame Updateprobleme.
disableAutoUpdateToMinor
Abschnitt mit dem Titel “disableAutoUpdateToMinor”Was bedeutet das
Der Kanal blockiert Sprünge auf Minor-Versionen im Vergleich zum Geräte-Standard (version_buildzum 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
Abschnitt mit dem Titel “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 Was bedeutet das
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 false) und der Kanal ist nicht öffentlich.allow_device_self_set Was tun
Aktivieren
auf dem Kanal oder den Gerät auf einen öffentlichen oder zulässigen Kanal umschalten. allow_device_self_set Was tun
channelMisconfigured
Abschnitt mit dem Titel “Kanalfehler”Was bedeutet das
Der Kanal verwendet disable_auto_update: "version_number" aber das Bundle min_update_version ist null, daher 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
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
Setzen Sie einen Standardkanal im Dashboard oder konfigurieren Sie 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: "cannotGetBundle"Was bedeutet das?
Capgo konnte keine gültige signierte Download-URL generieren und es war kein Manifest-Fallback verfügbar.
Was tun?
Das Bundle erneut hochladen, Manifeste neu generieren und die Einstellungen für R2 oder das öffentliche Bundle überprüfen.
missingBundle
Abschnitt: "missingBundle"Was bedeutet das?
Das zum Kanal zugewiesene Bundle enthält keine herunterladbaren Inhalte: keine external_url, nein r2_path, keine integrierte Version und keine Manifest-Einträge.
Was tun
Rebuild und die Version erneut hochladen, dann bestätigen Sie, dass das Bundle echte Dateien enthält.
keyMismatch
Abschnitt mit dem Titel “keyMismatch”Was bedeutet es
Die öffentliche Verschlüsselungsschlüssel des Geräts entspricht nicht dem Schlüssel, der zum Verschlüsseln des Bundles verwendet wurde. Das Metadaten kann einschließen device_key_id, bundle_key_id, und version.
Was tun
Gleichen 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 “App configuration and legacy clients”Hinweise des Backends, die durch die Anwendungs-Konfiguration oder nicht unterstützte Updater-Versionen verursacht werden.
customIdBlocked
Sektion mit dem Titel „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 Ihr Workflow sie erfordert.
blocked_by_server_url
Sektion mit dem Titel „blocked_by_server_url“Was bedeutet es
server.url ist in der Capacitor-Konfiguration festgelegt, daher lädt die WebView eine remote URL anstatt 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 zur Produktionsauslieferung und zum lokalen Speichern von Update-Payloads. 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 der Backend nicht mehr akzeptiert.
Was tun
Das Plugin und CLI auf v5+ (vorzugsweise v8) aktualisieren, mit Capacitor v5+ neu erstellen und das Bundle-Metadaten neu veröffentlichen.
Update-Lebenszyklus
Abschnitt mit dem Titel “Update lifecycle”Geräteseitenevents für den normalen Update-Flow, die Aktivierung und den Rollback.
Was bedeutet es
Interne Testaktion zur Überprüfung des Statistikpipeline.
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 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 Fluss.
Was bedeutet das
Das Gerät wurde auf die integrierte Bundle zurückgesetzt.
Was bedeutet das
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 das
Die Herunterladesequenz begann bei 0% Fortschritt.
download_10
Abschnitt mit dem Titel „Herunterladen_10“Was bedeutet das
Ein neuer Bundle wurde heruntergeladen — Fortschritt angezeigt bei 10%.
download_20
Abschnitt mit dem Titel „Herunterladen_20“Was bedeutet das
Ein neuer Bundle wurde heruntergeladen — Fortschritt angezeigt bei 20%.
download_30
Abschnitt mit dem Titel „Herunterladen_30“Was bedeutet das
Ein neuer Bundle wurde heruntergeladen — Fortschritt angezeigt bei 30%.
download_40
Abschnitt mit dem Titel „Herunterladen_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
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 hat das Bundle-Archiv heruntergeladen.
download_zip_complete
Abschnitt mit dem Titel „download_zip_complete“Was bedeutet das?
Das Gerät hat das Bundle-Archiv heruntergeladen.
download_manifest_file_fail
Abschnitt mit dem Titel „download_manifest_file_fail“Was bedeutet das?
Eines der Manifest-Einträge konnte nicht heruntergeladen werden. version_name wird verwendet version:fileName um den Asset zu identifizieren.
Was tun
Der fehlende oder blockierte Asset korrigieren, das Manifest neu generieren und das Bundle erneut hochladen.
download_manifest_checksum_fail
Abschnitt mit dem Titel „download_manifest_checksum_fail“Was bedeutet es
Ein Manifest-Datei fehlgeschlagen die Prüfung der Prüfsumme.
Was tun
Das Bundle mit einer aktuellen CLI Version erneut hochladen und die Manifest-Prüfsummen überprüfen.
download_manifest_brotli_fail
Abschnitt mit dem Titel „download_manifest_brotli_fail“Was bedeutet es
Ein Manifest-Datei fehlgeschlagen die Brotli-Entschlüsselung.
Was tun
Die Komprimierungseinstellungen überprüfen und die betroffenen 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 Ablaufbarkeit von signierten URLs, die Erreichbarkeit von CDN und die Speicherung auf dem Gerät
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 Abschalten Ihres Apps nach dem Bootstrapping auf notifyAppReady() Natives Logtext 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üssel-Mismatch bei älteren Plugins, die Verschlüsselungsfehler als Prüfsummenfehler ausgeben.
Was tun
Neu hochladen mit einem aktuellen CLI/Plugin (SHA256). Wenn Verschlüsselung verwendet wird, überprüfen Sie, ob die App-Publiksschlüssel mit dem Uploadschlü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 neu.
Abschnitt mit dem Titel ‘Fehlschlag der Entschlüsselung’
windows_path_fail
Abschnitt mit dem Titel “windows_path_fail”Was bedeutet es
Die 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 es
Die Dateipfade innerhalb der Zip sind nicht kanonisch.
Was tun
Beheben Sie die Pfadgenerierung des Archivs vor dem Hochladen.
directory_path_fail
Abschnitt mit dem Titel “directory_path_fail”Was bedeutet es
Die Zip enthält ungültige Verzeichnispfade.
Was tun?
Stellen Sie die Archivstruktur vor dem Upload sicher.
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 der Überschrift “low_mem_fail”Der Download ist fehlgeschlagen, weil das Gerät keinen Speicherplatz mehr hatte.
Was tun?
Abschnitt mit der Überschrift “low_mem_fail”
Reduzieren Sie die Größe des Pakets 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 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 es?
Die Anwendung ist in den Hintergrund gerückt.
app_moved_to_foreground
Abschnitt mit dem Titel „app_moved_to_foreground“Was bedeutet es?
Die Anwendung ist in den Vordergrund gerückt.
app_crash
Abschnitt mit dem Titel „app_crash“Was bedeutet es?
JavaScript oder Capacitor Layer abstürzen. Die Metadaten können eine Nachricht, einen Stapel, eine Quelle und den aktiven Bundle-Kontext enthalten.
Was tun
Metadaten und native Protokolle untersuchen. JS- und native Fehlerberichterstellung (z. B. Sentry) verwenden, um den fehlerhaften code Pfad zu lokalisieren.
app_crash_native
Abschnitt mit dem Titel ‘app_crash_native’Was bedeutet es
Native Plattform abstürzen. Die Metadaten können eine Plattform, einen Grund, einen Stapel und Prozessdetails enthalten.
Was tun
Xcode- oder Logcat-Crash-Protokolle verwenden und mit dem aktiven Bundle aus den Metadaten korrelieren.
Was bedeutet es
Android-Anwendungs-Blockierungereignis.
Was tun
Überprüfen Sie die ANR-Tracks 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 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
Abschnitt mit dem Titel “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
Abschnitt mit dem Titel “webview_javascript_error”Was bedeutet es
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 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
Fehler bei asynchronen Vorgängen mit JS- und native Fehlerberichterstellung erfassen.
webview_resource_error
Abschnitt mit dem Titel “webview_resource_error”Was bedeutet es
Ein WebView-Ressourcen-Loadvorgang ist fehlgeschlagen.
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 es
Der Inhalts-Sicherheits-Plan hat eine Ressource blockiert.
Was tun
Anpassen Sie die 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 einer Aktualisierung hinweisen 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 Kanal-Kontext
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 es
Das 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 es
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 es
Das Gerät hat seine aktuelle Kanalabfrage durchgeführt.
setChannel
Abschnitt mit dem Titel “setChannel”Was bedeutet es
Ein Kanal wurde erfolgreich für das Gerät gesetzt.
uninstall
Abschnitt mit dem Titel “uninstall”Was bedeutet das
Die App wurde deinstalliert oder Capgo Daten wurden gelöscht.
Bundle-Status
Abschnitt mit dem Titel „Bundle-Status“SUCCESS: Bundle installiert, fertigERROR: Installieren oder herunterladen fehlgeschlagenPENDING: Herunterladen abgeschlossen, Release noch nicht veröffentlichtDELETED: 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
Protokolle 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 auswerfen, Sie können es so machen:
Xcode hat eine eingebaute Funktion zum Inspektorieren des Dateisystems von Entwickler-eingebauten 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".
- Wählen Sie Ihr Gerät in der linken Spalte unter der "Geräte"-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 "Ein Snapshot herunterladen" wählen.

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

Klicken Sie mit der rechten Maustaste auf diese Datei und wählen Sie "Verzeichnis anzeigen" aus, um das Verzeichnis zu öffnen.
Öffnen Sie das App-Daten-Verzeichnis, und Sie sollten nun einige Ordner wie Dokumente, Bibliothek, 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
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 wobei APP_NAME der Name Ihres Apps ist. APP_NAME ist Ihre App-ID.

Dann finden Sie das versions Ordner, um alle Versionen zu sehen
IOS-Produktionscrash-Protokolle verstehen
Abschnitt mit dem Titel „IOS-Produktionscrash-Protokolle verstehen“Weitergehen Sie von Debugging
Abschnitt mit dem Titel „Weitergehen Sie von Debugging“If Sie native Plugins verwenden Debugging um native Plugin-Arbeit zu planen, verbinden Sie es mit Verwenden Sie @capgo/capacitor-Updater zum native Fähigkeitsmerkmal in Verwenden Sie @capgo/capacitor-Updater Capgo Plugin-Verzeichnis zum Produktworkflow in Capgo Plugin-Verzeichnis Capacitor Plugins von Capgo zum Implementierungsdetail in Capacitor Plugins von Capgo Hinzufügen oder Aktualisieren von Plugins zum Implementierungsdetail in Hinzufügen oder Aktualisieren von Plugins, und Ionische Enterprise-Plugin-Alternativen für das Produktworkflow in Ionic Enterprise Plugin Alternativen.