Debugging
Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses Plugin.
Cloud-Logs verstehen
Abschnitt mit dem Titel „Cloud-Logs verstehen“Falls code von der Cloud abgelehnt wird und du detaillierte Anleitungen zur Fehlerbehebung benötigst, schau hier Häufige Update-Probleme.
Capgo Logs können Metadaten zum Event enthalten. Filtere im Dashboard nach der snake_case Action code und klicke auf die Metadata-Zelle, um das vollständige JSON-Payload zu kopieren. Metadaten sind besonders hilfreich für Crash- und WebView-Events, da sie Fehlermeldungen, die Source-URL, Zeile und Spalte, den Prozessstatus, Memory Pressure oder plattformspezifische Gründe enthalten können. Ältere Logs können noch Legacy camelCase-Aliase in Klammern anzeigen.
Jeder Abschnittstitel entspricht der Action code, die in der Console-Logs-Tabelle angezeigt wird, sodass du direkt dorthin verlinken kannst.
Plan-Limits und normale Antworten
Abschnitt mit dem Titel „Plan-Limits und normale Antworten“Backend-Ablehnungen im Zusammenhang mit Abrechnung, Throttling oder Nicht-Fehler-Zuständen.
InvalidIp
Abschnitt mit dem Titel „InvalidIp“What it means
Capgo hat Traffic erkannt, der von Google oder Cloud-Infrastrukturen zu stammen scheint. Updates, die jünger als vier Stunden sind, werden ignoriert, damit Bot-Traffic nicht als kostenpflichtige Geräte gezählt wird.
Was zu tun ist
Ignoriere dies bei echten Nutzern. Versuche es über normale Netzwerke und echte Geräte erneut, oder warte und prüfe es später.
provider_infrastructure_request_blocked
Abschnitt mit dem Titel „provider_infrastructure_request_blocked“What it means
Deine App ist so konfiguriert, dass Anfragen aus bekannten IP-Bereichen von Google- und Apple-Rechenzentren blockiert werden. Dieser Schutz gilt für Update-Checks, Stats und channel-self-Anfragen. Daher können Cloud-basierte Probes und Provider-Runner diese Antwort erhalten, selbst wenn die App-Konfiguration ansonsten gültig ist.
Was zu tun ist
Versuche es über ein physisches Gerät in einem normalen Nutzernetzwerk. Falls der vom Provider ausgehende Traffic beabsichtigt ist, deaktiviere diesen vorübergehend Provider-Infrastruktur-Anfragen blockieren in der App- Informationen im Tab und aktiviere ihn nach dem Test wieder. Neue Apps haben diese Einstellung standardmäßig aktiviert; bestehende Apps behalten ihre vorherige Einstellung bei, bis sie geändert wird.
needPlanUpgrade
Abschnitt mit dem Titel „needPlanUpgrade“What it means
Deine Organisation hat das Limit für den Plan oder die Anzahl der Geräte erreicht. Das Gerät erhält keine Updates mehr, bis du dein Abo upgradest oder der nächste Abrechnungszyklus beginnt.
Was zu tun ist
Upgrade deinen Plan im Dashboard oder warte bis zum nächsten Abrechnungszyklus.
What it means
Das Gerät hat bereits das neueste verfügbare Bundle für seinen Channel. Dies ist ein normaler Zustand und kein Fehler.
rateLimited
Abschnitt mit dem Titel „rateLimited“What it means
Das Gerät hat in kurzer Zeit zu viele Update- oder Channel-Anfragen gesendet.
Was zu tun ist
Rufe Update-APIs nicht innerhalb von Render-Loops auf. Rufe sie setChannel / getChannel nur durch User-Aktionen auf und setze defaultChannel in capacitor.config.
Versionsformat
Abschnitt mit dem Titel „Versionsformat“Backend-Ablehnungen aufgrund ungültiger Metadaten zur nativen Version.
semver_error
Abschnitt mit dem Titel „semver_error“What it means
Die native App-Version in der Config fehlt oder ist kein gültiges SemVer (x.y.z).
Was zu tun ist
Setzen Sie plugins.CapacitorUpdater.version Um ein gültiges SemVer zu erhalten, prüfe es im SemVer-Tester), baue die native App neu und installiere sie erneut.
Plattform- und Build-Targeting
Abschnitt mit dem Titel „Plattform- und Build-Targeting“Backend-Ablehnungen, wenn die Channel-Policy eine Plattform, einen Build-Typ oder eine Geräteklasse blockiert.
disablePlatformIos
Abschnitt mit dem Titel „disablePlatformIos“What it means
Das Gerät nutzt iOS, aber iOS-Updates sind für diesen Channel deaktiviert.
Was zu tun ist
Aktiviere iOS im Channel, falls dies ein Versehen war, oder leite iOS-Builds in einen eigenen Channel um, wenn die Blockierung beabsichtigt ist.
disablePlatformAndroid
Abschnitt mit dem Titel „disablePlatformAndroid“What it means
Das Gerät nutzt Android, aber Android-Updates sind für diesen Channel deaktiviert.
Was zu tun ist
Aktiviere Android im Channel, falls dies versehentlich geschah, oder leite Android-Builds in einen eigenen Channel um, wenn das Blockieren beabsichtigt ist.
disablePlatformElectron
Abschnitt mit dem Titel „disablePlatformElectron“What it means
Das Gerät nutzt Electron, aber Electron-Updates sind für diesen Channel deaktiviert.
Was zu tun ist
Aktiviere Electron im Channel, falls dies versehentlich geschah, oder leite Electron-Builds in einen eigenen Channel um, wenn das Blockieren beabsichtigt ist.
disableDevBuild
Abschnitt mit dem Titel „disableDevBuild“What it means
Das Gerät ist ein Development Build, aber Dev-Builds sind für diesen Channel blockiert.
Was zu tun ist
Erlaube Dev-Builds in einem Test-Channel, oder nutze diesen Channel nur für Releases und verschiebe Dev-Geräte woandershin.
disableProdBuild
Abschnitt mit dem Titel „disableProdBuild“What it means
Ein Production-Build namens /updates, aber Production-Updates sind für diesen Channel gesperrt.
Was zu tun ist
Erlaube Production-Updates in diesem Channel, falls dies ein Versehen war, oder leite Production-Builds an den richtigen Channel weiter.
disableDevice
Abschnitt mit dem Titel „disableDevice“What it means
Ein echtes Smartphone oder Tablet wurde blockiert, da dieser Channel echte Geräte sperrt.
Was zu tun ist
Aktiviere Updates auf echten Geräten, falls dies ein Versehen war, oder behalte die Einschränkung bei und leite echte Geräte auf einen anderen Channel um.
disableEmulator
Abschnitt mit dem Titel „disableEmulator“What it means
Das Gerät ist ein Emulator, aber Emulator-Updates sind für diesen Channel deaktiviert.
Was zu tun ist
Aktiviere Emulator-Updates in einem Test-Channel oder blockiere Emulatoren in diesem Channel und nutze einen anderen für die Emulator-Validierung.
Auto-Update-Kompatibilitätsregeln
Abschnitt: „Regeln für die Auto-Update-Kompatibilität“Backend-Ablehnungen, wenn SemVer- oder Metadaten-Regeln das Ziel-Bundle blockieren.
disableAutoUpdate
Abschnitt: „disableAutoUpdate“What it means
Auto-Update ist durch die Channel-Kompatibilitätsrichtlinie deaktiviert. Metadaten enthalten auto_update mit einer passenden Regel wie major, minor, patch, metadata, oder none.
Was zu tun ist
Ändere die Auto-Update-Policy des Channels, um deinen Rollout zu ermöglichen.
disableAutoUpdateUnderNative
Abschnitt mit dem Titel „disableAutoUpdateUnderNative“What it means
Der Channel enthält ein Bundle, das älter als die native Baseline des Geräts ist, wodurch Updates unterhalb der nativen Version blockiert werden.
Was zu tun ist
Veröffentliche ein Bundle auf oder über der nativen Baseline oder deaktiviere den „Under-Native“-Schutz im Channel.
disableAutoUpdateMetadata
Abschnitt mit dem Titel „disableAutoUpdateMetadata“What it means
Der Channel erfordert min_update_version, aber die native Version des Geräts liegt unter diesem Schwellenwert.
Was zu tun ist
Setzen Sie min_update_version auf dem Ziel-Bundle oder Release einer neueren Native Build Version.
disableAutoUpdateToMajor
Abschnitt mit dem Titel „disableAutoUpdateToMajor“What it means
Der Channel blockiert Major-Version-Sprünge, zum Beispiel 1.x.x zu 2.x.x.
Was zu tun ist
Stimme die Channel-Strategie mit deinem Major-Rollout-Plan ab oder erlaube Major-Sprünge für diesen Track. Siehe Häufige Update-Probleme.
disableAutoUpdateToMinor
Abschnitt mit dem Titel „disableAutoUpdateToMinor“What it means
Der Channel blockiert Minor-Version-Sprünge im Vergleich zur nativen Baseline des Geräts (version_build), zum Beispiel 1.2.3 zu 1.3.0.
Was zu tun ist
Stimme die Channel-Strategie auf deinen Rollout-Plan ab oder erlaube Patch-Sprünge für diesen Track.
disableAutoUpdateToPatch
Abschnitt mit dem Titel „disableAutoUpdateToPatch“What it means
Der Channel blockiert Änderungen auf Patch-Ebene bei gleichem MAJOR.MINOR.PATCH Präfix; nur Änderungen am Suffix sind erlaubt.
Was zu tun ist
Stimme den Release-Zyklus auf die Channel-Policy ab oder erlaube Patch-Sprünge für diesen Track.
Channel-Setup
Abschnitt mit dem Titel „Channel setup“Backend-Ablehnungen aufgrund fehlender oder inkompatibler Channel-Konfiguration.
cannotUpdateViaPrivateChannel
Abschnitt mit dem Titel „cannotUpdateViaPrivateChannel“What it means
Das Gerät hat versucht, sich selbst einem privaten Channel zuzuweisen, der keine automatische Zuweisung erlaubt (allow_device_self_set ist false) und der Channel ist nicht öffentlich.
Was zu tun ist
Aktivieren allow_device_self_set im Channel oder wechselt das Gerät zu einem öffentlichen oder erlaubten Channel.
channelMisconfigured
Abschnitt mit dem Titel „channelMisconfigured“What it means
Der Channel nutzt disable_auto_update: "version_number" aber das Bundle min_update_version ist null, daher kann Capgo nicht entscheiden, welche Geräte ein Update erhalten sollen.
Was zu tun ist
Ergänze die fehlende Konfiguration für diese Regel oder wechsle zu einem einfacheren Auto-Update-Modus.
NoChannelOrOverride
Abschnitt mit dem Titel „NoChannelOrOverride“What it means
Es ist kein Standard-Channel konfiguriert und das Gerät hat keinen Channel-Override.
Was zu tun ist
Lege einen Standard-Channel im Dashboard fest oder konfiguriere ihn defaultChannel in the build.
Bundle-Auslieferung und Verschlüsselung
Abschnitt mit dem Titel „Bundle delivery and encryption“Backend-Ablehnungen, wenn Capgo das Bundle nicht ausliefern oder entschlüsseln kann.
cannotGetBundle
Abschnitt mit dem Titel „cannotGetBundle“What it means
Capgo konnte keine gültige signierte Download-URL generieren und es war kein Manifest-Fallback verfügbar.
Was zu tun ist
Bundle erneut hochladen, Manifests neu generieren und R2- oder öffentliche Bundle-Einstellungen prüfen.
missingBundle
Abschnitt mit dem Titel „missingBundle“What it means
Das dem Channel zugewiesene Bundle enthält keine herunterladbaren Inhalte: kein external_url, kein r2_path, keine integrierte Version und keine Manifest-Einträge.
Was zu tun ist
Version neu bauen und hochladen, dann sicherstellen, dass das Bundle echte Dateiinhalte hat.
keyMismatch
Abschnitt mit dem Titel „keyMismatch“What it means
The device encryption public key does not match the key used to encrypt the bundle. Metadata can include device_key_id, bundle_key_id, und version.
Was zu tun ist
Vergleiche die Key-IDs von Gerät und Bundle in der Konsole. Veröffentliche mit demselben Key und passenden CLI/Plugin-Versionen.
App-Konfiguration und Legacy-Clients
Abschnitt mit dem Titel „App-Konfiguration und Legacy-Clients“Backend-Ablehnungen aufgrund der App-Konfiguration oder nicht unterstützter Updater-Versionen.
customIdBlocked
Abschnitt mit dem Titel „customIdBlocked“What it means
Die App hat eine benutzerdefinierte Device-ID gesendet, aber diese App akzeptiert keine benutzerdefinierten IDs, daher wird die ID ignoriert.
Was zu tun ist
Sende keine benutzerdefinierten IDs mehr oder aktiviere sie nur, wenn dein Workflow dies erfordert.
blocked_by_server_url
Abschnitt mit dem Titel „blocked_by_server_url“What it means
server.url ist in der Capacitor-Konfiguration gesetzt, sodass die WebView eine Remote-URL statt lokaler Bundle-Dateien lädt. Capgo Live Updates benötigen lokale Dateien und server.url wird in der Produktion nicht empfohlen.
Was zu tun ist
Entfernen oder leeren server.url für Production-Builds und um Update-Payloads lokal zu halten. Dieser code kann entweder als Ablehnung durch das Backend oder als Status auf dem Gerät erscheinen.
backend_refusal
Abschnitt mit dem Titel „backend_refusal“What it means
Das Updater-Plugin ist v4, was vom Backend nicht mehr akzeptiert wird.
Was zu tun ist
Upgrade Plugin und CLI auf v5+ (v8 empfohlen) mit Capacitor v5+, rebuild und republish der Bundle-Metadaten.
Update-Lifecycle
Abschnitt mit dem Titel „Update-Lifecycle“Geräteseitige Events für den normalen Update-Flow, die Aktivierung und den Rollback.
What it means
Interner Test-Aktion, um die Stats-Pipeline zu verifizieren.
What it means
Capgo hat Download-Infos für eine neue Version an das Gerät gesendet.
What it means
Ein Bundle wurde auf dem Gerät aktiviert.
What it means
Ein Bundle konnte auf dem Gerät nicht aktiviert werden.
Was zu tun ist
Native Logs prüfen mit npx @capgo/cli@latest app debug und die Bundle-Integrität, Pfade sowie den notifyAppReady flow.
reset
Abschnitt „reset“What it means
Das Gerät wurde auf das integrierte Bundle zurückgesetzt.
What it means
Ein Bundle wurde auf dem Gerät gelöscht.
Download- und Installationsfehler
Abschnitt „Download- und Installationsfehler“Geräteinterne Events für den Download-Fortschritt, die Archivvalidierung und Installationsfehler.
download_0
Abschnitt „download_0“What it means
Die Download-Sequenz startete bei 0 % Fortschritt.
download_10
Abschnitt „download_10“What it means
Ein neues Bundle wurde heruntergeladen – Fortschritt bei 10 %.
download_20
Abschnitt „download_20“What it means
Ein neues Bundle wurde heruntergeladen – Fortschritt bei 20 %.
download_30
Abschnitt mit dem Titel „download_30“What it means
Ein neues Bundle wurde heruntergeladen – Fortschritt bei 30 %.
download_40
Abschnitt mit dem Titel „download_40“What it means
Ein neues Bundle wurde heruntergeladen – Fortschritt bei 40 %.
download_50
Abschnitt mit dem Titel „download_50“What it means
Ein neues Bundle wurde heruntergeladen – Fortschritt bei 50 %.
download_60
Abschnitt mit dem Titel „download_60“What it means
Ein neues Bundle wurde heruntergeladen – Fortschritt bei 60 %.
download_70
Abschnitt mit dem Titel „download_70“What it means
Ein neues Bundle wurde heruntergeladen – Fortschritt bei 70 %.
download_80
Abschnitt mit dem Titel „download_80“What it means
Ein neues Bundle wurde heruntergeladen – Fortschritt bei 80 %.
download_90
Abschnitt mit dem Titel „download_90“What it means
Ein neues Bundle wurde heruntergeladen – Fortschritt bei 90 %.
download_complete
Abschnitt mit dem Titel „download_complete“What it means
Der Bundle-Download war erfolgreich.
download_manifest_start
Abschnitt mit dem Titel „download_manifest_start“What it means
Das Gerät hat mit dem Download des Update-Manifests begonnen.
download_manifest_complete
Abschnitt mit dem Titel „download_manifest_complete“What it means
Das Gerät hat den Download des Update-Manifests abgeschlossen.
download_zip_start
Abschnitt mit dem Titel „download_zip_start“What it means
Das Gerät hat mit dem Download des Bundle-Archivs begonnen.
download_zip_complete
Abschnitt mit dem Titel „download_zip_complete“What it means
Das Gerät hat den Download des Bundle-Archivs abgeschlossen.
download_manifest_file_fail
Abschnitt mit dem Titel „download_manifest_file_fail“What it means
Ein Manifest-Eintrag konnte nicht heruntergeladen werden. version_name verwendet version:fileName um das Asset zu identifizieren.
Was zu tun ist
Behebe das fehlende oder blockierte Asset, generiere das Manifest neu und lade das Bundle erneut hoch.
download_manifest_checksum_fail
Abschnitt mit dem Titel „download_manifest_checksum_fail“What it means
Die Prüfsummenvalidierung der Manifest-Datei ist fehlgeschlagen.
Was zu tun ist
Lade das Bundle mit einer aktuellen CLI Version erneut hoch und prüfe die Manifest-Checksummen.
download_manifest_brotli_fail
Abschnitt mit dem Titel „download_manifest_brotli_fail“What it means
Die Brotli-Dekompression einer Manifest-Datei ist fehlgeschlagen.
Was zu tun ist
Prüfe die Komprimierungseinstellungen und lade die betroffenen Assets erneut hoch.
download_fail
Abschnitt mit dem Titel „download_fail“What it means
Das Bundle konnte nicht heruntergeladen werden.
Was zu tun ist
Prüfe die Netzwerkverbindung, das Ablaufdatum der signierten URL, die CDN-Erreichbarkeit und den Gerätespeicher.
update_fail
Abschnitt „update_fail“What it means
Das Bundle wurde installiert, aber die App hat es nie aufgerufen notifyAppReady, daher hat Capgo ein Rollback durchgeführt.
Was zu tun ist
Rufe notifyAppReady() nachdem deine App das Bootstrapping abgeschlossen hat. Native-Log-Text notifyAppReady was not called, roll back current bundle entspricht diesem code.
checksum_fail
Abschnitt „checksum_fail“What it means
Die Checksummenprüfung des heruntergeladenen Bundles ist fehlgeschlagen. Häufige Ursachen: ein CRC32-vs.-SHA256-Mismatch durch einen alten CLI-Upload oder ein Encryption-Key-Mismatch bei älteren Plugins, die einen Decryption-Fehler als Checksum-Fehler melden.
Was zu tun ist
Erneuter Upload mit einem aktuellen CLI/Plugin (SHA256). Bei Verschlüsselung prüfen, ob der Public Key der App mit dem Upload-Key übereinstimmt, oder auf Plugin 8.3.0+ upgraden für explizite keyMismatch errors.
decrypt_fail
Abschnitt mit dem Titel „decrypt_fail“What it means
The downloaded bundle failed to decrypt.
Was zu tun ist
Prüfe die Verschlüsselungsschlüssel und lade das Bundle mit dem passenden Schlüsselpaar erneut hoch.
windows_path_fail
Abschnitt mit dem Titel „windows_path_fail“What it means
Das ZIP enthält ungültige Windows-Pfade.
Was zu tun ist
Erstelle das Bundle mit Unix-Pfaden neu oder bereinige die Archivpfade vor dem Upload.
canonical_path_fail
Abschnitt „canonical_path_fail“What it means
Die Dateipfade innerhalb der Zip-Datei sind nicht kanonisch.
Was zu tun ist
Korrigiere die Pfadgenerierung des Archivs vor dem Upload.
directory_path_fail
Abschnitt „directory_path_fail“What it means
Die Zip-Datei enthält ungültige Verzeichnispfade.
Was zu tun ist
Korrigiere die Archivstruktur vor dem Upload.
unzip_fail
Abschnitt „unzip_fail“What it means
Das Gerät konnte das heruntergeladene Bundle nicht entpacken.
Was zu tun ist
Prüfe die Archiv-Integrität und die unterstützte Komprimierung.
low_mem_fail
Abschnitt „low_mem_fail“What it means
Der Download schlug fehl, da der Arbeitsspeicher des Geräts voll war.
Was zu tun ist
Verringere die Bundle-Größe oder versuche es auf einem Gerät mit mehr freiem Speicher.
App-Status und WebView-Events
Abschnitt „App health and WebView events“Diagnose für Abstürze, Speicher und WebView auf dem Gerät. Prüfe immer das Metadata-JSON im Dashboard.
app_moved_to_background
Abschnitt „app_moved_to_background“What it means
Die App wurde in den Hintergrund verschoben.
app_moved_to_foreground
Abschnitt mit dem Titel „app_moved_to_foreground“What it means
Die App ist in den Vordergrund gewechselt.
app_crash
Abschnitt mit dem Titel „app_crash“What it means
Crash in der JavaScript- oder Capacitor-Schicht. Metadaten können Message, Stack, Source und den aktiven Bundle-Kontext enthalten.
Was zu tun ist
Metadaten und native Logs prüfen. Kombiniere JS- und native Error-Reporting-Tools (z. B. Sentry), um den fehlerhaften code-Pfad zu finden.
app_crash_native
Abschnitt mit dem Titel „app_crash_native“What it means
Native Plattform-Crash. Metadaten können Plattform, Grund, Stack und Prozessdetails enthalten.
Was zu tun ist
Nutze Xcode- oder Logcat-Crashlogs und korreliere sie mit dem aktiven Bundle aus den Metadaten.
What it means
Android Application Not Responding Event.
Was zu tun ist
Untersuche ANR-Traces in Logcat und reduziere blockierende Aufgaben im Main-Thread nach Updates.
app_killed_low_memory
Abschnitt mit dem Titel „app_killed_low_memory“What it means
Das OS hat die App aufgrund von Speichermangel beendet.
Was zu tun ist
Reduziere den Speicherverbrauch nach der Update-Aktivierung und prüfe die Metadaten auf verfügbare Speicher-Signale.
app_killed_excessive_resource_usage
Abschnitt mit dem Titel „app_killed_excessive_resource_usage“What it means
The OS killed the app for excessive resource use.
Was zu tun ist
Prüfe die Metadaten auf den Ressourcentyp oder den Grund des Betriebssystems.
app_initialization_failure
Abschnitt mit dem Titel „app_initialization_failure“What it means
Updater oder Startvorgang fehlgeschlagen, bevor die normale Laufzeit bereit war.
Was zu tun ist
Prüfe die Metadaten auf den fehlgeschlagenen Schritt und die Fehlermeldung.
app_memory_warning
Abschnitt mit dem Titel „app_memory_warning“What it means
iOS-Speicherwarnung.
Was zu tun ist
Analysiere den Speicher-Kontext in den Metadaten und reduziere die Spitzenlast nach Updates.
webview_javascript_error
Abschnitt „webview_javascript_error“What it means
Nicht abgefangener JavaScript-Fehler im WebView. Metadaten können Message, Source URL, Zeile, Spalte und Stack enthalten.
Was zu tun ist
Implementiere Error Reporting in der JS- und Native-Layer, um die exakte Fehlerzeile in der Produktion zu erfassen.
webview_unhandled_rejection
Abschnitt „webview_unhandled_rejection“What it means
Nicht abgefangene Promise-Rejection im WebView.
Was zu tun ist
Async-Fehler mit JS- und Native-Error-Reporting erfassen.
webview_resource_error
Abschnitt mit dem Titel „webview_resource_error“What it means
Ein WebView-Resource konnte nicht geladen werden.
Was zu tun ist
Nutze die Metadata-URL und Status-Details, um defekte Assets oder Netzwerkregeln zu beheben.
webview_security_policy_violation
Abschnitt mit dem Titel „webview_security_policy_violation“What it means
Eine Content Security Policy hat eine Resource blockiert.
Was zu tun ist
CSP über die Metadata-Directive und Details zu blockierten URIs anpassen.
webview_unclean_restart
Abschnitt: „webview_unclean_restart“What it means
Die vorherige WebView-Session wurde nicht sauber beendet; dies kann auf Crash-Loops nach einem Update hindeuten.
Was zu tun ist
Korrelieren Sie dies mit Crash- und WebView-Fehlerereignissen vor und nach dem Neustart.
webview_render_process_gone
Abschnitt: „webview_render_process_gone“What it means
Der Android WebView Renderer-Prozess wurde beendet.
Was zu tun ist
Prüfen Sie Renderer-Crash-Signale in den Metadaten und nativen Logs.
webview_content_process_terminated
Abschnitt: „webview_content_process_terminated“What it means
iOS WebView Content-Prozess beendet.
Was zu tun ist
Aktives Bundle und Seiten-URL aus den Metadaten prüfen.
Umgebungs- und Channel-Kontext
Abschnitt mit dem Titel „Umgebungs- und Channel-Kontext“Gerätebasierte Kontext-Events, die helfen, das Update-Verhalten mit OS-, Native-Version- oder Channel-Änderungen zu korrelieren.
os_version_changed
Abschnitt mit dem Titel „os_version_changed“What it means
Device OS version changed between checks.
native_app_version_changed
Abschnitt mit dem Titel „native_app_version_changed“What it means
Die native App-Store-Version hat sich geändert; hilft bei der Unterscheidung zwischen nativen und Web-Bundle-Änderungen.
getChannel
Abschnitt „getChannel“What it means
Das Gerät hat seinen aktuellen Channel abgefragt.
setChannel
Abschnitt „setChannel“What it means
Ein Channel wurde erfolgreich für das Gerät gesetzt.
uninstall
Abschnitt „uninstall“What it means
Die App wurde deinstalliert oder Capgo Daten wurden gelöscht.
Bundle-Status
Abschnitt „Bundle-Status“SUCCESS: Bundle-Installation abgeschlossenERROR: Installation oder Download fehlgeschlagenPENDING: Download abgeschlossen, Release ausstehendDELETED: Bundle gelöscht, wird in Stats noch angezeigtDOWNLOADING: Lädt gerade ein Bundle herunter
Device Logs verstehen
Abschnitt mit dem Titel „Device Logs verstehen“Debug-Befehl
Abschnitt mit dem Titel „Debug-Befehl“Es gibt einen Debug-Befehl für Capgo Cloud-Nutzer.
npx @capgo/cli@latest app debugDamit kannst du alle Ereignisse in der App prüfen und Lösungen finden, falls Updates nicht wie erwartet ausgeführt werden.
iOS native Logs
Abschnitt mit dem Titel „iOS native Logs“um deine Logs in Xcode zu finden
Android native Logs
Abschnitt mit dem Titel „Android native Logs“um deine Logs in Android Studio zu finden
Mapping für native Log-Phrasen
Abschnitt mit dem Titel „Mapping für native Log-Phrasen“Failed to download fromentsprichtdownload_failnotifyAppReady was not called, roll back current bundleentsprichtupdate_fail
Das heruntergeladene Bundle auf dem Gerät finden
Abschnitt mit dem Titel „Das heruntergeladene Bundle auf dem Gerät finden“Um das Debugging auf iOS durchzuführen, müssen Sie die App auf Ihren Computer übertragen. So gehen Sie dabei vor:
Xcode bietet eine integrierte Funktion, um das Dateisystem von über Entwickler-Tools installierten Apps auf einem iOS-Gerät zu inspizieren.
So gehst du vor:
- Verbinde dein Gerät mit dem Mac und wähle Window > Devices in der Xcode-Menüleiste.
- Wähle dein Gerät im linken Bereich unter der Sektion Devices aus.
- Es wird eine Liste der auf diesem Gerät installierten Entwickler-Apps angezeigt.
- Wähle die App aus, die du inspizieren möchtest, und klicke dann auf das Drei-Punkte-Icon unten am Bildschirm.
- Hier kannst du das aktuelle Dateisystem einsehen, indem du einen Snapshot herunterlädst.
Auswahl von Download Container… lädt einen Snapshot des Dateisystems als .xcappdata-Datei herunter und exportiert diesen, damit du ihn durchsuchen kannst.
Rechtsklick auf diese Datei und „Package Contents zeigen“ auswählen, um den Ordner zu öffnen.
Öffne den App Data Ordner; du solltest nun Ordner wie Documents, Library, tmp usw. sehen.
Danach findest du eine Version in zwei Ordnern:
library/NoCloud/ionic_built_snapshots ist nach einem App-Reboot erforderlich
und documents/versions für Hot Reload
Um das Debugging auf Android durchzuführen, müssen Sie über Android Studio auf das Gerät zugreifen:
- Klicken Sie auf View > Tool Windows > Device File Explorer oder nutzen Sie die Schaltfläche Device File Explorer in der Tool-Window-Leiste.
- Wählen Sie ein Gerät aus dem Dropdown-Menü aus.
- Öffnen Sie den Pfad data/data/APP_NAME/ wo APP_NAME ist Ihre App-ID.
Suchen Sie dann den versions Ordner, um alle Versionen zu sehen
iOS Production Crash Logs verstehen
Abschnitt mit dem Titel „iOS Production Crash Logs verstehen“Weiterlesen im Bereich Debugging
Abschnitt mit dem Titel „Weiterlesen im Bereich Debugging“Wenn du es nutzt Debugging Um die Arbeit an nativen Plugins zu planen, verbinde sie mit Verwendung von @capgo/capacitor-updater für die native Funktion in der Verwendung von @capgo/capacitor-updater, Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für das Implementierungsdetail in Capacitor Plugins von Capgo, Plugins hinzufügen oder aktualisieren für das Implementierungsdetail beim Hinzufügen oder Aktualisieren von Plugins, und Ionic Enterprise Plugin-Alternativen für den Produkt-Workflow bei den Ionic Enterprise Plugin-Alternativen.
Capacitor Apps deployen ohne Wartezeit
Baue mit deinem AI Coding Agent, deploye Fixes in Minuten, erstelle iOS- und Android-Builds ohne Mac und beobachte jedes Release.
Enterprise-Anforderungen? Sprich mit unserem Team