Zum Hauptinhalt springen

Version Tagging in Capacitor Apps

Erhalten Sie die Grundlagen zum Versionsmanagement in Capacitor-Apps, einschließlich besten Praktiken für Updates, Synchronisierung und Automatisierung.

Martin Donadieu

Martin Donadieu

Inhaltsmarketer

Version Tagging in Capacitor Apps

Das Versionsmanagement ist für die Verwaltung von __CAPGO_KEEP_0__-Apps unerlässlich. Es sichert eine reibungslose Aktualisierung, verfolgt Änderungen und verbessert die Zuverlässigkeit der Apps auf iOS, Android und Web-Plattformen. Hier ist eine kurze Übersicht: Capacitor Version Tagging in __CAPGO_KEEP_0__ Apps

  • Das Versionsmanagement ist für die Verwaltung von __CAPGO_KEEP_0__-Apps unerlässlich. Es sichert eine reibungslose Aktualisierung, verfolgt Änderungen und verbessert die Zuverlässigkeit der Apps auf iOS, Android und Web-Plattformen. Hier ist eine kurze Übersicht:: Aktualisierungen verfolgt, Rollbacks ermöglicht und sichere Bereitstellungen sicherstellt.
  • Semantische Versionsnummerierung: Verwende MAJOR.MINOR.PATCH um Bruchlinien zu markieren, neue Funktionen oder Fehler zu korrigieren.
  • Über Synchronisierung: Versionen auf package.json, iOS Info.plist, und Android build.gradle.
  • ausrichten.: Automatisierung Aktualisierungen automatisieren mit npm-Skripten und CI/CD-Tools.
  • Live Updates: Werkzeuge wie Capgo liefern Updates an 95% der Benutzer innerhalb von 24 Stunden.
  • Beta-Management: Verwenden Sie strukturierte Kanäle für Alpha, Beta- und Produktionsversionen.

Schnelle Vergleich

FunktionZweckBeispiel
Semantische VersionsnummerierungVerfolgt Änderungen klar1.2.3 → 2.0.0
Synchronisierte VersionenÜbereinstimmung über Plattformennpx cap sync
AutomatisierungBeschleunigt die Versionsaktualisierungennpm version patch
Live-UpdatesSchnelle NutzerakzeptanzCapgo’s 95% in 24 Stunden
Beta-KanäleKontrollierte Testphasen1.3.0-beta.1

Die Versionsmarkierung vereinfacht Anwendungsaktualisierungen, hält die Nutzer glücklich und sichert den Entwicklern die effektive Verwaltung von Releases.

Wie Sie Ihre Capacitor Projekt automatisch konfigurieren ⚡️

Capacitor Framework Dokumentationswebsite

Versionseinrichtung in Capacitor

Folgen Sie diesen Schritten, um eine konsistente Versionsverwaltung auf allen Plattformen in Ihrem Capacitor-App zu gewährleisten.

Version in package.json

Die package.json Datei dient als Hauptquelle für die Versionsdetails Ihrer App. Hier ist ein Beispiel dafür, wie Sie sie einrichten können:

{
  "name": "your-app-name",
  "version": "1.2.3",
  "private": true,
  "dependencies": {
    "@capacitor/core": "5.5.0",
    "@capacitor/ios": "5.5.0",
    "@capacitor/android": "5.5.0"
  }
}

Wenn Sie die Versionsnummer aktualisieren, verwenden Sie die SemVer-Regeln (SemVer):

  • Hauptversion (1.x.x): Einführt wichtige Änderungen.
  • Kleine Version (x.2.x): Fügt neue Funktionen hinzu, die rückwärts kompatibel sind.
  • Patchversion (x.x.3): Behebt Fehler oder macht kleine Verbesserungen.

Versionsverwaltung auf allen Plattformen

Es ist wichtig, dass die Versionsnummern auf allen Plattformen übereinstimmen, um eine glatte App-Veröffentlichung zu gewährleisten. Jede Plattform hat ihre eigene Konfigurationsdatei für die Versionsverwaltung:

PlattformKonfigurationsdateiVersionsschlüssel
iOSInfo.plistCFBundleShortVersionString
Androidbuild.gradleversionName
Webpackage.jsonversion

Nachdem Sie die Version in package.json, verwenden Sie diesen Befehl, um die Änderungen mit den nativen Plattform-Konfigurationen zu synchronisieren:

npx cap sync

Mit Capacitor CLI für die Versionsverwaltung

Die Capacitor CLI bietet hilfreiche Befehle, um Versionen zu verwalten:

# Check the current version of Capacitor
npx cap --version

# Update Capacitor core and platform dependencies
npm install @capacitor/core@latest
npm install @capacitor/ios@latest
npm install @capacitor/android@latest

# Sync version changes to native platforms
npx cap sync

Das Aktualisieren Ihrer Capacitor CLI sichert die Kompatibilität mit versionsspezifischen Funktionen und reduziert potenzielle Mismatches. Durch die Befolgung dieser Schritte können Sie eine ordnungsgemäße Versionsverwaltung in Ihrer App aufrechterhalten.

Semantische Versionskonfiguration

Semantische Versionsgrundlagen

Semantische Versionsnummerierung (SemVer) verwendet die Formatierung MAJOR.MINOR.PATCHwobei jede Teil einen bestimmten Änderungstyp anzeigt:

VersionskomponenteZweck
MAJOREinführt Bruchänderungen in die API
MINORFügt neue Funktionen hinzu, die mit vorherigen Versionen kompatibel bleiben
PATCHBehebt Fehler oder verbessert die Leistung ohne die Kompatibilität zu brechen

Dieses System ermöglicht es Entwicklern, Updates klar zu kommunizieren, während die Kompatibilität über verschiedene App-Versionen hinweg erhalten bleibt. Zum Beispiel, wenn man von 1.2.3 zu 2.0.0 zeigt, dass es sich um wichtige, kompatibilitätsbrechende Updates handelt, die sorgfältig geplant werden müssen.

Wann Versionsnummern aktualisieren

Hier erfahren Sie, wie Sie entscheiden können, welche Versionsnummer aktualisiert werden soll:

Update-TypWann verwendenBeispiel für Versionsänderung
Großes UpdateFür wichtige API Änderungen oder große UI-Überarbeitungen1.2.3 → 2.0.0
Minor UpdateWenn neue Funktionen eingeführt oder Funktionen als veraltet markiert werden1.2.3 → 1.3.0
Patch UpdateFür Fehlerkorrekturen oder kleine Leistungsanpassungen1.2.3 → 1.2.4

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

Now lassen wir uns diese Updates automatisieren, um die Release-Verwaltung zu vereinfachen.

Version Update Automation

Die Automatisierung von Versionsupdates Kann Zeit sparen und Fehler in Ihrem Capacitor Projekt reduzieren. Hier ist, wie Sie es einrichten können:

  1. NPM Version Scripts

Fügen Sie diese Skripte Ihrem package.json Datei hinzu, um Version-Updates einfach zu verwalten:

{
  "scripts": {
    "version:patch": "npm version patch",
    "version:minor": "npm version minor",
    "version:major": "npm version major"
  }
}
  1. CI/CD-Integration
    Inkorporieren Sie Versionsupdates in Ihre CI/CD-Pipeline. Capgo unterstützt Tools wie GitHub Actions, GitLab CI, und Jenkins, wodurch es einfach ist, den Prozess zu automatisieren.

„@Capgo ist ein Muss-Werkzeug für Entwickler, die Produktivität durch Umgehung langwieriger Bugfix-Reviews suchen.” - Bessie Cooper [1]

Version-Tag-Methode

Git-Version-Tag

Git-Version-Tag sind eine zuverlässige Möglichkeit, __CAPGO_KEEP_0__-App-Versionen zu verfolgen Capacitor. Um klare und informative Tags zu erstellen, kombinieren Sie die semantische Versionsnummerung mit einer kurzen Beschreibung:

git tag -a v1.2.3 -m "Release v1.2.3: Added offline mode support"

Um Konsistenz innerhalb Ihres Teams zu gewährleisten, verwenden Sie einen standardisierten Tagformat:

Tag-KomponenteFormatBeispiel
Veröffentlichungsversionv[MAJOR].[MINOR].[PATCH]v1.2.3
Beta-Veröffentlichungv[VERSION]-beta.[NUMBER]v1.2.3-beta.1
Veröffentlichungskandidatv[VERSION]-rc.[NUMBER]v1.2.3-rc.2

Build Number Integration

Buildzahlen helfen dabei, einzelne Builds innerhalb jeder Version zu verfolgen. Für beide iOS und Android sollte die Buildzahl mit jeder Einreichung erhöht werden:

{
  "ios": {
    "version": "1.2.3",
    "build": "10234"
  },
  "android": {
    "version": "1.2.3",
    "versionCode": "10234"
  }
}

Die Buildzahl sollte immer erhöht werden, selbst wenn die Version gleich bleibt. Dies stellt sicher, dass jede App-Store-Einreichung eindeutig identifiziert wird, während die Versionsnummer für die Benutzer klar bleibt.

Beta-Versionen-Verwaltung

Die Verwaltung von Beta-Versionen erfordert einen strukturierten Prozess, um Testbuilds zu verteilen. Capgo’s Kanal-System erleichtert dies mit den folgenden Schritten:

  1. Kanal-Einrichtung

Erstellen Sie separate Kanäle für jeden Testphasen:

{
  "beta": {
    "version": "1.3.0-beta.1",
    "users": "beta-testers"
  },
  "production": {
    "version": "1.2.3",
    "users": "all"
  }
}
  1. Zugriffssteuerung für Benutzer

Einstellungen für die Berechtigungen setzen, um zu bestimmen, wer Zugriff auf Beta-Versionen erhält. Dies sichert sicherzustellen, dass nur genehmigte Tester Beta-Versionen erhalten, während Produktionsbenutzer stabile Releases erhalten.

  1. Versionenfolge

Verwenden Sie ein klares Versionsfolgesystem, um die Entwicklungsstufen zu verfolgen:

StufeVersionsformatZweck
Alpha1.3.0-alpha.1Internes Testen
Beta1.3.0-beta.1Externer Testgruppe
RC (Release Candidate)1.3.0-rc.1Final testing vor der Veröffentlichung
Produktion1.3.0Öffentliche Veröffentlichung

Diese Vorgehensweise sichert eine umfassende Testung und glatte Übergänge zwischen den Entwicklungsstufen, wobei die Versionsverwaltung organisiert und transparent während des gesamten Prozesses bleibt.

App Version Anzeige

Die Anzeige genauer Versionsinformationen in Ihrer App ist entscheidend, um Benutzer über Updates informiert zu halten und diese effektiv zu verwalten.

Version abrufen mit Capacitor

Sie können Versionsdetails mit Capacitor abrufen, indem Sie diese code verwenden:

import { App } from '@capacitor/app';

async function getAppInfo() {
  const info = await App.getInfo();
  console.log(`Version: ${info.version}`);
  console.log(`Build: ${info.build}`);
}

Für eine strömungsgerechtere Vorgehensweise erstellen Sie eine wiederverwendbare Funktion:

export const getVersionString = async () => {
  const info = await App.getInfo();
  return `v${info.version} (${info.build})`;
};

Diese Funktion vereinfacht den Prozess der Anzeige von Versionsinformationen in der Schnittstelle Ihrer App.

Version UI Implementierung

Hier ist ein Beispiel dafür, wie die Versionsanzeige in einem Einstellungscomponent integriert werden kann:

@Component({
  selector: 'app-settings',
  template: `
    <div class="version-info">
      <span>Version: {{ versionString }}</span>
      <span *ngIf="updateAvailable" class="update-badge">
        Update Available
      </span>
    </div>
  `
})

Gemeinsame Orte, an denen Versionsdetails angezeigt werden können:

StandortZweckImplementierung
EinstellungsanzeigeVollständige Version und BuildDetaillierte Versionsinformationen
Über SeiteGrundlegende VersionsanzeigeNur Versionsnummer
App FooterMinimal displayKurzbeschreibung

Neben der Anzeige der Versionsinformationen kann die Integration eines Update-Prüfungs-Systems die Benutzererfahrung verbessern.

Update-Prüfungs-System

Ein Update-Prüfungs-System stellt sicher, dass Benutzer Zugriff auf die neuesten Funktionen und Korrekturen haben. Capgo bietet Echtzeitbenachrichtigungen und kontrollierte Updatekanäle, um diesen Prozess zu verwalten:

import { CapacitorUpdater } from '@capgo/capacitor-updater';

async function checkForUpdates() {
  const current = await CapacitorUpdater.current();
  const latest = await CapacitorUpdater.getLatest();

  if (current.version !== latest.version) {
    await CapacitorUpdater.download({
      version: latest.version
    });
  }
}

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

Sie können auch eine Benutzerbenachrichtigung für Updates hinzufügen, wie folgt:

@Component({
  template: `
    <update-modal 
      [version]="newVersion"
      [features]="updateFeatures"
      (updateNow)="performUpdate()"
    />
  `
})

Für Unternehmen-Apps ermöglicht Capgo's Kanal-System die Kontrolle der Update-Verteilung:

KanalUpdate-TypZielgruppe
ProduktionStabile VersionenAlle Benutzer
BetaVorabversionenTestgruppe
KritischNotfallkorrekturenBetroffene Benutzer

Dieser Methode gewährleistet die Anwendungsverlässlichkeit, während die Updateleistung über Capgo’s Analytics-Dashboard verfolgt wird.

Versionen-Management-Lösungen

Lasst uns tiefer in die fortgeschrittenen Lösungen für die effektive Verwaltung von Anwendungsversionen eintauchen.

Version Tool Optionen

Wenn Sie Versionierungs-Tools auswählen, ist es wichtig, sich auf solche zu konzentrieren, die Updates vereinfachen, Ihre code sicherstellen und sowohl App-Store-Veröffentlichungen als auch Live-Updates unterstützen.

Hier sind einige wichtige Funktionen, nach denen Sie suchen sollten:

FunktionWichtigkeitEinfluss
Live-UpdatesKritischMinimiert Verzögerungen durch App-Store-Bewertungen
SicherheitWesentlichSichert Benutzerdaten und code-Integrität
AnalyticsWichtigeMessungen aktualisieren Erfolg und Nutzerakzeptanz
CI/CD-IntegrationNützlichVereinfacht die Bereitstellungsprozesse
KostenoptimierungStrategischBeeinflusst die langfristige Budgetplanung

Ein hervorragendes Werkzeug in diesem Bereich ist Capgo, das Funktionen bietet, die speziell für Capacitor-Apps.

Capgo Version Control Features

Capgo Live Update Dashboard Interface

Capgo bietet robuste Funktionen für die Versionsverwaltung, einschließlich:

  • 23,5 Mio. erfolgreiche Updates
  • 95% der Benutzer wurden innerhalb von 24 Stunden aktualisiert
  • 82% globale Erfolgsrate
  • 434 ms Durchschnittszeit für API-Antworten weltweit

Ein Beispiel dafür, wie Capgo für die Versionsverwaltung verwendet werden kann:

// Capgo version control example
import { CapacitorUpdater } from '@capgo/capacitor-updater';

const versionControl = {
  async checkVersion() {
    const current = await CapacitorUpdater.current();
    return current.version;
  },

  async deployUpdate(version: string) {
    await CapacitorUpdater.setChannel({
      channel: 'production',
      version: version
    });
  }
};

“Wir probieren gerade Capgo aus, seit Appcenter die Live-Updates für hybride Apps eingestellt hat und @AppFlow ist viel zu teuer.” - Simon Flack [1]

Teamgröße-Lösungen

Capgo bietet flexible Tarife, um Teams aller Größen zu unterstützen, was die Versionsverwaltung skalierbar und effizient macht.

TeamgrößePlanungSchlüsselmerkmale
EinzelpersonGrundlegende Cloud-HostingLive-Updates, 1.000 MAU
Kleine Gruppe (2-5)Maker-Plan10.000 MAU, 500 GB Bandbreite
Mittlere Gruppe (6-20)Team-Plan100.000 MAU, Berechtigungen
UnternehmenZahlung nach Verbrauch (PAYG)Unbegrenzte MAU, dediziertes Support

Für größere Teams ermöglicht Capgo's Kanal-System eine genaue Kontrolle über die Versionen:

const enterpriseVersionControl = {
  channels: {
    production: 'stable-releases',
    beta: 'early-access',
    internal: 'development'
  },

  async deployToChannel(channel: string, version: string) {
    await CapacitorUpdater.setChannel({
      channel: channel,
      version: version
    });
  }
};

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

Capgo beinhaltet auch ein Analytics-Dashboard, um die Versionsanerkennungsraten zu überwachen und potenzielle Probleme frühzeitig zu erkennen. Mit eingebauter Verschlüsselung und anpassbaren Hostingoptionen können Teams die Sicherheit aufrechterhalten, während sie ihre Bereitstellungsworkflows skalieren.

Zusammenfassung

Verständnis der Versionsbezeichnung ist der Schlüssel zum Vereinfachen der Entwicklung und Bereitstellungsvorgänge. Hier ist eine kurze Zusammenfassung der wichtigsten Ideen und Schritte, um loszulegen.

Hauptergebnisse

Die Versionsbezeichnung hilft Entwicklern, glatte und zuverlässige Updates bereitzustellen. Eine ordnungsgemäße Versionskontrolle bietet klare Vorteile:

VorteilWirkungErgebnis
Instant UpdatesKürzere ÜberprüfungszeiträumeSchnellere Nutzerakzeptanz [1]
Version ControlBessere code-VerwaltungHöhere Erfolgsraten [1]
Update-TrackingEchtzeit-MonitoringSchnellere Problemlösung [1]
Verteilungs-KontrolleZielgerichtete RolloutsMulti-Plattform-Unterstützung

Diese Ergebnisse unterstreichen die Bedeutung der Verwendung effektiver Versionsverwaltungstools.

Wie man beginnt

Um diese Vorteile in die Tat umzusetzen, folgen Sie diesen Schritten:

  • Einstellung der Versionsverfolgung: Verwenden Sie semantische Versionsverwaltung in Ihrem Datei und integrieren Sie notwendige Plugins. package.json Hinzufügen von Update-Überprüfungen
  • : Implementieren Sie Systeme, um Versionsupdates zu überprüfen und zu verfolgen.Konfiguration von Verteilungskanälen
  • : Erstellen Sie separate Umgebungen für Produktion, Beta und Entwicklung.Zuletzt sollten Sie einen Live-Update-System hinzufügen, um sicherzustellen, dass Bereitstellungen schnell und sicher sind.

Fortsetzen Sie von Version-Tagging in __CAPGO_KEEP_0__ Apps

Capacitor

Wenn Sie Version-Tagging in Capacitor-Apps für die Planung von Rollbacks und Versionskontrolle verwenden Rollbacks für die Implementierungsdetails in Rollbacks, Version-Zielsetzung für die Implementierungsdetails in Version-Zielsetzung, Aktualisierungsverhalten für die Implementierungsdetails in Aktualisierungsverhalten, paketieren für die Implementierungsdetails in paketieren, und Capgo-Live-Updates für den Produktworkflow in Capgo Live Updates.

Live-Updates für Capacitor-Apps

Wenn ein Web-Schicht-Bug live ist, liefern Sie die Reparatur über Capgo anstatt Tage zu warten, bis die App-Store-Zulassung vorliegt. Die Benutzer erhalten die Aktualisierung im Hintergrund, während native Änderungen im normalen Überprüfungsverfahren bleiben.

Los geht's jetzt

Neuestes aus unserem Blog

Capgo gibt Ihnen die besten Einblicke, die Sie benötigen, um eine wirklich professionelle mobile App zu erstellen.