Einzelfall-Setup-Checkliste

Sie haben abgeschlossen Einbindung. Konfigurieren Sie nun Capgo einmalNachdem Sie das aufgeführt sind, ist die tägliche Arbeit nur Hochladen → Testen → Bereitstellen.

Ermitteln Sie zunächst eine neue Ladenkompilation

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

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

1. Run npx cap sync
2. Bauen Sie eine neue iOS/Android-Binärdatei
3. Dem App Store, Play Store, TestFlight oder Ihrem internen Distributor übermitteln

Benutzer auf einem älteren Ladenbau ohne Der Plugin wird nie Live-Updates erhalten. Die Hochladen von Paketen zu Capgo wirkt sich nur auf Geräte mit einem Capgo-aktivierten Binärdatei aus.

Siehe auch Fehlersuche.

Regel: Kanäle sind Veröffentlichungsstrecken (development, production), nicht Tickets, Funktionen oder Entwicklernamen.

---

Einmaliger Einrichtungscheckliste

1. Kanäle erstellen: Wählen Sie die kleinste Menge, die passt (siehe unten).

2. Standardmäßige Uploadkanal einrichten in Anwendungs-Einstellungen:

   • Solo-Anwendung → production
   • Team → development

3. Produktionskanal: Öffentlich auf, Geräte selbstsetzen ab, Updates unter Native auf, Auto-Update-Wächter auf major.

4. Testkanal (development / staging): Öffentlich ab, Geräte selbstsetzen für QA auf.

5. Upload von CI mit --delta (Prüfsumme und native Abhängigkeiten sind automatisch):

   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

   Der --bundle Wert muss gültig sein Semantic Versioning. Überprüfen Sie ihn im SemVer-Tester bevor Sie ihn hochladen.

6. In die Produktion deployen nur nach der Testung, von der Oberfläche oder CLI.

7. Team & Sicherheit: einmal einladen, mindestens Berechtigungen 2FA für die Organisation, eine API-Schlüssel in CI.

Verschlüsselung deaktivieren min_update_version, Metadaten und Vorschau aus nur wenn Sie einen klaren Grund haben.

---

Wählen Sie Ihre Größe

Einfach: 1 App, 1 Kanal: production

Team: development + productionUploaden auf dev, deployen auf prod.

NativversionenFügen Sie Kanäle nur dann hinzu, wenn nötig, z.B. production-9.0 + test-9.0: Fügen Sie Kanäle nur dann hinzu, wenn erforderlich, z.B.

Viele Apps: eine einfache Modell pro App (in der Regel eines) production : dasselbe einfache Modell pro App (in der Regel eines)

Veröffentlichungsreihe (optional): staging → rc → production. Das gleiche Template in jeder App, die es benötigt.

Vorsicht

Verwenden Sie keine Kanäle mit Namen, die nach Tickets, Personen oder CI-Variablen benannt sind wie ${inputs_capgo_channel}.

---

Bundle-Name vs Kommentar

Bundle-Namen sind erforderlich um semantische Versionsnummerierung zu folgen. Capgo verwendet semver für Kompatibilitätsprüfungen, Kanal-Auto-Update-Regeln und Rollbacks. Überprüfen Sie jeden Namen in der SemVer-Tester vor dem Upload.

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

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

Setze Release-Notes in --comment. Fügen Sie die Release Notes in

Siehe auch Versionsziel . Paketversionierung.

---

Datenpaket-Upload

--delta Uploads Deltas Somit laden Geräte nur die geänderten Dateien und nicht das gesamte Bundle. Die Prüfsumme wird immer automatisch berechnet. Sie übergeben keine Prüfsummenflagge.

Standard: --delta (Deltas + Zip-Sicherung)

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 die Deltas und context: Capgo-Marketing-Website. Rolle: Kurzbeschriftung oder Navigationspunkt. Anzeige in: Seite trust.astro. Nachrichtenschlüssel `und` (Und).

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

Use --delta-only wenn Sie möchten, dass Sie den Capgo Speicherplatz reduzieren. Speichern Sie nur die Delta-Dateien, nicht die vollständige Zip-Datei. Wählen Sie diese Option für große Apps oder hohe Upload-Volumina, bei denen der Speicherplatz aufaddiert wird.

Trade-off: without the zip backup on the server, you rely fully on delta files, and devices on an old plugin version without Delta support cannot update. Skip --delta-only außer Sie benötigen die Speicherung tatsächlich.

Keine zusätzliche Plugin-Konfiguration ist auf dem Gerät erforderlich. Der Updater liest die Liste der Delta-Dateien und lädt nur die geänderten Dateien herunter.

Tipp

Siehe Delta-Updates zur Fehlerbehebung und directUpdate Verhaltensweise.

---

Tägliche Arbeitsablauf

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

---

Häufige Fehler

Fehler	Behebung
Ein neues Laden vorher zu erwarten	Rebuilden und versenden Sie die native App nach dem Hinzufügen des Plugins
Ein Bundle hochladen, aber nicht auf einen Kanal deployen	Ein Bundle einem Kanal zuweisen (z.B. production)
Ein Kanal pro Feature, Ticket oder Entwickler	Nur dauerhafte Releasebahnen verwenden
Dynamische CI-Kanalnamen	Fixe Namen: development, production
Zu viele Kanäle für eine einfache App	Mit 1-2 Kanälen beginnen
Geräte selbst auf Produktion setzen	Aus für Produktion, an für Testkanäle
Überspringen --delta	Fügen Sie --delta zum Hochladen; verwenden Sie --delta-only nur, wenn Sie Speicherplatz sparen müssen
Keine semver-Bundle-Namen	Folgen Sie der semantischen Versionsnummerierung und überprüfen Sie in der SemVer-Tester
Ändern Sie das Versionsierungsschema im Laufe der Zeit	Halten Sie sich an semver; verwenden Sie Vorabversionen für zusätzliche Builds (1.8.0-20260629.1)
Metadaten / Vorschau aktivieren ohne Grund	Deaktivieren Sie sie standardmäßig

---

Mehr erfahren

Kanäle Standards, Vorrang und Routen.

Delta-Updates Wie und warum Sie --delta verwenden sollten.

CI/CD Automatisieren Sie das Hochladen und Bereitstellen.

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