Von V2 zu V3

Diese Dokumentation erklärt dir, wie du auf die Version 3 von auto-update upgradest.

Migriere zuerst auf das neueste Tooling:

npm remove -g capgo
npm remove capacitor-updater

npm i @capgo/cli
npm i @capgo/capacitor-updater@3
npx cap sync

Entferne deine gesamte bisherige Konfiguration:

{
  CapacitorUpdater: {
      autoUpdateURL: "https...",
      ...
  },
}

damit nur noch das hier übrig bleibt:

{
  "CapacitorUpdater": {
    "autoUpdate": true
  }
}

⚠️ Falls du deinen eigenen Server genutzt hast, mit autoUpdateURL, werde ich diese Anleitung bald für dich aktualisieren. Schau dir in der Zwischenzeit die neue Upload-Option an, external mit der du nur den Link deiner ZIP-Datei senden kannst, statt des code in der Capgo Cloud. Das wurde für Unternehmen mit strengen Datenschutzrichtlinien entwickelt. Im externen Modus landet der code niemals auf dem Capgo Server; wir speichern nur die URL und senden sie an das Gerät, das sie dann direkt herunterlädt. Im Standardmodus wird der code gezippt und auf unserem Server gespeichert, aber wir werden ihn niemals öffnen oder verwenden.

Was sich ändert

Alle Konfigurationen für Auto-Updates liegen nun serverseitig, um dir mehr Kontrolle darüber zu geben, wie du ein Update an Nutzer ausrollst.

Dadurch können wir Rollbacks durchführen oder via Channels sogar nur an einen einzelnen User deployen! Diese Einstellungen wurden im Web-Interface wieder hinzugefügt:

• Revert unter Native deaktivieren
• Update über Major deaktivieren

⚠️ Diese werden standardmäßig für alle Channels auf true gesetzt

Dadurch musst du das Plugin nicht mehr so oft aktualisieren. Die meisten Updates erfolgen serverseitig, und du bekommst sie ohne Änderungen auf deiner Seite.

⚠️ Wird zurückgesetzt, sobald ein Update zum Standard wird. Wenn du beim Update aus dem Store nicht alle Download-Versionen entfernen möchtest, gehe so vor:

{
  "CapacitorUpdater": {
    "autoUpdate": true,
    "resetWhenUpdate": false
  }
}

Aktualisiere dein code

Zuletzt aktualisiere alle JS-Imports von:

import { CapacitorUpdater } from 'capacitor-updater'

zu

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

Baue dein code anschließend neu npm run build und kopiere die Assets erneut npx cap copy.

Du solltest jetzt das neueste Auto-Update-System testen können

Sende deine Version mit:

npx @capgo/cli@latest bundle upload

anstatt

npx capgo upload

Zukünftige Entwicklung

Derzeit wird nur der erste Public Channel genutzt; in Zukunft steht „public“ für mehrere Public Channels, wenn mehr als einer gesetzt ist.

Häufige Probleme:

• Build-Probleme nach dem Upgrade: Falls Sie den code des Plugins bereits in Android Studio oder Xcode geöffnet haben, entfernt der Sync diese manchmal nicht, was die Ursache ist. Öffnen Sie die native IDE und entfernen Sie capacitor-updater manuell; das sollte npx cap sync das Problem lösen.

Weiter bei „Von V2 zu V3“

Wenn du es nutzt Von V2 zu V3 um die Auslieferung von live update zu planen, verbinde sie mit Capgo Live Updates für den Produkt-Workflow in Capgo Live Updates, Übersicht für die Implementierungsdetails in Overview, Funktionen für die Implementierungsdetails in Features, Update-Verhalten für die Implementierungsdetails in Update Behavior und Update-Typen für die Implementierungsdetails in Update Types.