Zum Hauptinhalt springen

Version Tagging in Capacitor Apps

Erhalten Sie die Grundlagen des Capacitor-Versions-Taggings, einschließlich besten Praktiken für Updates, Synchronisierung und Automatisierung.

Version Tagging in Capacitor Apps

Die Versions-Tagging ist für das Verwalten von __CAPGO_KEEP_0__-Anwendungen unerlässlich. Capacitor Apps. Es sichert glatte Updates, verfolgt Änderungen und verbessert die Zuverlässigkeit von Apps auf iOS, Android und Web-Plattformen. Hier ist eine kurze Übersicht:

  • Warum es wichtig ist: Verfolgt Updates, ermöglicht Rollbacks und sichert stabile Bereitstellungen.
  • Semantische Versionsnummerierung: Verwende MAJOR.MINOR.PATCH um Bruchlinien, neue Funktionen oder Bugfixes anzuzeigen.
  • Synchronisierung über Plattformen: Passen die Versionsnummern in package.json, iOS Info.plist, und Android build.gradle.
  • Automatisierung: Aktualisierungen automatisieren mit npm-Skripten und CI/CD-Tools.
  • Live-UpdatesSeite: Hauptseite, Abschnitt: Problem/Lösung. Rolle: Abschnitts- oder Seitenüberschrift. Gesehen in: Seite premium-support.astro. Nachrichtenschlüssel `ps_help_updates_title` (Ps Hilfe Updates Titel). Capgo __CAPGO_KEEP_0__
  • Seite: Capgo-Marketing-Website. Rolle: Website-Text. Gesehen in: Seite contributing.astro. Capgo-Produkt- und -Markenbegriffe sowie Entwicklerbegriffe genau beibehalten.Updates an 95% der Benutzer innerhalb von 24 Stunden liefern.

Betaversionen

: Verwenden Sie strukturierte Kanäle für Alpha-, Beta- und Produktionsversionen. Schnelle Vergleich Funktion
Semantische Versionsverwaltung Verfolgt Änderungen klar 1.2.3 → 2.0.0
Versions synchronisieren Übereinstimmung über Plattformen npx cap sync
Automatisierung Beschleunigt Versionsupdates npm version patch
Live-Updates Schnelle Nutzerakzeptanz Capgo’s 95% in 24 Stunden
Beta-Kanäle Gesteuerte Testphasen 1.3.0-beta.1

Versionsmarkierung vereinfacht Anwendungsaktualisierungenbehält die Benutzer glücklich und stellt sicher, dass Entwickler Releases effektiv verwalten können.

Wie Sie Ihre Capacitor Projekt ⚡️

Capacitor Framework Dokumentationswebsite

Versionseinrichtung in Capacitor

Folgen Sie diesen Schritten, um eine konsistente Versionsverwaltung auf allen Plattformen in Ihrer Capacitor-Anwendung sicherzustellen.

Die Versionsnummer in package.json

Die package.json Datei dient als Hauptquelle für die Versionsdetails Ihrer Anwendung. Hier ist ein Beispiel, 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 Regeln der semantischen Versionierung (SemVer):

  • Hauptversion (1.x.x): Einführung von verändernden Änderungen.
  • Minorversion (x.2.x): Hinzufügen neuer Funktionen, die rückwärtskompatibel sind.
  • Patchversion (x.x.3): Behebung von Fehlern oder kleine Verbesserungen.

Synchronisierung der Plattformversionen

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

Plattform Konfigurationsdatei Versionsschlüssel
iOS Info.plist CFBundleShortVersionString
Android build.gradle versionName
Web package.json version

Nachdem Sie die Version in __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ aktualisiert haben, verwenden Sie diesen Befehl, um die Änderungen mit den nativen Plattformkonfigurationen zu synchronisieren: package.jsonMit __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ für die Versionsverwaltung

npx cap sync

Using Capacitor CLI for Version Management

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 Versionsierung (SemVer) verwendet die Formatierung MAJOR.MINOR.PATCHwo jeder Teil einen bestimmten Änderungstyp anzeigt:

Versionskomponente Zweck
MAJOR Einführt Bruchänderungen in die API
MINOR Fügt neue Funktionen hinzu, die mit vorherigen Versionen kompatibel bleiben
PATCH Behebt 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 zwischen verschiedenen App-Versionen erhalten bleibt. Zum Beispiel bedeutet der Wechsel von 1.2.3 bis 2.0.0 zeigt auf, 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-Typ Wann verwenden Beispiel für Versionsänderung
Große Aktualisierung For breaking API changes or major UI redesigns 1.2.3 → 2.0.0
Kleine Aktualisierung Wenn neue Funktionen eingeführt oder Funktionen als veraltet markiert werden 1.2.3 → 1.3.0
Patching-Aktualisierung Für Bug-Fixes oder kleine Leistungsanpassungen 1.2.3 → 1.2.4

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

Kommen wir nun auf die Automatisierung dieser Updates zu, um die Release-Verwaltung zu vereinfachen.

Aktualisierung der Versionsnummer

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

  1. NPM-Versions-Scripts

Diese Skripte in Ihrem package.json Datei zum einfachen Management von Versionsupdates hinzufügen:

{
  "scripts": {
    "version:patch": "npm version patch",
    "version:minor": "npm version minor",
    "version:major": "npm version major"
  }
}
  1. Fernverwaltung
    In Ihre CI/CD-Pipeline integrieren. Capgo unterstützt Tools wie GitHub-Actions, GitLab CI, und Jenkins, was es einfach macht, den Prozess zu automatisieren.

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

Version-Tag-Methode

Git-Version-Tag

Git-Version-Labels sind eine zuverlässige Möglichkeit, die Veröffentlichungen deiner App zu verfolgen. Capacitor-App-VeröffentlichungenUm klare und informative Labels zu erstellen, kombinieren Sie die semantische Versionsnummerierung mit einer kurzen Beschreibung:

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

Um Konsistenz innerhalb deiner Team zu gewährleisten, verwenden Sie einen standardisierten Label-Format:

Label Format Beispiel
Releaseversion v[MAJOR].[MINOR].[PATCH] v1.2.3
Betaveröffentlichung v[VERSION]-beta.[NUMBER] v1.2.3-beta.1
Release Candidate v[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, erhöhen Sie die Buildnummer mit jeder Einreichung:

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

Die Buildnummer sollte immer steigen, selbst wenn die Version gleich bleibt. Dies stellt sicher, dass jede App-Store-Einreichung eindeutig identifiziert wird, während die Versionsnummerung für die Benutzer klar bleibt.

Beta-Version-Verwaltung

Die Verwaltung von Beta-Versionen erfordert ein strukturiertes Verfahren zur Verteilung von Testbuilds. Capgo’s Kanal-System Kanal-Setup

  1. __CAPGO_KEEP_0__’s Kanal-System vereinfacht dies mit den folgenden Schritten:

Erstellen Sie separate Kanäle für jede Testphase:

{
  "beta": {
    "version": "1.3.0-beta.1",
    "users": "beta-testers"
  },
  "production": {
    "version": "1.2.3",
    "users": "all"
  }
}
  1. Benutzerzugriff kontrollieren

Stellen Sie Berechtigungen ein, um zu bestimmen, wer Zugriff auf Beta-Versionen erhält. So stellen Sie sicher, dass nur genehmigte Tester Beta-Versionen erhalten, während Produktionsbenutzer stabile Releases erhalten.

  1. Versionenfolge

Bereich

Versionenformat Zweck Alpha
1.3.0-alpha.1 Interne Tests Beta
Zweck 1.3.0-beta.1 Außenstehende Testgruppe
RC (Release Candidate) 1.3.0-rc.1 Endgültige Tests vor der Veröffentlichung
Produktionsbereich 1.3.0 Öffentliche Veröffentlichung

Diese Vorgehensweise sichert eine gründliche Testung und glatte Übergänge zwischen den Entwicklungsstufen, wobei die Versionsverwaltung organisiert und transparent bleibt.

Anzeige der App-Version

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

Abrufen der Version 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ömungsfähigere Ansicht erstellen Sie eine verwendbare 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 Ihres Apps.

Version-UI-Implementierung

Hier ist ein Beispiel dafür, wie Sie die Versionsanzeige in einem Einstellungs-Komponenten integrieren können:

@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 Sie Versionsdetails anzeigen können:

Standort Zweck Implementierung
Einstellungs-Bildschirm Vollversion und Build Detaillierte Versionsinformationen
Über-Bildschirm Grundlegende Versionsanzeige Nur Versionsnummer
App-Fußzeile Minimaler Anzeige Konsolidierte Versionszeichenfolge

Zusätzlich zur 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 Benutzerfreundliche Updatebenachrichtigung 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 Updateverteilung:

Kanal Aktualisierungstyp Zielgruppe
Produktionsumgebung Stabile Versionen Alle Benutzer
Beta-Version Vorabversionen Testgruppe
Kritische Fehler Notfallkorrekturen Betroffene Benutzer

Mit dieser Methode wird die App- Zuverlässigkeit gewährleistet, während die Update-Leistung über Capgo’s Analytics-Dashboard verfolgt wird.

Version Verwaltungslösungen

Lasst uns tiefer in die fortschrittlichen Lösungen für die effektive Verwaltung von App-Versionen eintauchen.

Versionstool-Optionen

Wenn Sie Versionkontrolltools 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, auf die Sie achten sollten:

Funktion Wichtigkeit Wirkung
Live-Updates Kritisch Verzögert die Veröffentlichung durch App-Store-Bewertungen minimiert
Sicherheit Essential Datenschutz und code Integrität gewährleistet
Analyse Wichtig Erfolgsmessung und Nutzerakzeptanz
CI/CD-Integration Zuverlässig Entwicklungsprozesse optimiert
Kostenoptimierung Strategisch Langfristige Budgetplanung beeinflusst

Eines der herausragenden Werkzeuge in diesem Bereich ist Capgo, das spezielle Funktionen für Capacitor Apps.

Capgo Versionierungsmerkmale in Capacitor-Anwendungen

Capgo Live-Update-Dashboard-Interface

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

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

Hier ist ein Beispiel dafür, wie man Capgo für die Versionsverwaltung verwendet:

// 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]

Möglichkeiten für Teamgröße

Capgo bietet flexible Angebote, um Teams aller Größen zu unterstützen, sodass die Versionsverwaltung skalierbar und effizient ist.

Teamgröße Plan Schlüsselmerkmale
Solo-Entwickler Basic-Cloud-Hosting Live-Updates, 1.000 MAU
Kleinere Teams (2-5) Maker-Plan 10.000 MAU, 500 GB Bandbreite
Mittlere Teams (6-20) Team-Plan 100.000 MAU, Berechtigungen
Unternehmen Für größere Teams ermöglicht __CAPGO_KEEP_0__'s Kanal-System eine genaue Kontrolle über die Versionen bei der Bereitstellung: “Wir praktizieren agiles Entwicklung und @__CAPGO_KEEP_0__ ist mission-kritisch bei der ständigen Bereitstellung an unsere Benutzer!” - Rodrigo Mantica

Capgo bietet auch eine Analyse-Tabelle, um die Versionsanpassungs-Raten zu überwachen und potenzielle Probleme frühzeitig zu erkennen. Mit eingebauter Verschlüsselung und anpassbaren Hosting-Optionen können Teams die Sicherheit aufrechterhalten, während sie ihre Bereitstellung-Workflows skalieren.

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

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

“We practice agile development and @Capgo is mission-critical in delivering continuously to our users!” - Rodrigo Mantica [1]

Capgo also includes an analytics dashboard to monitor version adoption rates and detect potential issues early. With built-in encryption and customizable hosting options, teams can maintain security while scaling their deployment workflows.

Hauptergebnisse

Versionierung hilft Entwicklern, Updates reibungslos und zuverlässig durchzuführen. Eine ordnungsgemäße Versionskontrolle bietet klare Vorteile:

Vorteil

Enterprise

Custom PAYG Einfluss Ergebnis
Instant-Updates Kürzere Review-Zeiträume Schrittweise Nutzerakzeptanz [1]
Versionensteuerung Verbesserte code-Verwaltung Höhere Erfolgsraten [1]
Update-Überwachung Echtzeit-Monitoring Schrittweise Problemlösung [1]
Verteilungssteuerung Zielgerichtete Rollouts Unterstützung mehrerer Plattformen

Diese Ergebnisse unterstreichen die Bedeutung der Verwendung effektiver Werkzeuge zur Versionsverwaltung.

Wie man beginnt

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

  • Einrichten der Versionsverfolgung: Verwenden Sie semantische Versionsnummern in Ihrem package.json Datei und integrieren Sie die erforderlichen Plugins.
  • Hinzufügen von Update-Überprüfungen: Implementieren Sie Systeme, um Versionen zu überprüfen und zu verfolgen.
  • Konfigurieren von Verteilungs-Kanälen: Erstellen Sie separate Umgebungen für Produktion, Beta und Entwicklung.

Schließlich sollten Sie ein Live-Update-System hinzufügen, um sicherzustellen, dass die Bereitstellungen sowohl schnell als auch sicher sind.

Fortsetzen Sie mit Version Tagging in Capacitor-Anwendungen

Wenn Sie Version Tagging in __CAPGO_KEEP_0__-Anwendungen verwenden Wenn Sie Version Tagging in Capacitor-Anwendungen verwenden Um Rollbacks und Versionskontrolle zu planen, verbinden Sie es mit Rollbacks zur Implementierungsdetail in Rollbacks Versionziel zur Implementierungsdetail in Versionziel Updateverhalten zur Implementierungsdetail in Updateverhalten Bundle Für die Implementierungsdetails im Bundle und Capgo Live Updates Für die Produktworkflow in Capgo Live Updates.

Live-Updates für Capacitor-Apps

Bei einem lebenden Web-Schicht-Bug versenden Sie die Reparatur über Capgo anstatt Tage für die Genehmigung durch den App-Store abzuwarten. Die Benutzer erhalten die Aktualisierung im Hintergrund, während native Änderungen im normalen Review-Prozess bleiben.

Unterstützung von Martin

Loslegen

Neueste Beiträge aus unserem Blog

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