Troubleshooting

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

Upload-Fehler

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

• Ihre App-ID in capacitor.config.ts entspricht Ihrer App in der Capgo-Oberfläche
• 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

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

• --tus: Wird verwendet den tus-Resumable-Upload-Protokoll zur sicheren Übertragung großer Bundle oder bei schlechten Netzwerkverbindungen. Wenn Ihr Bundle über 10 MB ist oder Sie auf einer schlechten Verbindung sind, sollten Sie überlegen, --tus:

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

• --package-json und --node-modules: Erzählt Capgo , wo Sie Ihre Wurzel finden 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 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 verpacken.

Sie können diese Flags mit anderen Optionen kombinieren wie --channel nach Bedarf. 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-Fehlerschaltfläche ein nützliches Werkzeug zur Fehlerbehebung. Um es 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 der Fehlerschaltfläche. Sie wird Informationen über den Updateprozess anzeigt, einschließlich:

   • Wenn das App-Update überprüft wird
   • 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-Dokumentationen 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 -Installationprozess 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 zu dem Capgo-Debug-Befehl 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 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 auf nur Ihren Anwendungsprozess, indem Sie ihn 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 das adb logcat Kommando und grep für Capgo um die Protokolle zu filtern.

Die Capgo SDK-Protokolle werden während des Update-Prozesses wichtige Ereignisse wie folgendes protokollieren:

• Wenn ein Update-Check initiiert wird
• Wenn ein Update gefunden wird und welche Version es ist
• When der Update-Download beginnt und abgeschlossen ist
• Wenn die Update-Installation ausgelöst wird
• Jegliche Fehler, die während der native Update-Schritte auftreten

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

• Netzwerk-Verbindungsprobleme, die den Update-Download verhindern
• Dateisicherheitsfehler, wenn das Update-Paket gespeichert oder gelesen wird
• Speicherplatzmangel für das Update-Paket
• Das Problem, das App neu zu starten, nachdem das Update installiert ist

iOS-Protokolle

Zum Zugriff auf die iOS-Protokolle:

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 Konsole suchen Sie nach Zeilen, die ‘ Capgo um die SDK-Protokolle zu finden

Sie können auch den log stream Kommandozeilenbefehl verwenden und mit Capgo um die Protokolle zu filtern

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

• 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önnten:

• SSL-Zertifikatsprobleme beim Herunterladen der Aktualisierung
• Die App-Transport-Sicherheit blockiert das Herunterladen der Aktualisierung
• Unzureichender Speicherplatz für das Aktualisierungspaket
• Fehlschlag bei der richtigen Extraktion oder Anwendung des Aktualisierungspakets

Elektron-Protokolle

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

1. Führen Sie das Electron-Programm aus der Kommandozeile aus, indem Sie Ihren normalen Startbefehl verwenden (z. B. bun run electron:dev oder bun run electron:serve) und beobachten Sie die Kommandozeilen-Ausgabe für den Start, die Aktualisierungskontrollen und Netzwerkfehler. Öffnen Sie die Entwicklerwerkzeuge in der Renderer-Fensteransicht (Ansicht → Toggle-Entwicklerwerkzeuge) und überprüfen Sie die Konsole-Protokolle und fehlgeschlagene Netzwerkanfragen, während Sie die Aktualisierungsablauf wiederholen.
2. __CAPGO_KEEP_0__
3. Für verpackte Apps überprüfen Sie die Werkzeuge für die OS-Protokolle auf Crashes oder Startfehler:
   • macOS: öffnen Sie Console.app und filtern Sie nach Ihrem App-Namen
   • Windows: öffnen Sie Ereignis-Viewer → Windows-Protokolle → Anwendung
   • Linux: verwenden Sie Ihren Desktop-Protokoll-Viewer oder journalctl für Ihren App-Prozess

When Sie bei der Debugging von Updates vorgehen, 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 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 der Capgo-JavaScript-Schicht auftreten.

Bei der Behebung eines schwierigen Live-Update-Problems 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() in your app code as shown in the Überprüfen Sie, ob Ihr Gerät an das Internet angeschlossen 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 ein Problem bei der Anwendung des Updates auftritt
• Updates werden nicht angewendet

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

oder

Häufige Updatefehler disable_auto_update_to_major, semver_errorEs erklärt, was jeder häufige __CAPGO_KEEP_0__ bedeutet, warum es passiert und wie Sie es beheben können. cannot_update_via_private_channelInstallation von __CAPGO_KEEP_0__

• deploying live updates

It explains what each common code means, why it happens, and how to fix it.

SDK Installation

Wenn Sie Schwierigkeiten haben, 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-Handbuch 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 bei 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
• Section titled “__CAPGO_KEEP_0__ Installation”
• If you’re having trouble installing the __CAPGO_KEEP_0__ __CAPGO_KEEP_1__, make sure:

Blicken Sie sich die CI/CD-Integration Dokumentation für weitere Tipps zum Fehlerbehebung an. 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.

Fortsetzen von Fehlerbehebung

Wenn Sie Fehlerbehebung zur Planung von Speicher und Dateihandling verwenden, 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 Verwendung von @capgo/capacitor-data-storage-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 für die Implementierungsdetails in @capgo/capacitor-hochloader.