Troubleshooting

Hier sind einige häufige Probleme, die Sie beim Einsatz 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:

• Die App-ID in capacitor.config.ts stimmt mit Ihrer App im Capgo-Dashboard überein
• Sie führen den Upload-Befehl vom Root-Verzeichnis Ihres Capacitor-Projekts aus
• Deine Web-Assets sind gebaut und auf dem neuesten Stand.

Erweiterte Upload-Optionen

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

• --tus: Verwendet das TUS-Resumable-Upload-Protokoll zur zuverlässigeren Übertragung großer Pakete oder bei schlechten Netzwerkverbindungen. Wenn dein Paket über 10 MB ist oder du auf einer unzuverlässigen Verbindung bist, solltest du --tus:

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

• --package-json und --node-modules: Sagt Capgo an, wo du deine Wurzel package.json und node_modules Wenn Ihre App eine nicht standardmäßige Struktur wie ein Monorepo oder ein npm Workspace verwendet. package.json und das --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 Ihre App-Abhängigkeiten korrekt zu bündeln.

Sie können diese Flags mit anderen Optionen kombinieren, wie z.B. --channel sofern erforderlich. Siehe die Capgo CLI Dokumentation für weitere Details 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 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 Update-Prozess anzeigt, einschließlich:

   • Wenn die App nach einem Update sucht
   • Wenn ein Update gefunden wird und welche Version es ist
   • Download- und Installationsfortschritt für das Update
   • 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.

Die Debug-Kommandozeile ist besonders nützlich, um Probleme mit dem Download und der Installation 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.

Fehlersuche mit Native Logs

Zusätzlich zur Capgo Debug-Kommandozeile können die native Protokolle auf Android, iOS und Electron wertvolle Informationen für die Fehlersuche bereitstellen, insbesondere für Probleme auf der native Seite des Aktualisierungsprozesses.

Android-Protokolle

Um auf die Android-Protokolle 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 Protokolle auf nur Ihren Anwendungsprozess, indem Sie es aus der Dropdown-Liste oben auswählen
4. Suchen Sie nach Zeilen, die enthalten Capgo um die SDK-Protokolle zu finden

Alternativ können Sie den Befehl verwenden und grep für adb logcat um die Protokolle zu filtern. Capgo Die __CAPGO_KEEP_0__ __CAPGO_KEEP_1__-Protokolle werden während des Update-Prozesses wichtige Ereignisse wie z.B.

The Capgo SDK will log key events during the update process, such as:

• Wenn ein Update gefunden wird und welche Version es ist
• If an update is found and what version it is
• Wenn der Update-Download beginnt und abgeschlossen ist
• Wenn die Update-Installation ausgelöst wird
• Jeder Fehler, der während der native Update-Schritte auftritt

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

• Netzwerkverbindungsprobleme, die den Update-Download verhindern
• Dateisicherheitsfehler, wenn das Update-Paket gespeichert oder gelesen wird
• Ausreichend Speicherplatz für das Update-Paket
• Fehlschlag beim Neustarten der App nach dem Update-Installieren

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 ‘Console öffnen’
4. Im Konsolenoutput suchen Sie nach Zeilen, die ‘__CAPGO_KEEP_0__’ enthalten Capgo Um die SDK-Protokolle zu finden

Sie können auch den log stream Kommando in der Terminal-Anwendung und grep für Capgo um die Protokolle zu filtern

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

• Initiierung und Ergebnis der Aktualisierungskontrolle
• Start, Fortschritt und Abschluss des Herunterladens
• Auslösen und Ergebnis der Installation
• Jegliche Fehler während des nativen Aktualisierungsprozesses

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

• SSL-Zertifikatsprobleme beim Download der Aktualisierung
• App-Transport-Sicherheit blockiert den Download der Aktualisierung
• Unzureichender Speicherplatz für die Aktualisierungsdatei
• Fehler beim Extrahieren oder Anwenden der Aktualisierungsdatei

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 in Ihrem Terminal mit Ihrem normalen Startbefehl aus (z. B. bun run electron:dev oder bun run electron:serveund 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 fehlgeschlagene Netzwerkanfragen, während Sie die Aktualisierungsablauf wiederholen.
3. Für verpackte Apps überprüfen Sie die Werkzeuge für die OS-Protokolle auf Crashes oder Startfehler:
   • macOS: öffnen Console.app und filtern Sie nach Ihrem App-Namen
   • Windows: öffnen Ereignis-Verwaltungskonsole → Windows-Protokolle → Anwendung
   • Linux: verwenden Sie Ihren Desktop-Protokollanzeiger oder journalctl für Ihren App-Prozess

Wenn Sie bei der Überprüfung von Updates Probleme haben, vergleichen Sie die Nachrichten aus den Protokollen des Hauptprozesses und des Renderer-Prozesses, um die Electron-Initialisierungsprobleme von den Capgo Update-Lebenszyklusproblemen zu trennen.

Über alle Plattformen hinweg bieten die native Protokolle einen tieferen Einblick 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-Layers 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 in Ihrer App __CAPGO_KEEP_0__ aufgerufen haben, wie im CapacitorUpdater.notifyAppReady() in your app code as shown in the Überprüfen Sie, ob Ihr Gerät mit dem Internet verbunden ist und die __CAPGO_KEEP_0__ Debug-Protokolle zeigen, dass das Update heruntergeladen wurde.
• Check that your device is connected to the internet and the Capgo debug logs show the update was downloaded
• Suchen Sie nach Fehlern in den native Protokollen, die darauf hindeuten könnten, dass das Update nicht angewendet werden kann.
• Sicherstellen Sie, dass Sie in Ihrer App __CAPGO_KEEP_0__ aufgerufen haben, wie im

Beziehen Sie sich auf das live-Updates bereitstellen Leitfaden für weitere Informationen zum Update-Prozess. Wenn Sie immer noch Probleme haben, verwenden Sie die npx @capgo/cli@latest app debug Befehl und native Protokolle, um mehr Einblicke in das Geschehen zu erhalten.

Gemeinsame Update-Fehlerrichtlinien

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

• Gemeinsame Update-Probleme

Es erklärt, was jede gemeinsame code bedeutet, warum es passiert und wie Sie es beheben können.

SDK-Installation

Wenn Sie Schwierigkeiten beim Installieren der Capgo SDK haben, stellen Sie sicher:

• Überprüfen Sie, ob Ihre App eine unterstützte Version von Capacitor verwendet (4.0 oder neuer)
• Sie haben die Schritte der Schnellstartanleitung befolgt, einschließlich der Synchronisierung Ihrer App nach der Installation von __CAPGO_KEEP_0__ Quickstart steps in order, including syncing your app after installing the SDK

__CAPGO_KEEP_0__-Integration

Überprüfen Sie, ob Ihr Capgo-Authentifizierungstoken korrekt eingerichtet ist

• Double check your Capgo authentication token is set up correctly
• Überprüfen Sie, ob der Upload-Befehl den richtigen Kanalnamen für Ihre Zielumgebung verwendet
• __CAPGO_KEEP_0__-Installation

Betrachte die CI/CD-Integration Dokumentation für weitere Tipps zum Fehlerbehebung. npx @capgo/cli@latest app debug Sie können auch die

Befehl

Wenn Sie Fehlerbehebung zur Planung der Speicherung und Datei-Verwaltung, verbinden Sie es mit @capgo/capacitor-data-storage-sqlite für die Implementierungsdetails in @capgo/capacitor-data-storage-sqlite Mit @capgo/capacitor-data-storage-sqlite Für die native Fähigkeit in Using @capgo/capacitor-data-storage-sqlite, @capgo/capacitor-datei Für die Implementierungsdetail in @capgo/capacitor-file, Using @capgo/capacitor-file Für die native Fähigkeit in Using @capgo/capacitor-file und @capgo/capacitor-hochloader for the implementation detail in @capgo/capacitor-uploader.