Troubleshooting

Eine Liste mit häufigen Problemen, die Sie beim Einsatz von Capgo begegnen können und wie Sie sie lösen.

🚀 Bedarf Experten-Hilfe?

Stecken Sie mit einem komplexen Problem? Unsere Expertenteam steht Ihnen zur Verfügung! 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:

• Ob Ihr App-ID in __CAPGO_KEEP_0__ mit Ihrer App im __CAPGO_KEEP_0__-Dashboard übereinstimmt capacitor.config.ts Ob Sie den Upload-Befehl vom Root-Verzeichnis Ihres Capgo-Projekts aus ausführen
• Ihre App-ID in Capacitor mit Ihrer App im Capacitor-Dashboard übereinstimmt
• Seine 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 sicheren Übertragung großer Pakete oder bei schlechten Netzwerkverbindungen. Wenn Ihr Paket über 10 MB ist oder Sie auf einer schlechten Verbindung sind, sollten Sie --tus:

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

• --package-json und --node-modules: Weist Capgo an, wo es seine Wurzel package.json und node_modules Wenn Ihre App eine nicht standardmäßige Struktur wie ein Monorepo oder npm Workspace verwendet. Geben Sie den Pfad zur Wurzel an 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 --channel wie 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
   • Herunterladen- und Installationsfortschritt für das Update
   • Jeder Fehler, der 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 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 Update-Download- und -Installationsprozess zu identifizieren. Wenn die Protokolle zeigen, dass die erwartete Update-Version gefunden wurde, aber letztendlich nicht angewendet wurde, konzentrieren Sie sich auf die Schritte nach dem Download.

Fehlersuche mit Native Logs

Zusätzlich zum Capgo-Debug-Befehl können die native Logs auf Android, iOS und Electron wertvolle Informationen für die Fehlersuche bereitstellen, insbesondere für Probleme auf der native Seite des Update-Prozesses.

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 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-Protokolle zu finden

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

Die Capgo SDK-Protokolle werden während des Update-Prozesses wichtige Ereignisse wie z.B.

• wenn ein Update-Check initiiert wird
• wenn ein Update gefunden wird und welche Version es ist
• Wenn der Update-Download startet 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
• Mangel an Speicherplatz für das Update-Paket
• Fehlschlag beim Neustart 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 Ausgabe-Bereich der Konsole suchen Sie nach Zeilen, die enthalten Capgo um die SDK-Protokolle zu finden

Sie können auch den log stream Kommandozeilen-Befehl im Terminal verwenden und grep für Capgo um die Protokolle zu filtern.

Ähnlich wie bei Android, werden die Capgo SDK-Protokolle wichtige Ereignisse auf iOS-Seite protokolieren:

• Initiierung und Ergebnis der Aktualisierungskontrolle
• Start, Fortschritt und Abschluss des Downloads
• 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 Herunterladen der Aktualisierung
• App-Transport-Sicherheit blockiert die Aktualisierungsherunterladen
• Unzureichender Speicherplatz für die Aktualisierungsdatei
• Fehlschlag bei der richtigen Extraktion oder Anwendung der Aktualisierungsdatei

Elektron-Protokolle

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

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 den Start, Aktualisierungsprüfungen und Netzwerkfehler.
2. Öffnen Sie die Entwicklerwerkzeuge im Renderer-Fenster (Ansicht → Toggle-Entwicklerwerkzeuge) und überprüfen Sie die Konsoleprotokolle und fehlgeschlagene Netzwerkanfragen während der Wiederholung des Aktualisierungsflusses.
3. Für verpackte Apps überprüfen Sie die Werkzeuge für die Betriebssystem-Protokolle auf Crashes oder Startfehler:
   • macOS: öffnen Console.app und filtern Sie nach Ihrem App-Namen
   • Windows: öffnen Ereignis-Protokoll → Windows-Protokolle → Anwendung
   • Linux: verwenden Sie Ihren Desktop-Protokoll-Viewer oder journalctl für Ihr App-Prozess

When Sie bei der Überprüfung von Updates debuggen, vergleichen Sie die Nachrichten aus den Protokollen des Hauptprozesses und des Renderer-Prozesses, um die Electron-Bootstrap-Probleme von den Capgo-Update-Lebenszyklus-Problemen 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 insbesondere nützlich, um Probleme zu identifizieren, die außerhalb des Capgo-JavaScript-Schichts auftreten.

Wenn Sie ein schwieriges Live-Update-Problem lösen möchten, ist es eine gute Idee, sowohl die Capgo-Debug-Protokolle als auch die native Protokolle zu speichern, 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
• Updates werden nicht angewendet

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

Gemeinsame Update-Fehlerrichtlinien

Wenn Ihre Logs Backend-Fehler wie disable_auto_update_to_major, semver_error, oder cannot_update_via_private_channel, anzeigen, verwenden Sie die zugehörige Anleitung:

• Gemeinsame Update-Probleme

Sie erklärt, was jede häufige code bedeutet, warum sie auftritt und wie sie gelöst werden kann.

SDK Installation

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

• Überprüfen Sie, ob Ihr 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__ CI/CD-Integration steps in order, including syncing your app after installing the SDK

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

For issues with triggering Capgo uploads from your CI/CD pipeline:

• Double check your Capgo authentication token is set up correctly
• Schnellstartanleitung
• Authentifizierungstoken

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

Fortsetzen von Fehlerbehebung

Wenn Sie Fehlerbehebung context: Seite/ Bereich: Support / Premium-Support-Seite oder Fußzeile-Support-Sektion. Rolle: Sektion oder Seiteüberschrift. Gesehen in: Seite support-policy.astro. Nachrichtenschlüssel `support_policy_troubleshooting_title` (Support Policy Fehlerbehebung Titel). @capgo/capacitor-data-storage-sqlite @capgo/capacitor-data-storage-sqlite die Implementierungsdetails in @capgo/capacitor-data-storage-sqlite, für die native Fähigkeit in Verwendung von @capgo/capacitor-datenspeicher-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-hochloader for the implementation detail in @capgo/capacitor-uploader.