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

Versionierung in Capacitor-Apps

Die Versionierung ist für die Verwaltung von __CAPGO_KEEP_0__-Apps unerlässlich. Sie 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 : Erfasst Updates, ermöglicht Rollbacks und sichert stabile Bereitstellungen.

  • Semantische Versionierung: Verwende
  • MAJOR.MINOR.PATCHum Bruchlinien, neue Funktionen oder Fehlerbehebungen anzuzeigen. Übertragung auf Plattformen __CAPGO_KEEP_0__
  • __CAPGO_KEEP_0__: Versionsnummern ausrichten package.json, iOS Info.plist, und Android build.gradle.
  • Automatisierung: Automatisieren Sie Updates mit npm-Skripten und CI/CD-Tools.
  • Lebendige Updates: Werkzeuge wie Capgo liefern Updates an 95% der Benutzer innerhalb von 24 Stunden.
  • Betaversionen: Verwenden Sie strukturierte Kanäle für Alpha-, Beta- und Produktionsversionen.

Rapide Vergleich

Funktion Zweck Beispiel
Semantische Versionsnummerierung Verfolgt Änderungen klar 1.2.3 → 2.0.0
Synchronisiere Versionen Übereinstimmen über Plattformen npx cap sync
Automatisierung Beschleunigt die Versionsnummernaktualisierung npm version patch
Live-Updates Schnelle Nutzerakzeptanz Capgo’s 95% in 24 Stunden
Beta-Kanäle Gesteuerte Testphasen 1.3.0-beta.1

Die Versionsmarkierung vereinfacht Anwendungsaktualisierungen,behält die Benutzer zufrieden und stellt sicher, dass Entwickler Releases effektiv verwalten können.

Wie Sie Ihren Capacitor Projekt ⚡️

Capacitor Framework-Dokumentationswebsite

Versionskonfiguration in Capacitor

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

Version setzen in package.json

Das package.json Datei dient als Hauptquelle für die Versionsdetails Ihrer Anwendung. Hier ist ein Beispiel, wie Sie es 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.
  • Minor-Version (x.2.x): Fügt neue Funktionen hinzu, die rückwärts kompatibel sind.
  • Patch-Version (x.x.3): Behebt Fehler oder macht kleine Verbesserungen.

Synchronisieren Sie die Plattformversionen

Es ist wichtig, die Versionsnummern auf allen Plattformen für eine glatte App-Veröffentlichung zu synchronisieren.

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

Nach der Aktualisierung der Version in __CAPGO_KEEP_0__ __CAPGO_KEEP_1__, 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

Capacitor CLI bietet hilfreiche Befehle zur Verwaltung von Versionen:

Ein aktualisierter Capacitor CLI sichert die Kompatibilität mit versionsspezifischen Funktionen und reduziert potenzielle Inkonsistenzen. Durch die Befolgung dieser Schritte können Sie eine ordnungsgemäße Versionsverwaltung in Ihrer App sicherstellen.

# 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

Keeping your Capacitor CLI updated ensures compatibility with version-specific features and reduces potential mismatches. Following these steps will help you maintain proper versioning in your app.

Semantische Versionsverwaltung Grundlagen

Semantische Versionsverwaltung (SemVer)

verwendet die Formatierung MAJOR.MINOR.PATCH , wobei jede Teilmenge eine bestimmte Art von Änderung anzeigt: Die __CAPGO_KEEP_0__ __CAPGO_KEEP_1__-Versionen werden wie folgt angegeben:

Komponenten-Version Zweck
MAJOR Introduziert wichtige Änderungen im 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 Anwendungsversionen erhalten bleibt. Zum Beispiel beim Wechsel von 1.2.3 bis 2.0.0 zeigt sich, dass es sich um wichtige, bruchbare Updates handelt, die sorgfältige Planung erfordern.

Wenn Sie die Versionszahlen aktualisieren sollen

Hier erfahren Sie, wie Sie die Versionsnummer entscheiden, die aktualisiert werden soll:

Update-Typ Wann verwenden Beispiel für Versionsänderung
Große Aktualisierung Für grundlegende API-Änderungen oder große UI-Umgestaltungen 1.2.3 → 2.0.0
Kleine Aktualisierung Wenn neue Funktionen einführen oder Funktionen als veraltet markieren 1.2.3 → 1.3.0
Patch-Aktualisierung Für Bug-Fixes oder kleine Leistungsverbesserungen 1.2.3 → 1.2.4

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

Lassen Sie uns nun diese Aktualisierungen automatisieren, um die Release-Verwaltung zu vereinfachen.

Version-Update-Automatisierung

Automatisierung von Version-Updates kann Zeit sparen und Fehler reduzieren in Ihrem Capacitor-Projekt. Hier ist, wie Sie es einrichten können:

  1. NPM-Versionsskripte

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 Version-Updates in Ihren CI/CD-Pipeline. Capgo unterstützt Tools wie GitHub-Actions, GitLab CI, und Jenkins , um den Prozess zu automatisieren.

“@Capgo ist ein unverzichtbares Werkzeug für Entwickler, die Produktivität durch die Umgehung langwieriger Bugfix-Reviews erzielen möchten.” - Bessie Cooper [1]

Version-Tag-Methode

Git-Version-Tag

Git-Version-Tag sind ein zuverlässiger Weg, um den Capacitor-App-Versionen zu verfolgen. 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 eine Konsistenz innerhalb Ihres Teams zu gewährleisten, verwenden Sie einen standardisierten Tag-Format:

Tag-Komponente Format Beispiel
Release-Version v[MAJOR].[MINOR].[PATCH] v1.2.3
Beta Release v[VERSION]-beta.[NUMBER] v1.2.3-beta.1
Release Candidate v[VERSION]-rc.[NUMBER] v1.2.3-rc.2

Buildnummerintegration

Buildnummernhelfen, individuelle Builds innerhalb jeder Version zu verfolgen. Für beide iOS und Android, erhöhen Sie die Buildnummer mit jeder Abgabe:

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

Die Buildnummer sollte immer ansteigen, selbst wenn die Version gleich bleibt. So wird jeder App-Store-Submission eindeutig identifiziert, während die Versionsnummerung für die Benutzer klar bleibt.

Verwaltung der Beta-Version

Um Beta-Versionen zu verwalten, ist ein strukturierter Prozess erforderlich, um Testversionen zu verteilen. Capgo’s Kanal-System erleichtert dies mit den folgenden Schritten:

  1. Kanal-Einrichtung

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. Zugriffssteuerung

Konfigurieren Sie die Berechtigungen, 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. Versionen-Progression

Verwenden Sie ein klares Versions-Progressions-System, um die Entwicklungsstufen zu verfolgen:

Entwicklungsstufe Version-Format Zweck
Alpha 1.3.0-alpha.1 Interne Testphase
Beta 1.3.0-beta.1 Externes Testteam
RC (Release Candidate) 1.3.0-rc.1 Letzter Test vor der Veröffentlichung
Produktion 1.3.0 Öffentliche Veröffentlichung

__CAPGO_KEEP_0__

App Version Anzeige

Die genaue Anzeige der Versionsinformationen in Ihrer App ist entscheidend, um Benutzer über Updates zu informieren und diese effektiv zu verwalten.

Version abrufen mit Capacitor

Sie können die 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 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 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 Versionsdetails angezeigt werden können:

Ort Zweck Implementierung
Einstellungen Bildschirm Vollversion und Build Detaillierte Versionsinformationen
Über Seite Basisversion Anzeige Versionnummer nur
App Footer Minimal Anzeige Konzentrierte Versionstring

Zusätzlich zur Anzeige von Versionsinformationen kann die Integration eines Update-Check-Systems die Benutzererfahrung verbessern.

Update-Check-System

Ein Update-Check-System stellt sicher, dass Benutzer Zugriff auf die neuesten Funktionen und Korrekturen haben. Capgo bietet Echtzeit-Nachrichten und kontrollierte Update-Kanä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 kontinuierlichen Lieferung an unsere Benutzer!” - Rodrigo Mantica [1]

Sie können auch eine Benutzerfreundliche Updatebenachrichtigung hinzufügen, wie zum Beispiel:

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

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

Kanal Update-Typ Zielgruppe
Produktion Stabile Versionen Alle Benutzer
Beta Vorab-Versionen Testgruppe
Kritisch Dringende Reparaturen Betroffene Benutzer

Mit dieser Methode wird die App-Verlässlichkeit gewährleistet, während die Update-Leistung über Capgo’s Analytics-Dashboard überwacht wird.

Lösungen für die Versionsverwaltung

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

Optionen für die Versionswerkzeuge

Bei der Auswahl von Versionskontrollwerkzeugen ist es wichtig, sich auf solche zu konzentrieren, die Updates vereinfachen, Ihre code sichern 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 durch App-Store-Bewertungen minimiert
Sicherheit Wichtig Sichert Nutzerdaten und code-Integrität
Analytik Wichtig Messung der Update-Erfolge und Nutzerakzeptanz
CI/CD-Integration Nützlich Deploymentsprozesse optimiert
Kostenoptimierung Strategisch Beeinflusst die langfristige Budgetplanung

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

Capgo Versionierungsmerkmale

Capgo Live-Update-Dashboard-Interface

Capgo bietet robuste Versionierungsmanagementfunktionen, einschließlich:

  • 23,5 Mio. erfolgreiche Updates geliefert
  • 95% der Benutzer wurden innerhalb von 24 Stunden aktualisiert
  • 82% globale Erfolgsrate
  • 434ms Durchschnitts API Antwortzeit weltweit

Hier ist ein Beispiel dafür, wie man Capgo für die Versionskontrolle 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
    });
  }
};

“We are currently giving a try to @Capgo since Appcenter stopped live updates support on hybrid apps and @AppFlow is way too expensive.” - Simon Flack [1]

Teamgröße Lösungen

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

Teamgröße Plan Hauptmerkmale
Einzelentwickler Grundlegende Cloud-Hosting Live-Updates, 1.000 MAU
Kleine Team (2-5) Maker plan 10.000 MAU, 500 GB Bandbreite
Medium Team (6-20) Team plan 100.000 MAU, Berechtigungen
Unternehmen Zahlung nach Verbrauch (PAYG) nach Maß Unbegrenzte MAU, dedizierte Support

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

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 Bereitstellung an unsere Benutzer!” - Rodrigo Mantica [1]

Capgo umfasst auch ein Analytics-Dashboard, um die Akzeptanzraten von Versionen 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.

Zusammenfassung

Verständnis der Versionsmarkierung ist entscheidend, um die Entwicklung und die Bereitstellung von Prozessen zu vereinfachen. Hier ist eine kurze Zusammenfassung der wichtigsten Ideen und Schritte, um loszulegen.

Schlüssel-Erkenntnisse

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

Vorteil Auswirkung Ergebnis
Instante Updates Kürzere Review-Zeiträume Schrittweiseere Nutzeranpassung [1]
Versionskontrolle Bessere code-Verwaltung Höhere Erfolgsraten [1]
Update Tracking Echtzeit-Monitoring Schnellere Problemlösung [1]
Verteilungskontrolle Zielgerichtete Release Unterstützung für mehrere Plattformen

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 Versionierung in Ihrem package.json Datei und integrieren Sie die notwendigen Plugins.
  • Aktualisierungsprüfungen hinzufügen: Implementiere Systeme zur Überprüfung und zum Verfolgen von Versionsupdates.
  • Verteilungskanäle konfigurieren: Erstelle separate Umgebungen für Produktion, Beta und Entwicklung.

Zum Schluss solltest du auch einen Live-Update-System in Betracht ziehen, um sicherzustellen, dass die Bereitstellungen sowohl schnell als auch sicher sind.

Weitermachen von Version-Tagging in Capacitor Apps

Wenn du Version-Tagging in __CAPGO_KEEP_0__ Apps verwendest, um Rollbacks und Versionskontrolle zu planen, verbinde es mit Version Tagging in Capacitor Apps für die Implementierungsdetails in Rollbacks, Version-Targeting Wenn du Version-Tagging in __CAPGO_KEEP_0__ Apps verwendest, um Rollbacks und Versionskontrolle zu planen, verbinde es mit Rollbacks. Wenn du Version-Tagging in __CAPGO_KEEP_0__ Apps verwendest, um Rollbacks und Versionskontrolle zu planen, verbinde es mit Rollbacks. für die Implementierungsdetails in Version Zielsetzung Aktualisierungsverhalten für die Implementierungsdetails in Aktualisierungsverhalten, Bündel für die Implementierungsdetails in Bündel, und Capgo Live Updates für das Produktworkflow in Capgo Live Updates.

Echtzeit-Updates für Capacitor-Apps

Wenn ein Fehler im Web-Schicht lebt, liefern Sie die Reparatur über Capgo anstatt Tage für die Genehmigung des App-Store abzuwarten. Die Benutzer erhalten das Update im Hintergrund, während native Änderungen im normalen Review-Path bleiben.

Jetzt loslegen

Neuestes aus unserem Blog

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