Fehlersuche

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? Unsere Experten-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 Uploadproblemen zu helfen:

• --tus: Verwendet das tus-Resumable-Upload-Protokoll für zuverlässigere Uploads von großen Bundeln oder bei schlechten Netzwerkverbindungen. Wenn Ihr Bundle ü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: Erzählt Capgo, wo es die Wurzel finden soll 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 --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 wenn nötig. 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 Fehlerbehebung. 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. Er 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 keine Aktualisierung gefunden wird, überprüfen Sie bitte, ob Ihr Bundle erfolgreich hochgeladen wurde und die App auf die richtige Kanal konfiguriert ist.
   • Wenn die Aktualisierung heruntergeladen, 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, um Hilfe zu erhalten.

Der Debug-Befehl ist besonders nützlich, um Probleme mit dem Aktualisierungsdownload- und -installationsprozess 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

Neben dem 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 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 nur auf Ihre Anwendung, indem Sie sie 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 verwenden, um nach Capgo zu filtern

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

• 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 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 die Download des Updates verhindern
• Dateiberechtigungsfehler bei der Speicherung oder Lesen des Update-Bundles
• Mangel an Speicherplatz für das Update-Bundle
• Fehler beim Neustarten der App nach dem Installieren des Updates

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 “Window > Devices and Simulators”
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 Befehl im Terminal ausführen und mit grep nach Capgo filtern, 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
• Jegliche Fehler während des nativen Update-Prozesses

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

• SSL-Zertifikatsprobleme beim Download des Updates
• App-Sicherheit blockiert die Update-Download
• Für das Update-Paket ist nicht genügend Speicherplatz vorhanden
• Fehler beim 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-Shell aus, indem Sie Ihren normalen Start-Befehl verwenden (z. B. bun run electron:dev oder bun run electron:serve) und beobachten Sie die Terminal-Ausgabe für den Start, die Update-Überprüfungen und Netzwerkfehler.
2. Öffnen Sie in der Renderer-Fenster die DevTools (Ansicht → Toggle Developer Tools) und überprüfen Sie die Konsole-Protokolle und fehlgeschlagenen Netzwerk-Anfragen während der Wiederherstellung des Update-Flusses.
3. Für verpackte Apps überprüfen Sie die OS-Protokolle-Tools für Crashs oder Startfehler:
   • macOS: öffnen Console.app und filtern Sie nach Ihrem Anwendungsnamen
   • Windows: öffnen Event Viewer → Windows-Protokolle → Anwendung
   • Linux: verwenden Sie Ihren Desktop-Protokollanzeiger oder journalctl für Ihren Anwendungsprozess

Wenn Sie bei der Debugging von Updates Probleme haben, vergleichen Sie die Nachrichten aus den Protokollen des Hauptprozesses und des Renderer-Prozesses, 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 zur nativen Implementierung. Sie sind insbesondere nützlich, um Probleme zu identifizieren, die außerhalb der Capgo-JavaScript-Schicht auftreten.

When Sie bei einem schwierigen Live-Update-Problem nachforschen, 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 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 die Aktualisierung 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 der Aktualisierung besteht
• Beziehen Sie sich auf die

Live-Updates bereitstellen Updates not applying Richtlinie für weitere Informationen zum Update-Prozess. Wenn Sie immer noch Probleme haben, verwenden Sie den npx @capgo/cli@latest app debug Kommandozeilen-Befehl und native Logs, um mehr Einblicke in das Geschehen zu erhalten.

Gemeinsame Update-Fehlercodes

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

• Gemeinsame Update-Probleme

Es erklärt, was jeder gemeinsame 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 "Schritt-für-Schritt-Anleitung" befolgt, einschließlich der Synchronisierung Ihrer App nach der Installation von __CAPGO_KEEP_0__ Schritt-für-Schritt-Anleitung steps in order, including syncing your app after installing the SDK

Abschnitt mit dem Titel "CI/CD-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
• Siehe die "CI/CD-Integration"

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

Weitergehen von Fehlerbehebung

Wenn Sie Fehlerbehebung zur Planung der Speicherung und Dateihandling verwenden, verbinden Sie es mit @capgo/capacitor-speicherung-sqlite für die Implementierungsdetails in @capgo/capacitor-speicherung-sqlite, Mit @capgo/capacitor-speicherung-sqlite für die native Fähigkeit in Mit @capgo/capacitor-speicherung-sqlite, @capgo/capacitor-datei für die Implementierungsdetails im @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.