Wie man Semantic Versioning mit Capgo-Push-Updates verwendet

Wollen Sie die App-Updates app updates Semantic Versioning (SemVer) Semantische Versionsnummerierung (SemVer) __CAPGO_KEEP_0__ CapgoDie Über-The-Air (OTA)-Updates von Capgo erleichtern das Verwalten Capacitor Semantic Versioning Basics:

Die Versionen verwenden die Formatierung Versions verwenden die Formatierung MAJOR.MINOR.PATCH:
- MAJOR: Für grundlegende Änderungen.
- MINOR: Für neue Funktionen, die rückwärts kompatibel sind.
- PATCH: Für Bug-Fixes.
Warum SemVer mit Capgo verwenden?
- Klare Kommunikation über Updates.
- Intelligente Versionsverwaltung.
- Vermeiden von Abhängigkeitskonflikten.
- Organisierte Release-Planung.
Capgo Einrichtung Schritte:
1. Installieren Sie das Updater-Plugin von Capgo.
2. Konfigurieren Sie die Version Ihrer App in capacitor.config.json und anderen Dateien.
3. Initialisieren Sie mit Ihrer API-Schlüssel.
4. Use Capgo CLI Um Updates zu bündeln und hochzuladen.
Verwalten Sie Versionen und Kanäle.:
- Verwenden Sie separate Kanäle (z.B. „beta“ für Tests, „produktion“ für stabile Releases).
- Steuerung der Update-Politik (Automatische Aktualisierung von Patches, manuelle Genehmigung für große Änderungen).
- Rücksetzoptionen für fehlgeschlagene Updates.
Deploymentsprozess:
- Update die Versionsnummern entsprechend den SemVer-Regeln.
- Testen Sie gründlich, bevor Sie deployen.
- Verwenden Sie CLI-Befehle, um Updates hochzuladen und zu verteilen.

Capgo stellt sicher, dass Updates schnell und zuverlässig an die Benutzer gelangen, mit Werkzeugen zur Behandlung von Unterbrechungen und zur Erhaltung der Stabilität. Perfekt für Teams, die CI/CD-Workflows verwenden, um Updates automatisiert zu verwalten.

Quick-Tipp: Testen Sie immer Updates und verwenden Sie Kanäle, um effektive staged Rollouts zu verwalten.

Semantic Versionierung | Aufholen

Capgo Setup-Anleitung

Capgo Live Update Dashboard-Interface

Hier erfahren Sie, wie Sie Capgo für die einfache Verwaltung von OTA-Updates und Versionskontrolle einrichten.

Schritte für die Initialisierung

Beginnen Sie mit der Installation des Capgo-Updater-Plugins:

npm install @capgo/capacitor-updater  
npx cap sync

Stellen Sie sicher, dass Ihr capacitor.config.json Datei verwendet eine semantische Versionsformat:

{ 
  "appId": "com.example.app", 
  "appName": "My App", 
  "version": "1.0.0" 
}

Für ältere Projekte aktualisieren Sie die Versionsdetails in folgenden Orten:

package.json (suchen Sie nach dem) version field)
android/app/build.gradle feld) versionName)
ios/App/App.xcodeproj/project.pbxproj feld) CURRENT_PROJECT_VERSION)

(aktualisieren Sie das Feld "Capgo" mit Ihrem API-Schlüssel:)

npx @capgo/cli@latest init YOUR_API_KEY

Schnellreferenztabelle:

Einrichtungsphase	Schlüsselaktion	Verifizierungsstep
Installation	Installieren Sie das Plugin und synchronisieren Sie	Überprüfen `package.json`
Konfiguration	Setzen Sie Versionsnummern	Überprüfen Sie über alle Dateien hinweg
Initialisierung	Verbinden Sie sich mit der API-Schlüssel	Verbindungstatus prüfen
Erstellen	Erstellen Sie das erste Bundle	Erstes Bundle erstellen

Upload erfolgreich bestätigen

Capgo funktioniert gut mit CI/CD-Plattformen, die Automatisierte Updates german. Unterstützte Plattformen umfassen:

Wenn Sie an der lokalen Entwicklung arbeiten, können Sie die automatischen Updates durch Hinzufügen dieses zu Ihrer Konfiguration deaktivieren:

{ 
  "plugins": { 
    "CapacitorUpdater": { 
      "autoUpdate": false 
    } 
  } 
}

Dies sichert Capgo vor, Ihre lokalen Änderungen zu überschreiben. Sobald Ihre Konfiguration fertig ist, laden Sie Ihre erste Version hoch.

npx @capgo/cli@latest bundle upload  
npx @capgo/cli@latest channel set production -s default

Zum Schluss informieren Sie das native Plugin über den Gesundheitszustand des Bundles in Ihrem Hauptdatei:

import { CapacitorUpdater } from '@capgo/capacitor-updater';  
CapacitorUpdater.notifyAppReady();

Dieses Setup stellt sicher, dass Ihre App für eine glatte OTA-Implementierung und Versionsverwaltung bereit ist.

Semantic Versioning mit Capgo

Versionsnummer-Verwaltung

Capgo verwendet die Semantische Versionierung (SemVer) zur Verwaltung von App-Versionen, formatiert als MAJOR.MINOR.PATCHEs funktioniert wie folgt:

Hauptversion (X.0.0): Erhöhen Sie die MAJOR-Zahl für Änderungen, die die Kompatibilität brechen.
Minor Version (1.X.0): Ziehen Sie die MINOR-Zahl für neue Funktionen, die kompatibel bleiben.
Patchversion (1.0.X): Ziehen Sie die PATCH-Zahl für Bug-Fixes, die die Kompatibilität nicht beeinflussen.

Versionstyp	Wann zu inkrementieren	Automatischer Update-Verhalten
Groß (X.0.0)	Für wichtige API Änderungen	Benötigt manuelle Genehmigung
Klein (1.X.0)	Für neue Funktionen	Konfigurierbar in Capgo
Patch (1.0.X)	Fehlerbehebungen	Häufig automatisch

Indem Sie sich an die SemVer-Regeln halten, können Sie die Versionsverwaltung vereinfachen und sicherstellen, dass Updates über Ihre Bereitstellungskanäle glatt verlaufen.

Versionierungsrichtlinien

Capgo ermöglicht Ihnen die effektive Verwaltung von Bereitstellungen, indem Sie separate Kanäle für verschiedene Stadien Ihres Workflows einrichten.

Kanalbasierte Versionsverwaltung: Organisieren Sie Ihren Bereitstellungsprozess, indem Sie separate Kanäle für die Testung und die Produktion erstellen. Zum Beispiel:
- Ermöglichen Sie die "Beta"-Testung neuer Funktionen über einen "beta"-Kanal (z.B. 1.2.0-beta).
- Halten Sie einen "Produktions"-Kanal (z.B. 1.2.0) für stabile Releases.
- Fügen Sie plattform-spezifische Kanäle (z.B. „ios-hotfix“ mit Version 1.2.1) hinzu, wenn plattform-spezifische Probleme angegangen werden.
Update-Policy-Konfiguration: Kontrollieren Sie, wie Updates angewendet werden, mithilfe der Konfigurationsoptionen von Capgo’s. Zum Beispiel:
```
{
  "plugins": {
    "CapacitorUpdater": {
      "disableAutoUpdate": "minor"
    }
  }
}
```
Dieses Setup stellt sicher, dass Benutzer automatisch Patches erhalten, während Minor- und Major-Updates manuell genehmigt werden müssen.
Version-Rollback-Strategie: Verwenden Sie Voreinstellungen zur Wiederherstellung, um klare Wiederherstellungsoptionen zu erhalten. Diese Vorgehensweise ermöglicht es Ihnen, auf eine vorherige Version zurückzukehren, wenn Probleme auftreten, während die Versionsnummerierung konsistent über alle Kanäle bleibt.

Diese besten Praktiken erleichtern die Verwaltung von Updates, die Testung neuer Funktionen und die Gewährleistung von Stabilität im Bereitstellungsprozess Ihres Apps.

sbb-itb-f9944d2

OTA-Update-Deployment

: Sobald Ihre Versionsverwaltungskonfiguration bereit ist, folgen Sie diesen Schritten, um OTA-Updates effektiv zu deployen.

Update-Vorbereitung

: Beginnen Sie damit, die Version in package.json und capacitor.config.jsonStellen Sie sicher, dass die Version der SemVer-Format (MAJOR.MINOR.PATCH) entspricht:

Bug-Fix: Erhöhen Sie die PATCH-Zahl (z.B. 1.0.1 → 1.0.2)
Neue Funktion: Erhöhen Sie die MINOR-Zahl (z.B. 1.0.0 → 1.1.0)
Fehlerkorrektur: Erhöhen Sie die MAJOR-Zahl (z.B. 1.0.0 → 2.0.0)

Testen Sie Ihre Build gründlich und bestätigen Sie, dass die App mit dem Server kommuniziert. notifyAppReady.

Als Nächstes entscheiden Sie sich für Ihre Update-Strategie. Sie können auswählen:

Auto-Update: Erfordert automatisch die Mindestversionseinstellungen.
Manueller Kontrolle: Legt genauere Versionsanforderungen für Updates fest.
Kanalbasiert: Verwenden Sie Kanäle für Tests und rollende Umstellungen.

Update-Befehle für Capgo CLI

Verwenden Sie Capgo’s CLI für eine einfache Bereitstellung Ihrer Aktualisierung. Hierfür:

# Initialize Capgo in your project
npx @capgo/cli@latest init [apikey]

# Upload your update bundle
npx @capgo/cli bundle upload [appId]

# Add a new distribution channel
npx @capgo/cli channel add [channelName] [appId]

Capgo sichert das Bereitstellen mit Ende-zu-Ende-Verschlüsselung und sicheren Schlüsselverwaltung ab.

“@Capgo ist eine intelligente Möglichkeit, heiße code Updates (und nicht für all den Geld der Welt wie bei @AppFlow) 🙂”

Nachdem Sie das Update bereitgestellt haben, können Sie es über Capgo’s Dashboard überwachen. Updates erreichen die Benutzer in der Regel innerhalb von Minuten nachdem sie die App geöffnet haben. Der Prozess funktioniert wie folgt:

Die App überprüft Updates.
Herunterlädt das Update im Hintergrund.
Markiert die neue Version als aktiv, wenn der Benutzer die App beendet.
Wendet das Update auf dem nächsten Start an.

Für Enterprise-Deployments möchten Sie möglicherweise CI/CD-Automatisierung integrieren.

“Wir praktizieren agiles Entwicklung und @Capgo ist mission-kritisch bei der kontinuierlichen Lieferung an unsere Benutzer!”

Problembehandlung und Tipps

Versionenmanagement-Probleme

Die Verwaltung von semantischen Versionen in Capgo kann manchmal die Update-Deployments komplizieren. Um Ihre Entwicklungsaufgaben nicht zu überschreiben, konfigurieren Sie die folgenden in Ihrem capacitor.config.json Datei:

{ 
  "plugins": { 
    "CapacitorUpdater": { 
      "autoUpdate": false 
    } 
  } 
}

Wenn ein Update fehlschlägt, hier ist, was Sie tun können:

Setzen Sie autoUpdate zum false Während der Entwicklung.
Entfernen Sie die App.
Installieren Sie sie erneut mit der korrigierten Version.
Aktiviere die automatischen Updates erneut, sobald alles stabil ist.

Führen Sie bei großen Versionsupdates die disableAutoUpdateBreaking Flag und hören Sie auf das majorAvailable Ereignis zur korrekten Handhabung von Updates:

CapacitorUpdater.addListener('majorAvailable', (info) => {
  console.log(`Major update available: ${info.version}`);
  // Add your update prompt logic here
});

Durch die Combination dieser Konfigurationen mit guten Teampraktiken können Sie die Versionskonsistenz aufrechterhalten und Fehler reduzieren.

Team-versionskontrolle

Einmal, wenn einzelne Updates verwaltet werden, ist es für Teams entscheidend, starke Versionenkontrollpraktiken zu etablieren.

‚Jedes Änderungstest vor dem Merging mit dem Hauptrepository wird die Stabilität stärken und kostspielige Fehler vermeiden‘ [4]

Hier sind einige Methoden, um Konsistenz sicherzustellen:

Definieren Sie einen Zweig als Hauptrepository als Quelle der Wahrheit.
Verwenden Sie separate Capgo Kanäle für Entwicklungsumgebung und Produktionsumgebung.
Kanäle für Entwicklungsumgebungen und Produktionsumgebungen.
Dokumentiere alle code Änderungen mit klaren und detaillierten Commit-Nachrichten.

Für größere Teams kann die folgende Versionsverwaltungs-Matrix bei der Organisation von Updates helfen:

Environment	Channel	Umgebung	Version Muster
Entwicklung	dev	Deaktiviert	0.x.x
Staging	beta	Aktiviert	x.x.x-beta
Produktion	stabil	Aktiviert	x.x.x

Update-Wiederherstellungs-Schritte

Even mit Vorsichtsmaßnahmen können Updates scheitern. Wenn das passiert, folgen Sie diesen Wiederherstellungsanweisungen.

Zurückrollen Sie zu einem vorherigen stabilen Bundle.
Erhöhen Sie die Versionszahlen für jede neue Korrektur (Hinweis: Versionszahlen können nach der Löschung nicht wieder verwendet werden) [2].
Verify updates during app startup to ensure they work as expected.

Capgo's Updater ist darauf ausgelegt, Störungen zu bewältigen. Zum Beispiel, wenn der Server nicht erreichbar ist oder ein Update gelöscht wurde, funktioniert die App weiterhin normal. [3]. Zusätzlich werden fehlgeschlagene Netzwerk-Anfragen automatisch während des nächsten App-Starts wiederholt. [3]. Diese eingebaute Resilienz minimiert die Ausfallzeit und sichert glattere Betriebsabläufe.

Zusammenfassung

Semantic Versioning, kombiniert mit Capgo, hat die OTA-Updates für Capacitor-Apps effizienter gemacht. Mit 947,6 Millionen Updates geliefert und 1.400 Produktions-Apps, die dieses System verwenden [1], wurden die Bereitstellungsprozesse um 81 % effizienter [1]. Diese Konfiguration ermöglicht es Entwicklern, Updates schnell und kontrolliert zu pushen, ohne sich um App-Store-Verzögerungen zu kümmern.

Here’s what developers are saying:

“Wir haben OTA-Updates Capgo OTA-Updates in der Produktion für unsere Nutzergruppe von +5000. Wir sehen eine sehr glatte Funktion fast alle unsere Nutzer sind innerhalb von Minuten nach dem Bereitstellen des OTA bei @Capgo.” - colenso [1]

Das MAJOR.MINOR.PATCH-Versionierungssystem erleichtert die Kommunikation von Änderungen, neuen Funktionen und Bugfixen. [5]. Dies ist besonders hilfreich für Teams, die mehrere Releases pro Woche über Capgo's Plattform verwalten.

Capgo's verschlüsselte Lösung, die mit CI/CD-Tools integriert ist, ist auch budgetfreundlich - Kosten können um bis zu 26.100 $ über fünf Jahre gesenkt werden [1]. Ihre anpassbaren Kanäle stellen sicher, dass Updates die richtigen Nutzer zu dem richtigen Zeitpunkt erreichen.

“Wir praktizieren agiles Entwicklung und @Capgo ist mission-kritisch bei der ständigen Lieferung an unsere Nutzer!” - Rodrigo Mantica [1]

Weiter von How to Use Semantic Versioning with Capgo OTA Updates

Wenn Sie Capgo OTA-Updates verwenden Wie Sie Semantic Versioning mit Capgo OTA-Updates verwenden um Rollbacks und Versionskontrolle zu planen, verbinden Sie es mit Rollbacks für die Implementierungsdetails in Rollbacks, Zielversionierung für die Implementierungsdetails in Zielversionierung, Aktualisierungsverhalten für die Implementierungsdetails in Aktualisierungsverhalten, Bundle für die Implementierungsdetails in Bundle, und Capgo Live-Updates für das Produktworkflow in Capgo Live Updates.

Wie man Semantic Versioning mit Capgo OTA-Updates verwendet