Einstellungskontrolle

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

Schicken Sie ein neues Laden-Build aus

Die Installation des Capgo-Plugins in Ihrem Projekt reicht nicht aus. 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. Ausführen npx cap sync
2. Ein neues iOS/Android-Binär erstellen
3. Zur App Store, Play Store, TestFlight oder Ihrer internen Verteilung hochladen

Benutzer auf einem älteren Store-Build ohne das Plugin werden nie live aktualisiert. Die Hochladen von Bundles zu Capgo wirkt sich nur auf Geräte mit einem Capgo-aktivierte Binär aus.

Siehe auch Fehlersuche.

Regel: Kanäle sind Release-Pfade (development, production), not tickets, features, or developer names.

---

Einmaliger Einrichtungskalender

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

2. Standardkanal für Uploads setzen in Anwendungs-Einstellungen:

   • Einzelanwendung → production
   • Team → development

3. Produktionskanal: Öffentlich an, Gerät selbst auf Storno, Blockiere Updates unter native an, Auto-Update-Wächter an major.

4. Testkanal (development / staging): Öffentlich aus, Gerät selbst auf für QA.

5. Upload aus 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 semantische VersionsverwaltungÜberprüfen Sie es in der SemVer-Tester bevor Sie es hochladen.

6. Erstatten Sie nur nach Testen, von der Oberfläche oder __CAPGO_KEEP_0__. or CLI.

7. Einladung einmal, geringste Rechte, 2FA für die Organisation, eine __CAPGO_KEEP_0__-Schlüssel in CI. for the org, one API key in CI.

Verschlüsselung deaktivieren, min_update_version, Metadaten und Vorschau nur es sei denn, Sie haben einen klaren Grund.

---

Wählen Sie Ihre Größe

Einfach: 1 App, 1 Kanal: production

Team: development + productioncontext:Seite/ Bereich: Capgo-Marketing-Website. Rolle: Kurzer UI-Label oder Navigationspunkt. Anzeigen in: Seite sla.astro. Nachrichten Schlüssel `team_plan` (Team-Plan).

. Hochladen auf dev, bereitstellen auf prod.Native Versionen production-9.0 + test-9.0. Halten Sie Store-Benutzer auf der Hauptproduktionskanal.

Viele Apps: dasselbe einfache Modell pro App (in der Regel eines) production jedes). Machen Sie keine zusätzlichen Kanäle nur, weil das Unternehmen groß ist.

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

Vorsicht

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

---

Bundle-Name vs Kommentar

Paketnamen sind erforderlich um semantische Versionskontrolle zu folgen semantische Versionskontrolle. Capgo uses semver for compatibility checks, channel auto-update rules, and rollbacks. Validate every name in the SemVer-Tester vor dem Hochladen.

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

Verwenden Sie semver Vorabversion Beschriftungen (der Teil nach -Wenn Sie viele Builds unter dem gleichen MAJOR.MINOR.PATCHBeispiel: Halten Sie 1.8.0 und fügen Sie das Datum oder den Buildzähler in der Vorabversion ein: 1.8.0-20260629.1, 1.8.0-beta.2Verwenden Sie nicht eigene Formate wie fix-login-bug oder 2.5.2026062306Verwenden Sie die Release-Notes in

nicht im Bundle-Namen. --commentSiehe auch

See also Zielgruppenspezifische Version und Bündelversionierung.

---

Deltaspeicherung

--delta eine Hochladung Manifest so laden Geräte nur geänderte Dateien und nicht das gesamte Bündel herunter, wenn sie aktualisiert werden. Der Prüfsummenwert wird immer automatisch berechnet. Sie müssen keine Prüfsummenflagge übergeben.

Standard: --delta (Manifest + 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 das Manifest und context: Seite/ Bereich: Capgo-Marketing-Website. Rolle: Kurze Benutzeroberflächennachbar oder Navigationselement. Anzeige in: Seite trust.astro. Nachrichtsschlüssel `und` (Und).

bewahrt die volle Zip als Sicherungskopie. Gut, wenn der Speicherplatz nicht Ihr Hauptanliegen ist. --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

Zwischenablage kopieren --delta-only Verwenden Sie reduce Capgo storageden __CAPGO_KEEP_0__-Speicherplatz reduzieren. Nur die Delta/Manifestdateien werden gespeichert, nicht die volle Zip. Wählen Sie diese Einstellung für große Apps oder hohe Uploadvolumina, bei denen sich der Speicherplatz addiert.

Kompromiss: Ohne den Zip-Backup auf dem Server hängt ihr voll und ganz an der Manifest-Pfad. Überspringen --delta-only es sei denn, ihr habt tatsächlich die Speicherungseinsparungen benötigt.

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

Tipp

Siehe Delta-Updates zur Fehlerbehebung und directUpdate Verhalten.

---

Taglicher Workflow

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

---

Häufige Fehler

Fehler	Behebung
Vorausgesetzte OTA vor einer neuen Ladenveröffentlichung	Neubau und Versand des nativen Apps nach Hinzufügen des Plugins
Hochladen eines Bundles, aber nicht bereitstellen in einem Kanal	Zuweisen des Bundles zu einem 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 gesetzt	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-Kanälabenamen	Folgen der semantischen Versionsnummerierung und in der SemVer-Tester
Änderung der Versionsierung über die 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 lassen

---

Mehr erfahren

Kanäle Standardeinstellungen, Vorrang und Routen.

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

CI/CD Auf Uploads und Deployments automatisieren.

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