Fehlersuche

Hier sind einige häufige Probleme, die Sie bei der Verwendung von Capgo begegnen können und wie Sie sie lösen können.

🚀 Bedarf an Experten-Hilfe?

Stecken Sie mit einem komplexen Problem? Unser Experte-Team ist hier, um Ihnen zu helfen! Erhalten Sie personalisierte Unterstützung, code-Bewertungen und maßgeschneiderte Lösungen, die auf Ihre spezifischen Bedürfnisse zugeschnitten sind.

Professionelle Unterstützung erhalten

Uploadfehler

Wenn Ihr Bundle-Upload fehlschlägt, überprüfen Sie bitte:

• Ihre App-ID in capacitor.config.ts passt zu Ihrer App im Capgo-Dashboard
• Sie führen den Upload-Befehl vom Root Ihres Capacitor-Projekts aus
• Ihre Web-Assets sind gebaut und auf dem neuesten Stand

Erweiterte Upload-Optionen

Das Capgo CLI bietet einige zusätzliche Flags, um häufigen Upload-Problemen zu helfen:

• --tusVerwendet das tus-Resumable-Upload-Protokoll für zuverlässigere Hochladungen großer Pakete oder bei schlechten Netzwerkverbindungen. Wenn Ihr Paket über 10 MB ist oder Sie auf einer unzuverlässigen Verbindung sind, sollten Sie über die Verwendung von --tus:

  npx @capgo/cli@latest bundle upload --tus

• --package-json und --node-modules: Erzählt Capgo, wo er das Wurzelverzeichnis finden soll package.json und node_modules wenn Ihre App eine nicht standardmäßige Struktur wie ein Monorepo oder ein npm-Arbeitsverzeichnis verwendet. Geben Sie den Pfad zum Wurzelverzeichnis package.json und den --node_modules Pfad:

  npx @capgo/cli@latest bundle upload --package-json=path/to/package.json --node_modules=path/to/node_modules

  Capgo benötigt diese Informationen, um die Abhängigkeiten Ihres Apps korrekt zu packen.

Sie können diese Flags mit anderen Optionen kombinieren wie --channel wenn nötig. Siehe die Capgo CLI Dokumentation für detaillierte Informationen zu den verfügbaren Upload-Optionen.

Wenn Sie weiterhin Probleme mit den Uploads haben, wenden Sie sich an Capgo Support für weitere Unterstützung.

Fehlersuche bei Updates

If you’re encountering issues with live updates, the Capgo debug command is a helpful tool for troubleshooting. To use it:

1. __CAPGO_KEEP_0__ Debug-Kommando ein hilfreiches Werkzeug zur Fehlerbehebung. Um es zu verwenden:

   npx @capgo/cli@latest app debug

2. Starten Sie Ihre App auf einem Gerät oder einem Emulator und führen Sie die Aktion durch, die ein Update auslösen sollte (z.B. das Wiedereröffnen der App nach dem Hochladen eines neuen Bundles).

3. Beachten Sie die Ausgabe der Debug-Kommandozeile. Sie wird Informationen über den Update-Prozess anliefern, einschließlich:

   • Wenn die App nach einem Update sucht
   • Wenn ein Update gefunden wird und welche Version es ist
   • Herunterladen und Installationsfortschritt für das Update
   • Jede während des Update-Prozesses auftretende Fehlermeldung

4. Verwenden Sie die Debug-Protokolle, um zu bestimmen, wo das Problem auftritt. Zum Beispiel:

   • Wenn kein Update gefunden wird, überprüfen Sie, ob Ihr Bundle erfolgreich hochgeladen wurde und ob die App auf den richtigen Kanal eingestellt ist.
   • Wenn das Update heruntergeladen wird, aber nicht installiert wird, stellen Sie sicher, dass Sie CapacitorUpdater.notifyAppReady() und dass die App vollständig geschlossen und wieder geöffnet wurde.
   • Wenn Sie eine Fehlermeldung sehen, suchen Sie nach der spezifischen Fehlermeldung in den Capgo-Dokumentationen oder wenden Sie sich an den Support, um Hilfe zu erhalten.

Die Debug-Kommandozeile ist besonders nützlich, um Probleme mit dem Update-Download- und -Installationsprozess zu identifizieren. Wenn die Protokolle zeigen, dass die erwartete Updateversion gefunden wurde, aber letztendlich nicht angewendet wurde, konzentrieren Sie sich bei der Fehlerbehebung auf die Schritte nach dem Download.

Fehlersuche mit Native Logs

In addition to the Capgo debug command, the native logs on Android, iOS, and Electron can provide valuable troubleshooting information, especially for issues on the native side of the update process.

Abschnitt mit dem Titel “Fehlersuche mit Android-Protokollen”

Verbinden Sie Ihr Gerät oder starten Sie Ihren Emulator

1. Öffnen Sie Android Studio und wählen Sie “Ansicht > Werkzeuge > Logcat”
2. In der Logcat-Fenster filtern Sie die Protokolle auf nur Ihr Anwendungsprozess, indem Sie es aus dem Dropdown-Menü oben auswählen
3. Suchen Sie nach Zeilen, die enthalten
4. um die __CAPGO_KEEP_0__-Protokolle zu finden Capgo to find the SDK logs

Alternativ können Sie das adb logcat Befehl und grep für Capgo um die Protokolle zu filtern.

Die Capgo SDK werden während des Aktualisierungsprozesses wichtige Ereignisse protokollieren, wie z.B.:

• Wenn eine Aktualisierungsprüfung initiiert wird
• Wenn eine Aktualisierung gefunden wird und welche Version sie ist
• Wenn der Download der Aktualisierung beginnt und abgeschlossen ist
• Wenn die Aktualisierungstriggerung ausgelöst wird
• Jegliche Fehler, die während der native Aktualisierungs-Schritte auftreten

Häufige Android-spezifische Probleme, die Sie in den Protokollen sehen könnten, umfassen:

• Netzwerkverbindungsprobleme, die den Download der Aktualisierung verhindern
• Dateisicherheitsfehler, wenn die Aktualisierungsdatei gespeichert oder gelesen wird
• Speicherplatz für das Updatepaket fehlt
• Fehler beim Neustart der App nach der Installation des Updates

iOS-Protokolle

Um auf die iOS-Protokolle zuzugreifen:

1. Verbinden Sie Ihr Gerät oder starten Sie Ihren Simulator
2. Öffnen Sie Xcode und gehen Sie zu “Window > Devices and Simulators”
3. Wählen Sie Ihr Gerät und klicken Sie auf “Open Console”
4. In der Konsoleausgabe suchen Sie nach Zeilen, die Capgo um die SDK-Protokolle zu finden

Sie können auch den log stream Befehl im Terminal ausführen und mit grep nach suchen Capgo die Protokolle zu filtern.

Ähnlich wie bei Android, wird das Capgo SDK wichtige iOS-seitige Ereignisse protokollieren:

• Initiierung und Ergebnis der Überprüfung auf Updates
• Start, Fortschritt und Abschluss des Downloads
• Auslöser und Ergebnis der Installation
• Jeder Fehler, der während des nativen Updates vorkommt

Bei den Protokollen können Sie möglicherweise folgende iOS-spezifische Probleme identifizieren:

• SSL-Zertifikatsprobleme beim Download des Updates
• App-Transport-Sicherheit blockiert den Download des Updates
• Unzureichender Speicherplatz für das Update-Paket
• Fehler beim ordnungsgemäßen Entpacken oder Anwenden des Update-Pakets

Elektron-Protokolle

Für Electron-Anwendungen überprüfen Sie sowohl die Ausgabe des Hauptprozesses als auch des Renderer-Prozesses:

1. Führen Sie das Electron-Programm aus Ihrer Terminal-Anwendung aus, indem Sie Ihren normalen Startbefehl verwenden (z. B. bun run electron:dev oder bun run electron:serve) und beobachten Sie die Terminal-Ausgabe für den Start, die Aktualisierungsprüfungen und Netzwerkfehler.
2. Öffnen Sie die Entwicklerwerkzeuge im Renderer-Fenster (Ansicht → Toggle-Entwicklerwerkzeuge aktivieren) und überprüfen Sie die Konsole-Protokolle und fehlgeschlagene Netzwerkanfragen, während Sie den Update-Flow reproduzieren.
3. Für verpackte Anwendungen überprüfen Sie die Werkzeuge für die Betriebssystem-Protokolle auf Crashs oder Startfehler:
   • macOS: Öffnen Sieund filtern Sie nach Ihrem Anwendungsnamen Console.app Windows: Öffnen Sie
   • und filtern Sie nach Ihrem Anwendungsnamenund filtern Sie nach Ihrem Anwendungsnamen Ereignis-Viewer → Windows-Protokolle → Anwendung
   • Linux: Verwenden Sie Ihren Desktop-Protokollanzeiger oder journalctl für Ihr Anwendungsprozess

Wenn Sie bei der Debugging von Updates vergleichen, Nachrichten aus beiden Haupt-Prozess- und Renderer-Prozess-Protokollen, um Electron-Bootstrap-Probleme von Capgo-Update-Lebenszyklus-Problemen zu trennen.

Über Plattformen hinweg bieten die native Protokolle einen niedrigeren Ebenenblick in den Update-Prozess, mit mehr Details über die native Implementierung. Sie sind besonders nützlich, um Probleme zu identifizieren, die außerhalb des Capgo-JavaScript-Schichts auftreten.

Wenn Sie bei der Behebung eines schwierigen Live-Update-Problems vorsichtig sind, ist es eine gute Idee, sowohl die Capgo-Debug-Protokolle als auch die native Protokolle für ein umfassendes Bild von dem, was passiert, zu speichern. Die beiden Protokolle zusammen werden Ihnen den besten Chance geben, das Problem zu identifizieren und zu lösen.

Updates werden nicht angewendet

Wenn Sie ein Bundle hochgeladen haben, aber die Änderungen auf Ihrem Gerät nicht sehen:

• Stellen Sie sicher, dass Sie __CAPGO_KEEP_0__ in Ihrer App aufgerufen haben, wie im Quickstart beschrieben. CapacitorUpdater.notifyAppReady() Überprüfen Sie in Ihrer App, ob code korrekt konfiguriert ist. Quickstart
• Stellen Sie sicher, dass Ihr Gerät an das Internet angeschlossen ist und die Capgo-Debug-Protokolle zeigen, dass die Aktualisierung heruntergeladen wurde.
• Versuchen Sie, die App vollständig zu schließen und neu zu starten, da Updates nur bei einer frischen Startphase angewendet werden.
• Suchen Sie nach Fehlern in den native Logs, die möglicherweise auf ein Problem bei der Anwendung der Aktualisierung hinweisen.

Ziehen Sie sich an die Anleitung zum "Live-Update-Deployen" für weitere Details zum Aktualisierungsprozess. Wenn Sie weiterhin Probleme haben, verwenden Sie die Kommandozeilen- und native Logs, um mehr Einblicke in das Geschehen zu erhalten. Häufige Fehlercodes beim Aktualisieren Häufige Fehlercodes beim Aktualisieren npx @capgo/cli@latest app debug Häufige Fehlercodes beim Aktualisieren

Häufige Fehlercodes beim Aktualisieren

Wenn Ihre Protokolle Backend-Fehler wie disable_auto_update_to_major, semver_error, oder cannot_update_via_private_channel, anzeigen, verwenden Sie die spezielle Anleitung:

• Gemeinsame Update-Probleme

Es erklärt, was jeder häufige code bedeutet, warum es passiert und wie Sie es beheben können.

SDK Installation

Wenn Sie Schwierigkeiten haben, das Capgo SDK zu installieren, stellen Sie sicher:

• Ihre App verwendet eine unterstützte Version von Capacitor (4.0 oder neuer)
• Sie haben die Schritte im Quickstart-Handbuch in der richtigen Reihenfolge befolgt, einschließlich des Synchronisierens Ihrer App nach der Installation des __CAPGO_KEEP_0__ Your app is using a supported version of __CAPGO_KEEP_0__ (4.0 or newer) You’ve followed the "quickstart" steps in order, including syncing your app after installing the SDK

CI/CD-Integration

Für Probleme bei der Auslösung von Capgo-Uploads aus Ihrem CI/CD-Pipeline:

• Überprüfen Sie, ob Ihr Capgo-Authentifizierungstoken korrekt eingerichtet ist
• Stellen Sie sicher, dass Sie den Upload-Befehl nach der Erstellung Ihrer Web-Assets ausführen
• Überprüfen Sie, ob der Upload-Befehl den richtigen Kanalnamen für Ihre Zielumgebung verwendet

Siehe die CI/CD-Integration Dokumentation für weitere Tipps zur Fehlerbehebung. Sie können auch den npx @capgo/cli@latest app debug Befehl verwenden, um zu bestätigen, ob Ihre CI/CD-gesteuerten Updates vom App erhalten werden