Debugging
Eine Einrichtungsanweisung mit den Installationsanweisungen und der vollständigen Markdown-Dokumentation für diesen Plugin kopieren.
Verständnis von Cloud-Protokollen
Abschnitt mit dem Titel „Verständnis von Cloud-Protokollen“Wenn Sie ein Cloud-Absagen erhalten code und tiefergehende Remediation-Anleitungen benötigen, sehen Sie sich Gemeinsame Update-Probleme.
Capgo Protokolle können Metadaten für das Ereignis enthalten. In der Dashboard filtern Sie nach dem snake_case-Aktion code, und klicken Sie auf die Metadaten-Zelle, um den vollständigen 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 Prozesszustand, den Speicherdruck oder die plattform-spezifische Ursache enthalten können. Ältere Protokolle können noch immer Legacy-CamelCase-Aliase in Klammern auflisten.
Jeder Abschnittstitel entspricht der Aktion code im Konsole-Protokollen-Table, sodass Sie direkt darauf verweisen können.
Plan-Grenzen und normale Antworten
Abschnitt mit dem Titel „Plan-Grenzen und normale Antworten“Hintergrund-Absagen im Zusammenhang mit Abrechnung, Drosselung oder Nicht-Fehlerzuständen.
InvalidIp
Abschnitt mit dem Titel „InvalidIp“Was es bedeutet
Capgo wurde Traffic erkannt, das wie von Google oder Cloud-Infrastruktur aussieht. Aktualisierungen, 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 wieder.
provider_infrastructure_request_blocked
Abschnitt mit dem Titel „provider_infrastructure_request_blocked“Was bedeutet es
Ihre App ist so konfiguriert, dass Anfragen von bekannten Google- und Apple-Datacenter-IP-Adressen blockiert werden. Die Schutzeinrichtung gilt für Aktualisierungsprüfungen, Statistiken und channel-self-Anfragen, sodass Cloud-gesteuerte 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 Blockieren Sie provider-Infrastruktur-Anfragen in der App’s Information Registerkarte, dann aktivieren Sie sie wieder nach dem Test. Neue Apps aktivieren diese Einstellung standardmäßig; bestehende Apps behalten ihre vorherige deaktivierte Einstellung, bis sie geändert wird.
needPlanUpgrade
Abschnitt mit dem Titel “needPlanUpgrade”Was bedeutet das
Ihre Organisation hat das Plan- oder Gerätelimit erreicht. Das Gerät erhält keine Updates, bis Sie das Abonnement aufstocken oder der nächste Abrechnungszyklus die Verwendung zurücksetzt.
Was tun
Stellen Sie Ihr Abonnement im Dashboard auf oder warten Sie auf den nächsten Abrechnungszyklus.
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
Das Gerät hat zu viele Update- oder Kanal-Anfragen in kurzer Zeit gesendet.
Was tun
Stop Aufrufe von Update-APIs innerhalb von Render-Schleifen. Rufe setChannel / getChannel nur von Benutzeraktionen aus und setze defaultChannel in capacitor.config.
Format der Version
Abschnitt mit dem Titel “Format der Version”Hintergrundverweigerungen aufgrund von ungültigen nativen Versionsmetadaten.
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
Setze plugins.CapacitorUpdater.version zu gültigem semver, überprüfe es in der SemVer-Tester, dann rebuild und die native App neu installieren.
Plattform und Zielgerät
Abschnitt mit dem Titel „Plattform und Zielgerät“Hintergrundabnahmen, wenn die Kanalrichtlinie eine Plattform, einen Buildtyp oder eine Gerätekategorie blockiert.
disablePlatformIos
Abschnitt mit dem Titel „disablePlatformIos“Was bedeutet es
Das Gerät läuft unter iOS, aber iOS-Updates sind für diesen Kanal deaktiviert.
Was tun?
iOS in dem Kanal aktivieren, wenn dies versehentlich war, oder iOS-Builds in einen dedizierten Kanal routen, wenn das Blockieren absichtlich ist.
disablePlatformAndroid
Abschnitt mit dem Titel „disablePlatformAndroid“Was bedeutet es
Die Geräte laufen 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
Die Geräte laufen 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 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 auf Release-only und bewegen Sie Entwickelgeräte an anderer Stelle.
disableProdBuild
Abschnitt mit dem Titel “disableProdBuild”Was bedeutet das
Ein Produktionsbuild heißt /updates, aber Produktionsupdates werden für diesen Kanal blockiert.
Was tun
Lassen Sie Produktionsupdates im Kanal zu, wenn dies versehentlich geschah, oder leiten Sie Produktionsbuilds in den richtigen Kanal ein.
disableDevice
Abschnitt mit dem Titel “disableDevice”Was bedeutet das
Ein echtes Telefon 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 in einen anderen Kanal ein.
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
Emulator-Updates in einem Testkanal aktivieren oder diesen Kanal weiterhin auf Emulator-Updates blockieren und einen anderen Kanal für die Emulator-Validierung verwenden.
Auto-Update-Kompatibilitätsregeln
Abschnitt mit dem Titel “Auto-update compatibility rules”Hintergrundverweigerungen, wenn semver- oder Metadateregeln das Zielpaket blockieren.
disableAutoUpdate
Abschnitt mit dem Titel “disableAutoUpdate”Was bedeutet es
Auto-Update ist durch die Kanal-Kompatibilitätsrichtlinie deaktiviert. Metadaten enthalten auto_update mit einer entsprechenden Regel wie major, minor, patch, metadataWählen Sie none.
Wat zu tun
Ändern Sie die Auto-Update-Politik für Ihren geplanten Rollout zulassen.
disableAutoUpdateUnderNative
Abschnitt mit dem Titel “disableAutoUpdateUnderNative”Was bedeutet
Der Kanal hat ein Paket, das älter ist als das Geräte-Baseline und blockiert die Übermittlung von Updates unter der nativen Version.
Wat zu tun
Einen Paket bei oder über der nativen Basislinie veröffentlichen oder unter-nativen Schutz im Kanal deaktivieren.
disableAutoUpdateMetadata
Abschnitt mit dem Titel “disableAutoUpdateMetadata”Was bedeutet
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 Zielbundle oder Release aus einer neueren nativen Version.
disableAutoUpdateToMajor
Abschnitt mit dem Titel “disableAutoUpdateToMajor”Was bedeutet es
Der Kanal blockiert Sprünge auf Hauptversionen, zum Beispiel 1.x.x zu 2.x.x.
Passen Sie die Kanalstrategie mit Ihrem Hauptausrollplan an oder lassen Sie Sprünge auf Hauptversionen für diesen Track zu. Siehe
Häufige Updateprobleme Abschnitt mit dem Titel “disableAutoUpdateToMinor”.
disableAutoUpdateToMinor
Was bedeutet esSection titled “disableAutoUpdateToMajor”
The Kanal blockiert Minor-Version-Sprünge relativ zur Geräte- nativen Basis (version_build), zum Beispiel 1.2.3 Was tun 1.3.0.
Passen Sie die Kanalstrategie mit Ihrem Minor-Rollout-Plan ab, oder lassen Sie Minor-Sprünge für diesen Track zu.
Sektion mit dem Titel “disableAutoUpdateToPatch”
disableAutoUpdateToPatch
Was bedeutetDer Kanal blockiert Patch-Level-Änderungen, während die gleiche
Präfix; nur Suffix-Änderungen sind erlaubt. MAJOR.MINOR.PATCH Was tun
Passen Sie den Release-Takt mit der Kanalpolitik ab, oder lassen Sie Patch-Sprünge für diesen Track zu.
Kanal-Einstellungen
Kanal-Setup
Kanal-EinstellungenHintergrundabnahmen aufgrund fehlender oder inkompatibler Kanal-Konfiguration.
cannotUpdateViaPrivateChannel
Kanal-Einstellungen können nicht aktualisiert werdenWas bedeutet das?
Das Gerät versuchte, sich mit einem privaten Kanal zu verbinden, der die Geräte-Selbstzuweisung nicht zulässt (allow_device_self_set was falsch ist) und der Kanal ist nicht öffentlich.
Was tun?
Aktivieren Sie allow_device_self_set auf dem Kanal oder wechseln Sie das Gerät zu einem öffentlichen oder zulässigen Kanal.
channelMisconfigured
Kanal-Einstellungen können nicht aktualisiert werdenWas bedeutet das?
Der Kanal verwendet disable_auto_update: "version_number" But die Bundle ist null, daher kann __CAPGO_KEEP_0__ nicht entscheiden, welche Geräte aktualisieren sollen. min_update_version is null, so Capgo cannot decide which devices should update.
Die fehlende Konfiguration für diese Regel oder die Umstellung auf einen einfacheren Auto-Update-Modus.
Keine Kanal- oder Überschreibungs-Konfiguration
NoChannelOrOverride
Was bedeutet das?Keine Standardkanal-Konfiguration und das Gerät hat keine Kanal-Überschreibung.
Was tun?
Ein Standardkanal im Dashboard einrichten oder in der Build konfigurieren.
Bundle-Lieferung und -Verschlüsselung defaultChannel Keine Kanal- oder Überschreibungs-Konfiguration
Hintergrundabnahmen, wenn Capgo die Verbindung oder die Entschlüsselung des Bundles nicht herstellen kann.
cannotGetBundle
Sektion mit dem Titel „cannotGetBundle“Was bedeutet das?
Capgo konnte keine gültige signierte Download-URL generieren und keine Manifest-Alternative zur Verfügung stand.
Was tun?
Das Bundle erneut hochladen, Manifeste neu generieren und die Einstellungen für R2 oder das öffentliche Bundle überprüfen.
missingBundle
Sektion mit dem Titel „missingBundle“Was bedeutet das?
Das zum Kanal zugewiesene Bundle enthält keine herunterladbaren Inhalte: keine external_url, keine r2_path, keine
, kein inbegriffenes Version und keine Manifest-Einträge.
Rebuild und wieder hochladen der Version, dann bestätigen Sie, dass das Bundle echte Dateien enthält.
keyMismatch
Abschnitt mit dem Titel “keyMismatch”Was es bedeutet
Die Geräteverschlüsselungspublikumschlüssel stimmen nicht mit dem Schlüssel überein, der zum Verschlüsseln des Bundles verwendet wurde. Metadata können device_key_id, bundle_key_id, und version.
Was tun
Im Konsole die Geräte- und Bundle-Schlüssel-IDs vergleichen. Mit demselben Schlüssel und den übereinstimmenden CLI/Plugin-Versionen veröffentlichen.
Anwendungs-Konfiguration und veraltete Clients
Abschnitt mit dem Titel “App configuration and legacy clients”Hintergrund-Verweigerungen aufgrund von Anwendungs-Konfiguration oder nicht unterstützten Updater-Versionen.
customIdBlocked
Abschnitt mit dem Titel “customIdBlocked”Was es bedeutet
The App sendet eine benutzerdefinierte Geräte-ID, aber diese App akzeptiert keine benutzerdefinierten IDs, daher wird die ID ignoriert.
Was tun
Stoppen Sie die Übermittlung benutzerdefinierter 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
server.url ist in Capacitor Konfiguration festgelegt, daher lädt der 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 für Produktionsbuilds und behalten Sie die Aktualisierungsdaten lokal. Dies code kann als Backend-Verweigerung oder als Geräteseit-Status erscheinen.
backend_refusal
Abschnitt mit dem Titel „backend_refusal“Was bedeutet
The __CAPGO_KEEP_0__-Updater-Plugin ist v4, welches der Backend nicht mehr akzeptiert.
Was tun?
CLI-Plugin und Capacitor auf v5+ (vorzugsweise v8) upgraden, neu aufbauen und das Bundle-Metadaten neu veröffentlichen.
Update-Lebenszyklus
Abschnitt mit dem Titel “Update-Lebenszyklus”Geräteseitige Ereignisse für den normalen Update-Flow, Aktivierung und Rollover.
Was bedeutet das?
Interne Testaktion, die verwendet wird, um die Stats Pipeline zu überprüfen.
Was bedeutet das?
Capgo hat dem Gerät Informationen über eine neue Version gesendet.
Was bedeutet es
Ein Bundle wurde auf dem Gerät aktiviert.
Was bedeutet es
Was tun
Überprüfen Sie die native Logs mit
und bestätigen Sie die Integrität, Pfade und npx @capgo/cli@latest app debug Fluss des Bundles. notifyAppReady Abschnitt mit dem Titel ‘reset’
reset
Was bedeutet esWas tun
The Gerät wurde auf die integrierte Bundle zurückgesetzt.
Was bedeutet
Eine Bundle wurde auf dem Gerät gelöscht.
Herunterladen und Installationsfehler
Sektion mit dem Titel „Herunterladen und Installationsfehler“Geräteseitige Ereignisse für den Downloadfortschritt, Archivvalidierung und Installationsfehler.
download_0
Sektion mit dem Titel „download_0“Was bedeutet
Der Downloadsequenz begann bei 0% Fortschritt.
download_10
Sektion mit dem Titel „download_10“Was bedeutet
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
A neue Bundle wurde heruntergeladen — Fortschritt angezeigt bei 90%.
download_complete
Abschnitt mit dem Titel “download_complete”Was bedeutet das
Die Bundle-herunterladung war erfolgreich abgeschlossen.
download_manifest_start
Abschnitt mit dem Titel “download_manifest_start”Was bedeutet das
Der Geräte begann mit der Herunterladung der Update-Manifest.
download_manifest_complete
Abschnitt mit dem Titel “download_manifest_complete”Was bedeutet das
Der Geräte hat die Herunterladung des Update-Manifest abgeschlossen.
download_zip_start
Abschnitt mit dem Titel “download_zip_start”Was bedeutet das
The Gerät begann, das Bundle-Archiv herunterzuladen.
download_zip_complete
Abschnitt mit dem Titel “download_zip_complete”Was bedeutet es
Das Gerät hat das Bundle-Archiv heruntergeladen.
download_manifest_file_fail
Abschnitt mit dem Titel “download_manifest_file_fail”Was bedeutet es
Eine Manifest-Eintrags konnte nicht heruntergeladen werden. version_name Verwendet version:fileName um den Asset zu identifizieren.
Was tun
Die fehlende oder blockierte Asset reparieren, das Manifest neu generieren und das Bundle erneut hochladen.
download_manifest_checksum_fail
Abschnitt mit dem Titel “download_manifest_checksum_fail”What bedeutet es
Eine Manifestdatei hat die Prüfsummenvalidierung nicht bestanden.
Was tun?
Das Bundle mit einer aktuellen CLI Version hochladen und die Manifestprüfsummen überprüfen.
download_manifest_brotli_fail
Abschnitt mit dem Titel “download_manifest_brotli_fail”What bedeutet es
Eine Manifestdatei ist bei der Brotli-Entschlüsselung gescheitert.
Was tun?
Überprüfen Sie die Komprimierungseinstellungen und das betroffene Asset erneut hochladen.
download_fail
Abschnitt mit dem Titel “download_fail”What bedeutet es
Das Bundle konnte nicht heruntergeladen werden.
Was tun
Überprüfen Sie die Netzwerkverbindung, die Ablaufzeit der signierten URL, die CDN-Erreichbarkeit und die Speicherung auf dem Gerät.
update_fail
Abschnitt mit dem Titel „update_fail“Was bedeutet das
Die Bundle wurden installiert, aber die App rief sie nie auf, also __CAPGO_KEEP_0__ wurde zurückgerollt. notifyAppReady, so Capgo rolled back.
Rufen Sie
nachdem Ihre App sich erfolgreich gestartet hat. notifyAppReady() Natives Logoeintrag notifyAppReady was not called, roll back current bundle wird auf diesen code abgebildet.
checksum_fail
Abschnitt mit dem Titel „checksum_fail“Was bedeutet das
The heruntergeladene Bundle hat die Prüfsummenvalidierung nicht bestanden. Häufige Ursachen: CRC32 vs SHA256-Mismatch aus einem alten CLI-Upload oder Verschlüsselungsschlüsselmismatch in ä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-Publiksschlüssel mit dem Uploadschlüssel übereinstimmen oder aktualisieren Sie auf Plugin 8.3.0+ für explizite keyMismatch Fehler.
decrypt_fail
Abschnitt mit dem Titel “decrypt_fail”Was bedeutet
Das 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.
windows_path_fail
Abschnitt mit dem Titel “windows_path_fail”Was bedeutet
Das Zip enthält illegale Windows-Pfade.
Was tun
Rebuilden Sie das Bundle auf Unix-Pfaden oder säubern Sie die Archivpfade vor dem Upload.
canonical_path_fail
Abschnitt mit dem Titel “canonical_path_fail”Was bedeutet das
Die Dateipfade innerhalb des Zip-Archivs sind nicht kanonisch.
Was tun
Beheben Sie die Archivpfadgenerierung vor dem Upload.
directory_path_fail
Abschnitt mit dem Titel “directory_path_fail”Was bedeutet das
Das Zip-Archiv 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
Der Geräteversuch ist fehlgeschlagen, da die heruntergeladene Datei nicht entpackt werden konnte.
Was tun
Überprüfen Sie die Integrität der Archivdatei 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 nicht genug Speicherplatz hatte.
Was tun
Reduzieren Sie die Größe der Datei oder versuchen Sie es auf einem Gerät mit mehr freiem Speicherplatz.
App-Gesundheit und WebView-Ereignisse
Abschnitt mit dem Titel ‘App health and WebView events’Geräte-seitige Crash, Speicher- und WebView-Diagnose. Die Metadaten-JSON-Datei wird immer im Dashboard überprüft.
app_moved_to_background
Sektion mit dem Titel “app_moved_to_background”Was bedeutet das
Die App wurde in den Hintergrund geschoben.
app_moved_to_foreground
Sektion mit dem Titel “app_moved_to_foreground”Was bedeutet das
Die App wurde in den Vordergrund geschoben.
app_crash
Sektion mit dem Titel “app_crash”Was bedeutet das
JavaScript- oder Capacitor Layer-Crash. Die Metadaten können eine Nachricht, einen Stapel, eine Quelle und den aktiven Bundle-Kontext enthalten.
Was tun
Die Metadaten und native Logs überprüfen. JS- und native Fehlerberichterstellung (z.B. Sentry) kombinieren, um den fehlerhaften code Pfad zu lokalisieren.
app_crash_native
Abschnitt mit dem Titel “app_crash_native”Was bedeutet es
Natives Plattformcrash. Die Metadaten können Plattform, Grund, Stapel und Prozessdetails enthalten.
Was tun
Verwenden Sie Xcode oder Logcat-Crash-Logs und korrelieren Sie sie mit der aktiven Bundle aus den Metadaten.
Was bedeutet es
Android-Anwendungs-Blockierungsereignis.
Was tun
Überprüfen Sie die ANR-Tracks in Logcat und reduzieren Sie nach Updates den Blockierungsarbeit auf der Hauptthread.
app_killed_low_memory
Abschnitt mit dem Titel “app_killed_low_memory”Was bedeutet es
Die Betriebssystem hat die App nach Druck auf die Speicherfläche getötet.
Was tun
Reduzieren Sie die Speicherfläche 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 das
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 der Startvorgang ist vor der normalen Laufzeit bereitgestellt worden.
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 Speicherzustand 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 die Meldung, die Quell-URL, die Zeile, die Spalte und die Stack-Informationen enthalten.
Was tun
Installieren Sie eine Fehlerberichterstellung in JS- und native Layers, um die genaue fehlgeschlagene Zeile in der Produktion zu erfassen.
webview_unhandled_rejection
Abschnitt mit dem Titel “webview_unhandled_rejection”Was bedeutet es
Unbehandelter Versprechenverwerfung im WebView.
Was tun
Fangen Sie asynchrone Fehler mit JS und native Fehlerberichterstattung ab.
webview_resource_error
Abschnitt mit dem Titel “webview_resource_error”Was bedeutet es
Ein WebView-Ressource konnte nicht geladen werden.
Was tun
Verwenden Sie die Metadaten-URL und die Statusdetails, um beschädigte Assets oder Netzwerkregeln zu beheben.
webview_security_policy_violation
Abschnitt mit dem Titel “webview_security_policy_violation”Was bedeutet es
Die Inhaltsicherheitspolitik blockierte eine Ressource.
Was tun
Mit Hilfe der Metadaten-Direktive und der Details der blockierten URI justieren Sie die CSP.
webview_unclean_restart
Abschnitt mit dem Titel “webview_unclean_restart”Was bedeutet das
Die vorherige WebView-Sitzung wurde nicht sauber beendet, was nach einem Update auf Crash-Schleifen hindeuten kann.
Was tun
Bevor und nach dem Neustart mit den Crash- und WebView-Fehlerereignissen korrelieren.
webview_render_process_gone
Abschnitt mit dem Titel “webview_render_process_gone”Was bedeutet das
Der Android-WebView-Rendere-Prozess ist beendet.
Was tun
In den Metadaten und den native Logs die Renderer-Crash-Signale überprüfen.
webview_content_process_terminated
Abschnitt mit dem Titel “webview_content_process_terminated”Was bedeutet es
iOS WebView-Inhalt-Prozess beendet.
Was tun
Aktives Bundle und Seite-URL aus Metadaten überprüfen.
Umgebung und Kanalkontext
Abschnitt mit dem Titel “Umgebung und Kanalkontext”Geräteseitige Kontextereignisse, die helfen, Aktualisierungsverhalten mit Betriebssystem, nativer Version oder Kanälabänderungen zu korrelieren.
os_version_changed
Abschnitt mit dem Titel “os_version_changed”Was bedeutet es
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, um native und Web-Bundle-Änderungen zu trennen.
getChannel
Abschnitt "getChannel"Was bedeutet das
Das Gerät hat seinen aktuellen Kanal abgefragt.
setChannel
Abschnitt "setChannel"Was bedeutet das
Ein Kanal wurde erfolgreich für das Gerät gesetzt.
uninstall
Abschnitt "uninstall"Was bedeutet das
Die App wurde uninstalliert oder Capgo Daten wurden gelöscht.
Bundle-Status
Sektion mit dem Titel „Bundle-Status“SUCCESS: Bundle installiertERROR: Installieren oder herunterladen fehlgeschlagenPENDING: Herunterladen abgeschlossen, Freigabe steht noch ausDELETED: Bundle wurde gelöscht, aber noch für Statistiken angezeigtDOWNLOADINGEin 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 debugDies ermöglicht Ihnen, alle Ereignisse im App zu überprüfen und eine Lösung zu finden, wenn Updates nicht erfolgen.
iOS-native-Protokolle
Abschnitt mit dem Titel „iOS-native-Protokolle“Um Ihre Protokolle in Xcode zu finden
Android-native-Protokolle
Abschnitt mit dem Titel „Android-native-Protokolle“Um Ihre Protokolle in Android Studio zu finden
Abstimmung von Native-Log-Phrasen
Abschnitt mit dem Titel „Abstimmung von Native-Log-Phrasen“Failed to download fromkoppelt sich andownload_failnotifyAppReady was not called, roll back current bundlekoppelt sich anupdate_fail
Das heruntergeladene Bundle auf einem Gerät zu finden
Abschnitt mit dem Titel “Das heruntergeladene Bundle auf einem Gerät zu finden”Um auf iOS zu debuggen, müssen Sie das App-Programm auf Ihrem Computer ausladen, Sie können es wie folgt tun:
Xcode verfügt über eine integrierte Funktion zum Aufrufen des Dateisystems von Entwickler-Apps auf einem iOS-Gerät.

Um dies zu erreichen:
- Verbinden Sie Ihr Gerät mit Ihrem Mac und wählen Sie in der Xcode-Menüleiste unter Window > Geräte.
- Wählen Sie Ihr Gerät in der linken Spalte unter der Geräte-Sektion.
- This wird eine Liste der von Entwicklern installierten Apps für das Gerät anzeigen.
- Wählen Sie die App aus, die Sie untersuchen möchten, und wählen Sie dann das 3 Punkte-Symbol nahe der unteren Seite des Bildschirms aus.
- Hier können Sie das aktuelle Dateisystem anzeigen, indem Sie eine Snapshot-Datei herunterladen.

Wenn Sie Download Container… auswählen, wird eine Snapshot-Datei des Dateisystems als .xcappdata-Datei heruntergeladen und exportiert, die Sie durchsuchen können.

Klicken Sie mit der rechten Maustaste auf diese Datei und wählen Sie 'Ordnerinhalt anzeigen' aus, um den Ordner zu öffnen.
Öffnen Sie den App-Datenspeicher, und Sie sollten nun einige Ordner wie Dokumente, Bibliothek, tmp usw. sehen.

Sie werden dann in zwei Ordner finden:
library/NoCloud/ionic_built_snapshots ist erforderlich, nachdem sich das Gerät neu gestartet hat
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 > 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/ wobei APP_NAME Ihr App-ID ist.

Dann finden Sie das versions Werden Sie wissen?
Abschnitt: 'iOS-Produktionscrash-Protokolle verstehen'
Wie Sie die Crash-Protokolle Ihres Apps überprüfenAbschnitt: 'Fortsetzen Sie bei Debugging'
Wenn Sie native Plugin-Arbeit planen, verbinden Sie es mitDebugging um native Plugin-Arbeit zu planen, verbinden Sie es mit __CAPGO_KEEP_0__ Mit @capgo/capacitor-Updater für die native Fähigkeit in Mit @capgo/capacitor-Updater Capgo Plugin-Ordner für den Produktworkflow in Capgo Plugin-Ordner Capacitor Plugins von Capgo für die Implementierungsdetail in Capacitor Plugins von Capgo, Hinzufügen oder Aktualisieren von Plugins für die Implementierungsdetail in Hinzufügen oder Aktualisieren von Plugins, und Ionic Enterprise Plugin Alternativen für den Produktworkflow in Ionic Enterprise Plugin Alternativen.