Fehlerbehebung

Hier sind einige häufige Probleme, die Sie bei der Verwendung von Capgo erleben 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 bei 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 bei einer unzuverlässigen Verbindung sind, sollten Sie überlegen, --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 npm Workspace verwendet. Geben Sie den Pfad zum Wurzelverzeichnis package.json und --node_modules den

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

  Capgo needs this information to correctly bundle your app’s dependencies.

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

Wenn Sie Probleme mit Live-Updates haben, ist der Capgo Debug-Befehl ein hilfreiches Werkzeug zur Fehlersuche. Um ihn zu verwenden:

1. Führen Sie den folgenden Befehl in Ihrem Projektverzeichnis aus:

   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 das 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 Fehlermeldung, die während des Update-Prozesses auftritt

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

   • Wenn kein Update gefunden wird, überprüfen Sie doppelt, ob Ihr Bundle erfolgreich hochgeladen wurde und 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 neu 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.

The debug command is especially useful for identifying issues with the update download and installation process. If the logs show the expected update version was found but not ultimately applied, focus your troubleshooting on the steps after the download.

Debugging with Native Logs

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

Android Logs

Um auf die Android-Logs zuzugreifen:

1. Verbinden Sie Ihr Gerät oder starten Sie Ihren Emulator
2. Öffnen Sie Android Studio und wählen Sie "Ansicht > Werkzeuge > Logcat"
3. In der Logcat-Fenster filtern Sie die Logs nur auf Ihr Anwendungsprozess, indem Sie es aus dem Dropdown-Menü oben auswählen
4. Suchen Sie nach Zeilen, die enthalten Capgo um die SDK-Logs zu finden

Alternativ können Sie adb logcat den Befehl und grep nach 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 Aktualisierung ausgelöst wird
• Jeder Fehler, der während der native Aktualisierungsstufen auftritt

Gemeinsame Android-spezifische Probleme, die Sie in den Protokollen sehen könnten

• Netzwerkverbindungsprobleme, die den Download der Aktualisierung verhindern
• Dateiberechtigungsfehler, wenn die Aktualisierungsbundle 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 “Fenster > Geräte und Simulator”
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 Um die Protokolle zu filtern.

Ähnlich wie bei Android, wird die 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 während des nativen Updates

iOS-spezifische Probleme, die Sie in den Protokollen identifizieren können:

• SSL-Zertifikatsprobleme beim Download des Updates
• App-Transport-Sicherheit blockiert den Download des Updates
• Unzureichender Speicherplatz für das Updatepaket
• Fehler beim richtigen Extrahieren oder Anwenden des Updatepaketes

Elektron-Protokolle

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

1. Führen Sie das Electron-App aus Ihrem Terminal aus, indem Sie Ihren normalen Startbefehl verwenden (z. B. bun run electron:dev oder bun run electron:serve) und beobachten Sie die Terminalausgabe für Startvorgänge, Aktualisierungsprüfungen und Netzwerkfehler.
2. Öffnen Sie die Entwicklerwerkzeuge im Renderer-Fenster (Ansicht → Toggle-Entwicklerwerkzeuge aktivieren) und überprüfen Sie die Konsoleprotokolle und fehlgeschlagenen Netzwerkanfragen, während Sie den Update-Flow reproduzieren.
3. Für verpackte Apps überprüfen Sie die OS-Log-Tools für Crashs oder Startfehler:
   • macOS: Öffnen Sieund filtern Sie nach Ihrem Anwendungsnamen Console.app Windows: Öffnen Sie
   • und filtern Sie nach Ihrem AnwendungsnamenWindows: Öffnen Sie Event 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 Hauptprozess- und Renderer-Prozess-Protokollen, um Electron-Bootstrap-Probleme von Capgo-Update-Lebenszyklus-Problemen zu trennen.

Über Plattformen hinweg bieten die native Protokolle einen tieferen Blick 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 ein schwieriges Live-Update-Problem lösen müssen, ist es eine gute Idee, sowohl die Capgo-Debug-Protokolle als auch die native Protokolle aufzunehmen, um ein umfassendes Bild davon zu erhalten, was passiert. Die beiden Protokolle zusammen geben Ihnen die beste Chance, 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 CapacitorUpdater.notifyAppReady() Sicherstellen, dass Ihr Gerät an das Internet angeschlossen ist und die code-Debug-Protokolle anzeigen, dass die Aktualisierung heruntergeladen wurde quickstart
• Überprüfen Sie, ob Ihr Gerät an das Internet angeschlossen ist und die Capgo-Debug-Protokolle anzeigen, dass die Aktualisierung heruntergeladen wurde
• Versuchen Sie, die App vollständig zu schließen und neu zu öffnen, 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 Aktualisierungsanwendung hinweisen

Referenz zu live Updates deployen Weitere Informationen zum Aktualisierungsprozess finden Sie im npx @capgo/cli@latest app debug deploying live updates

guide. Wenn Sie weiterhin Probleme haben, verwenden Sie die

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 man es behebt.

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 in der richtigen Reihenfolge befolgt, einschließlich des Synchronisierens Ihrer App nach der Installation des 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 dem Aufbau 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 zum Problembehandeln. 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.

Weiter zum Problembehandeln

Wenn Sie diese Funktion verwenden Fehlerbehebung um die Speicherung und Dateimanagement zu planen, verbinden Sie es mit @capgo/capacitor-Speicherung von Daten in SQLite für die Implementierungsdetails in @capgo/capacitor-Speicherung von Daten in SQLite Verwendung von @capgo/capacitor-Speicherung von Daten in SQLite für die native Fähigkeit in Verwendung von @capgo/capacitor-Speicherung von Daten in SQLite @capgo/capacitor-Datei für die Implementierungsdetails in @capgo/capacitor-Datei Verwendung von @capgo/capacitor-Datei für die native Fähigkeit in Verwendung von @capgo/capacitor-Datei und @capgo/capacitor-Uploader für die Implementierungsdetails in @capgo/capacitor-Uploader.