Veränderungen mit Auswirkungen auf die Kompatibilität

Diese Dokumentation erklärt, wie Sie bei Bruchänderungen in Ihrer App mit versionierten Kanälen umgehen können. Diese Vorgehensweise ermöglicht es Ihnen, verschiedene Versionen Ihrer App zu pflegen, während sichergestellt wird, dass Benutzer kompatible Updates erhalten.

Beispiel-Szenario

Angenommen, Sie haben:

• App-Version 1.2.3 (alte Version) - verwendet Produktionskanal
• App-Version 2.0.0 (neue Version mit wichtigen Änderungen) - verwendet v2-Kanal
• Live-Update 1.2.4 (kompatibel mit 1.2.3)
• Live-Update 2.0.1 (kompatibel mit 2.0.0)

Strategie: Verwende immer defaultChannel für Hauptversionen

Empfohlener Ansatz: Setze ein defaultChannel für jede Hauptversion. Dies sichert dir, dass du immer Updates an bestimmte Benutzergruppen pushen kannst, ohne dich auf dynamische Kanalzuweisungen zu verlassen.

// Version 1.x releases
defaultChannel: 'v1'

// Version 2.x releases
defaultChannel: 'v2'

// Version 3.x releases (future)
defaultChannel: 'v3'

Tipps

Vorteile dieser Ansatz:

• Immer die Kontrolle über die Benutzer haben, die Updates erhalten
• Keine dynamische Kanalwechselanforderung in Ihrer App code
• Klare Trennung zwischen verschiedenen App-Versionen
• Flexibilität um Updates an jede spezifische Version zu pushen

1. Erstellen Sie einen Kanal für die neue Version

# Create channel for version 2.x
npx @capgo/cli channel create v2

2. Aktualisieren Sie die Capacitor-Konfiguration für Version 2.0.0

Aktualisieren Sie Ihre Capacitor-Konfiguration, bevor Sie Version 2.0.0 für den App Store erstellen:

capacitor.config.ts

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'Example App',
  plugins: {
    CapacitorUpdater: {
      // ... other options
      defaultChannel: 'v2' // All 2.0.0 users will use v2 channel
    }
  }
};

export default config;

Hinweis

Für Version 1.x: Wenn Sie kein defaultChannel Initial haben, sind Benutzer von Version 1.x auf dem production Kanal. Für zukünftige Hauptversionen setzen Sie immer einen bestimmten Kanal wie v3, v4, usw.

3. Verwalte separate Code Branches

Erstellen Sie separate Git-Branches, um die Kompatibilität zwischen Anwendungsversionen aufrechtzuerhalten:

# Create and maintain a branch for version 1.x updates
git checkout -b v1-maintenance
git push origin v1-maintenance

# Your main branch continues with version 2.x development
git checkout main

Wichtig: Vermeiden Sie es, JavaScript-Bundles an ältere Apps zu pushen, die native code/APIs nicht unterstützen. Bauen Sie immer Updates von dem entsprechenden Branch aus:

• v1-Wartungs-Branch: Für Updates an 1.x-Apps (Produktionskanal)
• Haupt-Branch: Für Updates an 2.x-Apps (v2-Kanal)

4. Bundles hochladen in die jeweiligen Kanäle

# For 1.x updates: Build from v1-maintenance branch
git checkout v1-maintenance
# Make your 1.x compatible changes here
npx @capgo/cli bundle upload --channel production

# For 2.x updates: Build from main branch
git checkout main
# Make your 2.x changes here
npx @capgo/cli bundle upload --channel v2

5. Selbstzuweisung aktivieren

# Allow apps to self-assign to v2 channel
npx @capgo/cli channel set v2 --self-assign

6. Auf App Store deployen

Hinweis

Hinweis

No code changes needed! Seitdem defaultChannel: 'v2' Da es mit der App-Store-Version verbunden ist, werden alle Benutzer, die Version 2.0.0 herunterladen, automatisch den richtigen Kanal verwenden.

Skalierung für zukünftige Versionen

Wenn Sie Version 3.0.0 mit mehreren Änderungen veröffentlichen:

# Create channel for version 3.x
npx @capgo/cli channel create v3

// capacitor.config.ts for version 3.0.0
const config: CapacitorConfig = {
  // ...
  plugins: {
    CapacitorUpdater: {
      defaultChannel: 'v3' // Version 3.x users
    }
  }
};

Jetzt können Sie Updates für jede Version pushen:

• production Kanal → Version 1.x-Benutzer
• v2 Kanal → Benutzer der Version 2.x
• v3 Kanal → Benutzer der Version 3.x

7. Reinigung (Nach der Migration)

Nachdem alle Benutzer auf Version 2.x migriert sind (ca. 3-4 Monate):

1. Löschen defaultChannel aus Ihrer Capacitor-Konfiguration
2. Löschen Sie den Kanal v2:

npx @capgo/cli channel delete v2

3. Löschen Sie den Zweig v1-maintenance:

git branch -d v1-maintenance
git push origin --delete v1-maintenance

Hinweis

Durch diese Vorgehensweise erhalten die Benutzer nur Updates, die mit ihrer App-Version kompatibel sind

Stellen Sie Updates immer gründlich in jedem Kanal vor der Bereitstellung auf die Probe

Hinweis

Sie können den v2-Kanal in Capgo auch dann sicher löschen, wenn einige Benutzer noch den Kanal überschrieben haben. Sie werden automatisch Updates vom Produktionskanal erhalten.

Erhaltung von Updates für Version 1.x

Um Updates abzusenden, die mit Version 1.x kompatibel sind:

1. Wechseln Sie auf den v1-maintenance-Zweig:

git checkout v1-maintenance

2. Machen Sie Ihre Änderungen und committen Sie:

# Make 1.x compatible changes
git add .
git commit -m "Fix for v1.x"
git push origin v1-maintenance

3. Bauen und auf den Produktionskanal hochladen:

npx @capgo/cli bundle upload --channel production

Tipp

Halten Sie Ihre v1-maintenance-Zweigstelle auf dem neuesten Stand mit Bugfixes, die mit Version 1.x kompatibel sind, aber niemals breaking Changes von main mergen