Einmaliger Setup-Checkliste

Ein kopierfertiger Einrichtungsvorschlag mit den Installationsanweisungen und der vollständigen Markdown-Guideline für diesen Plugin erstellen.

Sie haben abgeschlossen Einrichtung. Jetzt konfigurieren Sie Capgo einmal. Nachdem Sie das getan haben, ist die tägliche Arbeit nur Hochladen → Testen → Bereitstellen.

Die Installation des Capgo-Plugins in Ihrem Projekt ist nicht ausreichend. OTA-Updates funktionieren nur auf Geräten, die eine native App mit bereits integriertem Plugin laufen.

Nachdem Sie Capgo hinzugefügt und aufgerufen haben CapacitorUpdater.notifyAppReady():

Ausführen npx cap sync
Erstellen Sie ein neues iOS/Android-Binär
Hinweis: Bei der Veröffentlichung in den App Store, Play Store, TestFlight oder Ihrem internen Distributoren

Benutzer auf einem älteren Store-Build ohne the plugin will never receive live updates. Uploading bundles to Capgo only affects devices on a Capgo-enabled binary.

Die Hochladen von Bundles in __CAPGO_KEEP_0__ wirkt sich nur auf Geräte mit einem __CAPGO_KEEP_1__-aktivierte Binär aus. Weitere Informationen finden Sie unter.

Fehlersuche Regel: Kanäle sind Release-Linien (development, productionkeine Tickets, Funktionen oder Entwicklernamen.

Einmaliger Einrichtungskalender

Kanäle erstellenWählen Sie die kleinstmögliche Menge, die passt (siehe unten).
Standardkanal für Uploads festlegen in Anwendungs-Einstellungen:
- Solo-Anwendung → production
- Team → development
Produktionskanal: öffentlich an, Gerät selbstsetzen aus, Updates unter native an, Auto-Update-Wächter an major.
Testkanal (development / staging): öffentlich aus, Gerät selbst auf für QA.
Von CI hochladen mit --delta (Prüfsumme und native Abhängigkeiten sind automatisch):
Terminalfenster
```
npx @capgo/cli@latest bundle upload \
  --channel development \
  --bundle "1.8.0-${BUILD_NUMBER}" \
  --comment "commit ${GIT_SHA:0:7} run ${CI_RUN_ID}" \
  --delta
```
Die --bundle Wert muss gültig semantisches Versionsmanagement. Überprüfen Sie es vor dem Hochladen. SemVer-Tester bevor Sie es hochladen.
Nur nach Testen in die Produktion deployen. nur nach Testen, von der Dashboard oder CLI.
Team & Sicherheit: einladen, so wenig Rechte wie möglich, 2-Faktor-Authentifizierung für die Organisation, einmal API-Schlüssel in CI.

Verschlüsselung verlassen, min_update_versionMetadaten, Daten und Vorschau aus es sei denn, Sie haben einen klaren Grund.

Wählen Sie Ihre Größe

Einfach: 1 App, 1 Kanal: production

Team: development + production. Hochladen auf dev, bereitstellen auf prod.

Native-Versionen: Fügen Sie Kanäle nur dann hinzu, wenn erforderlich, z.B. production-9.0 + test-9.0. Halten Sie Store-Benutzer auf dem Hauptproduktionskanal.

Viele Apps: gleiche einfache Modell pro App (normalerweise eines production . Erstellen Sie keine zusätzlichen Kanäle nur weil das Unternehmen groß ist.

Release-Zyklus (optional): staging → rc → production. Das gleiche Template auf jeder App, die es benötigt.

Name des Pakets vs. Kommentar

Die Namen der Pakete sind erforderlich zu befolgen semantische Versionsnummer . Capgo verwendet semver für Kompatibilitätsprüfungen, automatische Kanalaktualisierungen und Rollover. Überprüfe jeden Namen in der SemVer-Tester vor dem Hochladen.

Name = semver aus CI, z.B. 1.8.0, 1.8.0-beta.1, oder 1.8.0-20260629.42
Kommentar = freier Text für Menschen → commit abc1234 run 28059070270

Verwende semver Vorabversion Beschriftungen (der Teil nach -) wenn Sie viele Builds unter der gleichen MAJOR.MINOR.PATCH Zum Beispiel behalten Sie 1.8.0 und fügen Sie das Datum oder die Buildzähler in der Vorabversion ein: 1.8.0-20260629.1, 1.8.0-beta.2 Erstellen Sie keine eigenen Formate wie fix-login-bug oder 2.5.2026062306 Sie sind keine gültigen semver und Uploads werden fehlschlagen oder unvorhersehbar verhalten.

Legen Sie die Release Notes in --comment, nicht in der Bundle-Name.

Weitere Informationen Versionsziel und Bündelversionierung.

Delta-Upload

--delta hochlädt Manifest so laden Geräte nur die geänderten Dateien und nicht das gesamte Bündel, wenn sie aktualisiert werden müssen. Die Prüfsumme wird immer automatisch berechnet. Sie müssen keine Prüfsumme-Flag übergeben.

Standard: `--delta` (Manifest + Zip-Backup)

npx @capgo/cli@latest bundle upload \
  --channel development \
  --bundle "1.8.0-${BUILD_NUMBER}" \
  --delta

Dies ist die empfohlene Standard-Einstellung für die meisten Apps. Capgo speichert das Manifest und bewahrt das vollständige Zip als Sicherungskopie. Gut, wenn der Speicherplatz nicht Ihr Hauptanliegen ist.

Speichereinsparung: `--delta-only`

npx @capgo/cli@latest bundle upload \
  --channel development \
  --bundle "1.8.0-${BUILD_NUMBER}" \
  --comment "commit ${GIT_SHA:0:7} run ${CI_RUN_ID}" \
  --delta-only

Verwenden Sie --delta-only wenn Sie möchten, dass Sie den __CAPGO_KEEP_0__-Speicherplatz reduzieren. reduce Capgo storageGewinnung: Ohne die Zip-Sicherung auf dem Server hängt man vollständig vom Manifest-Pfad ab. Überspringen

Trade-off: without the zip backup on the server, you rely fully on the manifest path. Skip --delta-only bis auf den Fall, dass Sie tatsächlich die Speicherungseinsparungen benötigen.

Keine zusätzliche Plugin-Konfiguration ist auf dem Gerät erforderlich. Der Updater liest das Manifest und lädt nur geänderte Dateien her.

Tägliche Arbeitsabläufe

Upload to development (--delta)
  → test
  → deploy to production
  → don't touch channel settings again

Häufige Fehler

Fehler	Behebung
Erwartung von OTA vor einer neuen Ladenveröffentlichung	Rebuild und versenden Sie die native App nach dem Hinzufügen des Plugins
Ein Bundle hochladen, aber nicht in einen Kanal deployen	Zuweisen Sie dem Bundle einen Kanal (z.B. `production`)
Kanal pro Feature, Ticket oder Entwickler	Verwenden Sie nur dauerhafte Releasebahnen
Dynamische CI-Kanalnamen	Festgelegte Namen: `development`, `production`
Zu viele Kanäle für eine einfache App	Mit 1-2 Kanälen beginnen
Gerät selbst auf Produktionsmodus setzen	Aus für Produktionskanäle, an für Testkanäle
Überspringen `--delta`	Hinzufügen `--delta` zu Uploads; verwenden `--delta-only` nur wenn Sie Speicherplatz sparen müssen
Nicht-semver-Bundle-Namen	Folgen der semantischen Versionsnummerierung und in der SemVer-Tester überprüfen
Versionierungsschema ändert sich im Laufe der Zeit	Halten Sie semver bei; verwenden Sie Vorabversionen für zusätzliche Builds (`1.8.0-20260629.1`)
Metadaten / Vorschau aktiviert ohne Grund	Standardmäßig ausgeschaltet

Mehr erfahren

Kanäle Standardeinstellungen, Vorrang und Routing.

Delta-Updates Warum und wie Sie --delta verwenden sollten.

CI/CD Automatisches Hochladen und Bereitstellen.

Bündel Prüfsumme, Abhängigkeiten und Metadaten.