Capacitor CLI: Projekt-Einrichtungs-Leitfaden

{
  "appId": "com.company.app",
  "appName": "My App",
  "webDir": "dist",
  "bundledWebRuntime": false,
  "server": {
    "hostname": "app.example.com",
    "androidScheme": "https"
  }
}

2.  [Initialisieren Sie Capgo](https://capgo.app/docs/webapp/) in Ihrem Projekt:

    ```bash
    npm install --save @capgo/cli
    ```

3.  Erstellen und veröffentlichen Sie Updates:

    ```bash
    npx capgo init
    ```

4.  Öffnen Sie die App, um den Hintergrund-Update-Prozess auszulösen.

### Best Practices

-   Nutzen Sie Kanäle, um Updates zu testen, bevor Sie sie an alle Benutzer ausrollen.
-   Überwachen Sie Analysen, um sicherzustellen, dass Updates erfolgreich zugestellt werden und Benutzer engagiert bleiben.
-   Aktivieren Sie Fehlerverfolgung, um Probleme frühzeitig zu erkennen und zu beheben.
-   Halten Sie die Rollback-Funktion bereit, um schnell auf Probleme reagieren zu können.

Capgo ist kompatibel mit Capacitor 6 und 7, integriert sich nahtlos in CI/CD-Pipelines und erfüllt die Anforderungen von Apple- und Google-Stores.

## Häufige Probleme und Tipps

Nach Abschluss der Plattform- und Capgo-Einrichtung könnten einige häufige Fehler auftreten. Hier erfahren Sie, wie Sie diese schnell beheben.

### Umgebungseinrichtungsprobleme

-   **CLI nicht gefunden**
    **Fehler**: Der Befehl `npx cap` schlägt fehl.
    **Lösung**: Führen Sie `npm install --save @capacitor/cli @capacitor/core` aus und versuchen Sie es erneut.

-   **Node-Version stimmt nicht überein**
    **Fehler**: CLI-Befehle schlagen aufgrund von Node.js-Versionsfehlern fehl.
    **Lösung**: Installieren Sie Node.js Version 14 oder höher gemäß den Einrichtungsanforderungen.

### Konfigurationsprobleme

-   **Konfigurationsabweichung**
    **Fehler**: Änderungen in `capacitor.config.json` werden nicht wirksam.
    **Lösung**: Stellen Sie sicher, dass die Werte `appId` und `webDir` mit der `package.json` Ihres Projekts und dem Web-Build-Ausgabeordner übereinstimmen.

-   **Plattform-Sync-Fehler**
    **Fehler**: Die Ausführung von `npx cap sync` führt zu Plugin-Versionskonflikten.
    **Lösung**: Aktualisieren Sie `@capacitor/android` und `@capacitor/ios` auf die gleiche Hauptversion und führen Sie dann den Sync-Befehl erneut aus.

### Build und Deployment

-   **Build-Signierungsfehler**
    **Fehler**: iOS- oder Android-Builds schlagen aufgrund fehlender Zertifikate oder Keystore fehl.
    **Lösung**: Folgen Sie den IDE-Einrichtungsanweisungen. Fügen Sie für iOS Ihr Entwicklerteam in Xcode hinzu. Konfigurieren Sie für Android den Keystore in `build.gradle`.

-   **Webverzeichnis nicht gefunden**
    **Fehler**: `npx cap sync` kann die Web-Assets nicht finden.
    **Lösung**: Führen Sie Ihren Web-Build-Befehl (z.B. `npm run build`) vor der Synchronisierung der Plattformen aus.


### Live-Update-Probleme

-   **[Capgo Update-Fehler](https://capgo.app/docs/plugin/cloud-mode/manual-update/)**
    **Fehler**: Updates erscheinen nicht in der Produktions-App.
    **Lösung**: Überprüfen Sie Ihren [Capgo API-Schlüssel](https://capgo.app/docs/webapp/api-keys/) in `capacitor.config.json` und stellen Sie sicher, dass Sie den richtigen Kanal ansprechen.

Für weitere Details zur plattformspezifischen Einrichtung, besuchen Sie den Abschnitt Platform Setup. Wenn Sie mit Live-Updates arbeiten, konsultieren Sie den Capgo Setup Guide für zusätzliche Fehlerbehebungstipps.

## Zusammenfassung

### Setup-Überprüfung

Starten Sie Ihre Web-App mit Capacitor CLI, richten Sie iOS- und Android-Plattformen ein und fügen Sie optional Capgo für Live-Updates hinzu.

So beginnen Sie:

1. Verwenden Sie die Capacitor CLI, um Ihr Projekt zu initialisieren.
2. Richten Sie die Paket-ID Ihrer App ein und definieren Sie das Web-Ausgabeverzeichnis.
3. Fügen Sie Unterstützung für iOS- und Android-Plattformen hinzu.
4. Installieren und richten Sie Capgo mit folgendem Befehl ein: `npm install --save @capgo/cli && npx capgo init`

Für detaillierte Einrichtungsanweisungen oder Fehlerbehebung, schauen Sie in die offizielle Capacitor- und Capgo-Dokumentation.