Schulung

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 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:

• Das App-ID in capacitor.config.ts entspricht Ihrem 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: Verwendet das tus-Uploadprotokoll für wiederholbare Uploads für zuverlässigere Uploads großer Pakete oder bei schlechten Netzwerkverbindungen. Wenn Ihr Paket über 10 MB ist oder Sie bei einer schlechten Verbindung sind, sollten Sie --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. 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
   • Jede Fehler, die während dem Update-Prozess auftreten

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.

Die Debug-Kommandozeile ist besonders nützlich, um Probleme mit dem Update-Download- und -Installation-Prozess 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 zur Capgo Debug-Kommandozeile können die native Logs auf Android, iOS und Electron wertvolle Fehlersuchinformationen 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 Ihr 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 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 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
• Mangel an Speicherplatz für das Update-Paket
• Fehler 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 Ausgabe der Konsole suchen Sie nach Zeilen, die 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 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önnten:

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

Elektron-Protokolle

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

1. Starten Sie die Electron-Anwendung in Ihrem Terminal mit Ihrem normalen Startbefehl (z. B. bun run electron:dev oder bun run electron:serveFühren Sie die Electron-Anwendung in Ihrem Terminal mit Ihrem normalen Startbefehl (z. B.
2. und beobachten Sie die Terminalausgabe für Startvorgänge, Aktualisierungsprüfungen und Netzwerkfehler.
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-Verwaltung → Windows-Protokolle → Anwendung
   • Linux: verwenden Sie Ihren Desktop-Protokoll-Viewer oder journalctl für Ihren App-Prozess

Wenn Sie bei der Fehlersuche 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 bei der Fehlersuche ein schwieriges Live-Update-Problem haben, ist es eine gute Idee, sowohl die Capgo Debug-Protokolle als auch die native Protokolle für ein umfassendes Bild von dem, was passiert, zu speichern. 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 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 das Update nicht angewendet werden kann
• Sicherstellen Sie, dass Sie die richtige __CAPGO_KEEP_0__ Version verwendet haben.

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

Häufige Update-Fehlercodes

Wenn Ihre Logs Backend-Fehler wie disable_auto_update_to_major, semver_erroroder cannot_update_via_private_channelanzeigen, verwenden Sie den speziellen Leitfaden:

• Gemeinsame Update-Probleme

Er erklärt, was jeder häufige code bedeutet, warum es passiert und wie Sie es beheben können.

SDK Installation

Wenn Sie Schwierigkeiten haben, Capgo SDK zu installieren, 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__ CI/CD-Integration steps in order, including syncing your app after installing the SDK

Falls Sie Probleme mit der Auslösung von __CAPGO_KEEP_0__-Uploads aus Ihrem CI/CD-Pipeline haben:

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

• Double check your Capgo authentication token is set up correctly
• __CAPGO_KEEP_1__
• __CAPGO_KEEP_0__

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

Fortsetzen von Fehlerbehebung

Wenn Sie Fehlerbehebung context: Seite/ Bereich: Unterstützung / Premium-Unterstützung oder Fußzeile-Unterstützungsabschnitt. Rolle: Sektion oder Seiteüberschrift. Gesehen in: Seite support-policy.astro. Nachrichten Schlüssel `support_policy_troubleshooting_title` (Support Policy Troubleshooting Title). @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.