Troubleshooting

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-Überprüfungen und maßgeschneiderte Lösungen, die auf Ihre spezifischen Bedürfnisse zugeschnitten sind.

Professionelle Unterstützung erhalten

Upload-Fehler

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

• Ihre App-ID in capacitor.config.ts passt Ihrer App im Capgo-Dashboard
• Sie führen den Upload-Befehl von der Wurzel 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 Uploads von großen Bundles oder bei schlechten Netzwerkverbindungen. Wenn Ihr Bundle über 10 MB ist oder Sie auf einer spotty Verbindung sind, sollten Sie sich überlegen, --tus:

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

• --package-json und --node-modules: Erzählt Capgo , wo er deine Wurzel finden soll package.json und node_modules wenn deine App eine nicht standardmäßige Struktur wie ein Monorepo oder npm Workspace verwendet. Gib den Pfad zur Wurzel an 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 deine App-Abhängigkeiten korrekt zu verpacken.

Du kannst diese Flags mit anderen Optionen kombinieren wie --channel sofern nötig. Siehe die Capgo CLI Dokumentation für weitere Details zu den verfügbaren Uploadoptionen.

Wenn Sie mit den Uploads weiterhin Schwierigkeiten 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 Fehlerbehebung. Um ihn zu verwenden:

1. Führen Sie in Ihrem Projektverzeichnis den folgenden Befehl 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 ein Update auslösen sollte (z.B. das Wiederherstellen der App nach dem Hochladen eines neuen Bundles).

3. Beachten Sie die Ausgabe des Debug-Befehls. Sie wird Informationen über den Updateprozess anzeigt, einschließlich:

   • When die App nach einer Aktualisierung sucht
   • Wenn eine Aktualisierung gefunden wird und welche Version sie ist
   • Herunterladen und Installationsfortschritt für die Aktualisierung
   • Jeder Fehler, der während des Aktualisierungsprozesses auftritt

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

   • Wenn keine Aktualisierung gefunden wird, überprüfen Sie doppelt, ob Ihr Bundle erfolgreich hochgeladen wurde und die App auf den richtigen Kanal eingestellt ist.
   • Wenn die Aktualisierung 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 ein Fehlermeldung sehen, suchen Sie nach der spezifischen Fehlermeldung in den Capgo Dokumenten oder wenden Sie sich an den Support, um Hilfe zu erhalten.

Der Debug-Befehl ist besonders nützlich, um Probleme mit dem Herunterladen und Installieren der Aktualisierung zu identifizieren. Wenn die Protokolle zeigen, dass die erwartete Aktualisierungsversion gefunden wurde, aber letztendlich nicht angewendet wurde, konzentrieren Sie sich auf die Schritte nach dem Download.

Debugging mit Native Logs

Zusätzlich zur Capgo-Debug-Kommandozeile können die native Logs auf Android, iOS und Electron wertvolle Informationen für die Fehlerbehebung liefern, insbesondere für Probleme auf der native Seite des Update-Prozesses.

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 Ihre App-Prozess, indem Sie es aus der Dropdown-Liste oben auswählen
4. Suchen Sie nach Zeilen, die Capgo um die SDK-Logs zu finden

Alternativ können Sie das adb logcat Kommando und grep für Capgo verwenden, um die Logs 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 installiert wird
• Bei Fehlern, die während der native Aktualisierungsstufen auftreten

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

• Netzwerkverbindungsprobleme, die den Download der Aktualisierung verhindern
• Dateiberechtigungsfehler, wenn die Aktualisierungsbundle gespeichert oder gelesen wird
• Ausreichend Speicherplatz für die Aktualisierungsbundle
• Fehler beim Neustart der App nach der Installation der Aktualisierung

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 “Offene Konsole”
4. In der Konsole-Ausgabe 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 Capgo filtern, um die Protokolle zu filtern.

Ähnlich wie bei Android werden die Capgo SDK-Protokolle wichtige iOS-seitige Ereignisse protokollieren:

• Initiierung und Ergebnis der Aktualisierungskontrolle
• Herunterladen starten, Fortschritt und Abschluss
• Installation auslösen und Ergebnis
• Jegliche Fehler während des nativen Update-Prozesses

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

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

Elektron-Protokolle

Für Electron-Apps überprüfen Sie sowohl den Hauptprozess als auch den Renderer-Prozess-Ausgabe:

1. Führen Sie das Electron-App aus Ihrer Terminal-Session aus, indem Sie Ihren normalen Start-Befehl ausführen (z.B.) bun run electron:dev oder bun run electron:serve) und beobachten Sie die Terminalausgabe für Start, Aktualisierungskontrollen und Netzwerkfehler.
2. Öffnen Sie die Entwicklerwerkzeuge im Renderer-Fenster (Ansicht → Toggle-Entwicklerwerkzeuge aktivieren) und überprüfen Sie die Konsole-Protokolle und fehlgeschlagene Netzwerkanforderungen, während Sie den Update-Flow reproduzieren.
3. Für verpackte Apps überprüfen Sie die Werkzeuge für OS-Protokolle für Crashs oder Startfehler:
   • macOS: öffnen Sie Console.app und filtern Sie nach Ihrem App-Namen
   • Windows: öffnen Sie Ereignisprotokolle → Windows-Protokolle → Anwendung
   • Linux: verwenden Sie Ihren Desktop-Log-Viewer oder journalctl für Ihr Anwendungsprozess

Wenn Sie beim Debuggen 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 insbesondere nützlich, um Probleme zu identifizieren, die außerhalb der Capgo JavaScript-Schicht 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 zu erfassen, 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 CapacitorUpdater.notifyAppReady() in Ihrer Anwendung code wie im Quickstart gezeigt
• Stellen Sie sicher, dass Ihr Gerät an das Internet angeschlossen ist und die Capgo-Fehlerprotokolle zeigen, dass die Aktualisierung heruntergeladen wurde
• Versuchen Sie, das Programm vollständig zu schließen und neu zu starten, da Updates nur bei einem frischen Start angewendet werden
• Suchen Sie nach Fehlern in den native Logs, die auf ein Problem bei der Anwendung der Aktualisierung hindeuten könnten

Zur Referenz: Lebendliche Updates bereitstellen Zur weiteren Information zum Update-Prozess, wenden Sie sich an die npx @capgo/cli@latest app debug Befehl und native Logs verwenden, um mehr Einblicke in das Geschehen zu erhalten

Häufige Fehlercodes bei Updates

Wenn Ihre Protokolle Backend-Fehler wie "", oder "" anzeigen, wenden Sie sich an die spezielle Anleitung: disable_auto_update_to_major, semver_errorLebendliche Updates bereitstellen cannot_update_via_private_channelBefehl und native Logs verwenden, um mehr Einblicke in das Geschehen zu erhalten

• Common Update Probleme

Es erklärt, was jede häufige code bedeutet, warum sie passiert und wie man sie behebt.

SDK Installation

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

• Ihr App verwendet eine unterstützte Version von Capacitor (4.0 oder neuer)
• Sie haben die "quickstart"-Schritte in der richtigen Reihenfolge befolgt, einschließlich des Synchronisierens Ihrer App nach der Installation des __CAPGO_KEEP_0__ CI/CD-Integration steps in order, including syncing your app after installing the SDK

Bei Problemen mit der Auslösung von __CAPGO_KEEP_0__-Uploads aus Ihrem CI/CD-Pipeline:

Bei Problemen mit 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.

Weitergehen von der Fehlerbehebung

Wenn Sie Fehlerbehebung zur Planung von Speicher und Dateimanagement verwenden, verbinden Sie es mit @capgo/capacitor-Speicherdatenbank-SQLite für die Implementierungsdetails in @capgo/capacitor-Speicherdatenbank-SQLite, Mit @capgo/capacitor-Speicherdatenbank-SQLite für die native Fähigkeit in Mit @capgo/capacitor-Speicherdatenbank-SQLite, @capgo/capacitor-Datei für die Implementierungsdetails in @capgo/capacitor-Datei, Mit @capgo/capacitor-Datei für die native Fähigkeit in Mit @capgo/capacitor-Datei, und @capgo/capacitor-Uploader für die Implementierungsdetails in @capgo/capacitor-Uploader.