Fehlertreiber

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 Ihnen zur Verfügung, um persönliche Unterstützung, code-Überprüfungen und maßgeschneiderte Lösungen zu Ihren spezifischen Bedürfnissen anzubieten.

Professionelle Unterstützung erhalten

Hochladefehler

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

• Ihre App-ID in capacitor.config.ts entspricht 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äufige Upload-Probleme zu lösen:

• --tus: Verwendet das tus resumables Upload-Protokoll für zuverlässigere Uploads von großen Paketen oder bei schlechten Netzwerkverbindungen. Wenn Ihr Paket über 10 MB ist oder Sie bei einer unzuverlässigen Verbindung sind, sollten Sie --tus:

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

• --package-json und --node-moduleszeigt Capgo an, wo Ihr Root- package.json und node_modules wenn Ihr App ein nicht standardmäßiges Struktur wie ein Monorepo oder npm Workspace verwendet. Geben Sie den Pfad zum Root 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 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 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 aus, die das Update auslösen sollte (z. B. das Wiederherstellen der App nach dem Hochladen eines neuen Bundles).

3. Beachten Sie die Ausgabe der Debug-Kommandozeile. Sie wird Informationen über den Update-Prozess anbieten, 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 Dokumentation oder wenden Sie sich an den Support für Hilfe.

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 bei der Fehlerbehebung 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 Fehlerbehebungsinformationen liefern, 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 Ihre Anwendungsprozess, indem Sie ihn aus dem Dropdown-Menü oben auswählen
4. Suchen Sie nach Zeilen, die Capgo um die SDK-Protokolle zu finden

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

Während des Update-Prozesses werden wichtige Ereignisse wie SDK vom Capgo protokolliert.

• Wenn ein Update-Check initiiert wird
• Wenn ein Update gefunden wird und welche Version es ist
• Wenn der Update-Download beginnt und abgeschlossen wird
• Wenn das Update-Installation getriggert wird
• Bei Fehlern, die während der native Update-Schritte auftreten

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

• Netzwerk-Verbindungsprobleme, die den Update-Download verhindern
• Dateisystemrechtefehler beim Speichern oder Lesen der Update-Paket
• Mangel an Speicherplatz für das Update-Paket
• Fehler beim Neustarten 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 Konsole-Ausgabe suchen Sie nach Zeilen, die Capgo um die SDK-Protokolle zu finden

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

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

• Initiierung und Ergebnis der Update-Überprüfung
• Start, Fortschritt und Abschluss des Downloads
• Auslösen und Ergebnis der Installation
• Jeder Fehler während des nativen Update-Prozesses

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

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

Elektron-Protokolle

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

1. Starten Sie die Elektron-Anwendung in Ihrem Terminal mit Ihrem normalen Startkommando (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 in der Renderer-Fensteransicht (Ansicht → Toggle-Entwicklerwerkzeuge) und überprüfen Sie die Konsole-Protokolle und fehlgeschlagene Netzwerkanforderungen während der Wiedergabe des Update-Flusses.
3. Für verpackte Anwendungen überprüfen Sie die OS-Log-Tools für Crashs oder Startfehler:
   • macOS: öffnen Console.app und filtern Sie nach Ihrem Anwendungsnamen
   • Windows: öffnen Ereignis-Viewer → Windows-Protokolle → Anwendung
   • Linux: verwenden Sie Ihren Desktop-Protokollanzeiger oder journalctl : verwenden Sie Ihren Desktop-Protokollanzeiger oder

Wenn Sie Updates debuggen, vergleichen Sie die Nachrichten aus den Protokollen des Hauptprozesses und des Renderer-Prozesses, um Electron-Bootstrap-Probleme von Capgo Update-Laufzeitproblemen zu trennen.

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

When troubleshooting a tricky live update problem, it’s a good idea to capture both the Capgo debug logs and the native logs for a comprehensive picture of what’s happening. The two logs together will give you the best chance of identifying and resolving the issue.

Updates werden nicht angewendet

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

• Stellen Sie sicher, dass Sie CapacitorUpdater.notifyAppReady() in Ihrer App code wie im folgenden Beispiel Quickstart
• Überprüfen Sie, ob 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 einem frischen Start angewendet werden.
• Überprüfen Sie die native Protokolle auf Fehler, die auf ein Problem bei der Anwendung der Aktualisierung hindeuten könnten.

Anwenden Sie die Deploying Live Updates Anleitung für weitere Details zum Update-Prozess. Wenn Sie weiterhin Probleme haben, verwenden Sie die npx @capgo/cli@latest app debug Anzeigen von Befehls- und native Logs, um mehr Einblicke in das Geschehen zu erhalten.

Häufige Update-Fehlerrichtlinien

Wenn Ihre Protokolle Backend-Fehler wie disable_auto_update_to_major, semver_erroroder cannot_update_via_private_channelanzeigen, verwenden Sie bitte die folgende Anleitung:

• Häufige 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 Anweisungen im 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 Die 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 von der App empfangen werden

Fortsetzen mit der Problembehandlung

Wenn Sie Capgo verwenden Fehlerbehebung um Speicherplatz und Dateimanagement zu planen, verbinden Sie es mit @capgo/capacitor-Speicher- SQLite für die Implementierungsdetails in @capgo/capacitor-data-storage-sqlite Verwenden Sie @capgo/capacitor-data-storage-sqlite für die native Fähigkeit in Verwenden Sie @capgo/capacitor-data-storage-sqlite @capgo/capacitor-Datei für die Implementierungsdetails in @capgo/capacitor-file Verwenden Sie @capgo/capacitor-file für die native Fähigkeit in Verwenden Sie @capgo/capacitor-file @capgo/capacitor-Uploader für die Implementierungsdetails in @capgo/capacitor-Uploader.