Zum Hauptinhalt springen
@capgo/capacitor-updater Updates Open Source

Updater Capacitor Plugin

Deploye Ionic und Capacitor Live Updates sofort an deine Nutzer, ohne Verzögerungen durch App Store Reviews

Installieren

bun add @capgo/capacitor-updater bunx cap sync
npm, pnpm oder yarn
  • npm install @capgo/capacitor-updater
  • pnpm add @capgo/capacitor-updater
  • yarn add @capgo/capacitor-updater

Anleitung

Updater in Capacitor nutzen

Auf dem Gerät testen

Lade die Capgo App herunter und scanne den QR code.

QR code zur Updater-Plugin-Vorschau

Ionic und Capacitor Live Updates mit @capgo/capacitor-updater

@capgo/capacitor-updater ist das Open-Source Updater-Plugin hinter den Capgo Live Updates für Ionic und Capacitor Apps. Es lädt freigegebene Web-Bundles herunter, wendet sie mit nativem Rollback-Schutz an und hält binäre Änderungen auf dem regulären App Store und Play Store Review-Pfad.

Nutze es, wenn du OTA-Updates für HTML, CSS, JavaScript, Assets und andere Web-Layer-Änderungen benötigst, nachdem dein Native Shell bereits freigegeben wurde.

Installieren

npm install @capgo/capacitor-updater
npx cap sync

Wo es passt

Für Ionic-Teams bedeuten Live Updates meist denselben Workflow: Ein neues Web-Bundle ausrollen, ohne jeden Nutzer durch ein komplettes Store-Release zu zwingen. Capgo übernimmt diesen Workflow für Capacitor Apps mit Channels, Kompatibilitätsprüfungen, Rollout-Steuerung, Device Logs und Rollback.

Native Plugins, Entitlements, Android Manifest-Änderungen, iOS plist-Änderungen und binäre SDK Updates erfordern weiterhin ein normales App Store Release. Behalte diese Änderungen in deiner Native Build Pipeline und nutze Live Updates für den freigegebenen Web-Layer.

Was dieses Plugin bereitstellt

  • notifyAppReady - Benachrichtigt den Native Layer, dass JavaScript erfolgreich initialisiert wurde.
  • setUpdateUrl - Setzt die Update-URL der App dynamisch zur Laufzeit.
  • setStatsUrl - Setzt die Statistics-URL der App dynamisch zur Laufzeit.
  • setChannelUrl - Setzt die Channel-URL der App dynamisch zur Laufzeit.

Anwendungsbeispiel

notifyAppReady

Benachrichtigt den Native Layer, dass JavaScript erfolgreich initialisiert wurde.

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

const result = await CapacitorUpdater.notifyAppReady();
console.log(result);

setUpdateUrl

Setzt die Update-URL der App dynamisch zur Laufzeit.

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

await CapacitorUpdater.setUpdateUrl({ url: 'https://example.com' });

setStatsUrl

Setzt die Statistics-URL der App dynamisch zur Laufzeit.

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

await CapacitorUpdater.setStatsUrl({ url: 'https://example.com' });

setChannelUrl

Setzt die Channel-URL der App dynamisch zur Laufzeit.

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

await CapacitorUpdater.setChannelUrl({ url: 'https://example.com' });

Vollständige Referenz

Weiter geht's mit @capgo/capacitor-updater

Wenn du es nutzt @capgo/capacitor-updater Um Live Updates zu planen, verbinde es mit Capgo Live Updates für den Produkt-Workflow, @capgo/capacitor-updater für Implementierungsdetails, Erste Schritte, Kanäle, und Rollbacks.

FAQ

FAQ zum Updater-Plugin

Wie installiere ich das Updater-Plugin in einer Capacitor-App?

Führe "bun add @capgo/capacitor-updater" (oder "npm install @capgo/capacitor-updater") aus, danach "bunx cap sync", damit die iOS- und Android-Projekte das native code übernehmen. Importiere es in deiner App code aus "@capgo/capacitor-updater".

Funktioniert @capgo/capacitor-updater mit React, Vue und Angular?

Ja. Der Updater ist ein Capacitor-Package und funktioniert daher mit jedem Web-Framework, das in Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und reinem JavaScript.

Welche Capacitor-Version unterstützt @capgo/capacitor-updater?

Capgo Plugins folgen der Major-Version von Capacitor: Nutze die Plugin-Major-Version, die zu deiner Capacitor Major-Version passt (z. B. Plugin v8 bei Capacitor 8). Die Kompatibilitätstabelle im GitHub README listet die gepflegten Versionen auf.

Ist @capgo/capacitor-updater kostenlos und Open Source?

Ja. Der Source Code von code ist öffentlich auf GitHub unter https://github.com/Cap-go/capacitor-updater/ und das Package lässt sich kostenlos über npm installieren. Bug-Reports und Pull Requests sind willkommen.

Kann ich code, das Updater nutzt, ohne App-Store-Review aktualisieren?

Die Installation oder ein Upgrade des Plugins ändert den nativen code, weshalb ein neuer Store-Build nötig ist. Danach können JavaScript-, HTML- und CSS-Änderungen, die das Plugin aufrufen, sofort per Capgo Live Updates ausgeliefert werden.

Updater-Änderungen veröffentlichen, ohne auf den App-Review zu warten

Sobald das Plugin in deinem Store-Build ist, bringt Capgo mit Live-Updates deine JavaScript-, HTML- und CSS-Änderungen in Minuten zu den Nutzern.

Starte mit Capgo