Auto actualización

Here’s the German translation:

Dieser Modus ermöglicht Entwicklern die Verwendung von capacitor-updater im Auto-Update-Modus und das Pushen von Updates über Capgo-Kanäle oder Äquivalente.

Voraussetzungen

Stellen Sie sicher, dass Ihre App-Version https://semverorg/ verwendet, bevor Sie Capgo Auto-Update nutzen.

Dies ist die Konvention, die verwendet wird, um Versionen in Capgo zu verwalten.

Es gibt zwei Möglichkeiten, die Version in Ihrer App festzulegen:

Neue Methode: Verwenden Sie das version-Feld in Ihrer capacitorconfigjson-Datei

{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": true, // Auto-Update aktivieren, standardmäßig true
      "appId": "comexampleapp", // Wird zur Identifizierung der App auf dem Server verwendet
      "version": "100" // Wird zur Überprüfung auf Updates verwendet
    }
  }
}

Diese Optionen werden vom Plugin zur Überprüfung auf Updates und von der CLI zum Hochladen der Version verwendet.

Alte Methode: In 3 Dateien in Ihrem Projekt:

packagejson in version
android/app/buildgradle in versionName
ios/App/Appxcodeproj/projectpbxproj in CURRENT_PROJECT_VERSION

Tutorials

Richten Sie Ihre App in 5 Minuten ein

Aktualisieren Sie Ihre Capacitor-Apps nahtlos mit Capacitor Updater

Richten Sie Ihre CI in 5 Minuten ein

Automatischer Build und Release mit GitHub Actions

Installation

npm install @capgo/capacitor-updater
npx cap sync

Einführung

Klicken Sie auf Registrieren, um Ihr Konto zu erstellen

Der Server ermöglicht es Ihnen, Kanäle und Versionen und vieles mehr zu verwalten

autoUpdate verwendet Daten aus capacitorconfig, um den Capgo-Server zu identifizieren

Version validieren

Wenn Auto-Update eingerichtet ist, müssen Sie von JavaScript aus mitteilen, dass Ihre App aktiv und bereit ist

Dies kann durch den Aufruf von notifyAppReady in Ihrer App erfolgen

Tun Sie dies so früh wie möglich

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

CapacitorUpdaternotifyAppReady()

Benutzer-Ablauf

Benutzer öffnet die App, die App ruft den Server ab, um nach Updates zu suchen, wenn Updates gefunden werden, werden sie im Hintergrund heruntergeladen
Benutzer verlässt die App, die neue Version wird als aktiv gesetzt
Benutzer öffnet die App erneut, wir laden die neue aktive Version und setzen sie als Standard
Wenn notifyAppReady() aufgerufen wird, wird die vorherige Version gelöscht, wenn der Benutzer die App verlässt
Benutzer setzt den normalen App-Ablauf fort bis zum nächsten Update-Zyklus

Entwickler-Ablauf

Wenn Sie neue Funktionen entwickeln, stellen Sie sicher, dass Sie autoUpdate blockieren, da Capgo sonst ständig Ihre Arbeit mit dem neuesten Update-Bundle überschreibt Setzen Sie autoUpdate in Ihrer Konfiguration auf false Falls Sie aus irgendeinem Grund bei einem Update festhängen, können Sie die App löschen und neu installieren Stellen Sie sicher, dass Sie autoUpdate in Ihrer Konfiguration auf false setzen, bevor Sie dies tun Und bauen Sie sie dann erneut mit Xcode oder Android Studio

Um die Version bei jedem Commit hochzuladen, richten Sie CI/CD mit dieser Anleitung ein

Automatischer Build und Release mit GitHub Actions

Major Available Event

Wenn disableAutoUpdateBreaking auf true gesetzt ist, können Sie auf das Event hören, um zu erfahren, wann die App sich weigert, ein Major Breaking Update durchzuführen

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

CapacitorUpdateraddListener('majorAvailable', (info: any) => {
  consolelog('majorAvailable wurde ausgelöst', infoversion)
})