Getting Started

Installation

Sie können unsere AI-gestützte Einrichtung verwenden, um das Plugin zu installieren. Fügen Sie den Capgo-Fähigkeiten Ihrer KI-Tool mithilfe der folgenden Befehl hinzu:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Verwenden Sie dann die folgende Anfrage:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-updater` plugin in my project.

Wenn Sie die manuelle Einrichtung bevorzugen, installieren Sie das Plugin, indem Sie die folgenden Befehle ausführen und die Plattform-spezifischen Anweisungen unten befolgen:

npm

bun add @capgo/capacitor-updater
bunx cap sync

yarn

yarn add @capgo/capacitor-updater
bunx cap sync

pnpm

pnpm add @capgo/capacitor-updater
bunx cap sync

bun

bun add @capgo/capacitor-updater
bunx cap sync

Rapidstart

Für die meisten Benutzer empfehlen wir die Verwendung des Hauptanleitungsprogramms das sowohl die Plugin-Installation als auch die Capgo-Cloud-Integration abdeckt.

Dieses Anleitungskonzept konzentriert sich auf die technischen Plugin-Details für fortgeschrittene Benutzer, die die zugrunde liegenden Mechanismen verstehen möchten oder selbst gehostete Updates implementieren möchten.

Übersicht

The Capacitor Updater plugin enables over-the-air (OTA) updates for your Capacitor applications. This allows you to push updates to your app without going through app store reviews.

Sektion mit dem Titel ‘Wie es funktioniert’

1. Rapidstart Anleitung: Die Erweiterung lädt Aktualisierungs-Pakete (ZIP-Dateien, die Ihre Web-Assets enthalten) herunter
2. Extraktion: Die Pakete werden auf dem Gerätespeicher extrahiert
3. Hot Reload: Die App wechselt zum neuen Paket, ohne dass ein Neustart erforderlich ist
4. Fallback: Wenn eine Aktualisierung fehlschlägt, kehrt die App zur vorherigen funktionierenden Version zurück

Verwendungsmöglichkeiten

1. Automatischer Aktualisierungsmodus (Empfohlen)

Der einfachste Weg, die Erweiterung mit automatischer Aktualisierungsverwaltung zu verwenden:

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

// Plugin handles everything automatically
// Configure in capacitor.config.ts

Hinzufügen zu Ihrem capacitor.config.ts:

{
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'atBackground',
      updateUrl: 'https://your-update-server.com/api/updates'
    }
  }
}

2. Manueller Modus

Für eine erweiterte Kontrolle über den Updateprozess:

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

// Download an update
const bundle = await CapacitorUpdater.download({
  url: 'https://your-server.com/updates/v1.0.1.zip',
  version: '1.0.1'
});

// Set the bundle (will be used on next app start)
await CapacitorUpdater.set({
  id: bundle.id
});

// Or reload immediately
await CapacitorUpdater.reload();

Plattform-Konfiguration

iOS

Keine zusätzliche Konfiguration erforderlich. Der Plugin funktioniert direkt aus der Box.

Android

Keine weitere Konfiguration erforderlich. Der Plugin funktioniert direkt aus der Box.

Grundlegende API Verwendung

Ein Update herunterladen

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

const bundle = await CapacitorUpdater.download({
  url: 'https://example.com/update.zip',
  version: '1.0.1'
});

console.log('Downloaded bundle:', bundle.id);

Aktives Bundle setzen

// Set bundle to be used on next app start
await CapacitorUpdater.set({
  id: bundle.id
});

Mit neuem Bundle neu laden

// Reload app immediately with new bundle
await CapacitorUpdater.reload();

Bundle-Liste

const { bundles } = await CapacitorUpdater.list();
console.log('Available bundles:', bundles);

Bundle löschen

await CapacitorUpdater.delete({
  id: 'bundle-id'
});

Aktuelles Bundle abrufen

const { bundle } = await CapacitorUpdater.current();
console.log('Current bundle:', bundle.version);

Event-Listener

Hören Sie auf Update-Ereignisse:

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

// Listen for download progress
CapacitorUpdater.addListener('download', (info) => {
  console.log('Download progress:', info.percent);
});

// Listen for download completion
CapacitorUpdater.addListener('downloadComplete', (bundle) => {
  console.log('Download complete:', bundle.version);
});

// Listen for update failures
CapacitorUpdater.addListener('updateFailed', (error) => {
  console.error('Update failed:', error);
});

// Listen for successful updates
CapacitorUpdater.addListener('updateAvailable', (info) => {
  console.log('Update available:', info.version);
});

Konfigurationsoptionen

Konfigurieren Sie das Plugin in Ihrem capacitor.config.ts:

{
  plugins: {
    CapacitorUpdater: {
      // Auto-update settings
      autoUpdate: 'atBackground',
      updateUrl: 'https://api.example.com/updates',

      // Update behavior
      resetWhenUpdate: true,

      // Version settings
      version: '1.0.0',

      // Security
      allowModifyUrl: false,

      // Stats collection
      statsUrl: 'https://api.example.com/stats',

      // Channel (for Capgo cloud)
      defaultChannel: 'production'
    }
  }
}

Integrationsmuster

Mit Capgo Cloud

Der einfachste Weg, loszulegen:

// Install the Capgo CLI
bun add -g @capgo/cli

// Login to Capgo
npx @capgo/cli login

// Upload your first bundle
npx @capgo/cli bundle upload

// The plugin auto-updates from Capgo cloud

Siehe das Hauptanleitung zum Schnellstart für Details.

Selbstgeführte Updates

Hosten Sie Ihren eigenen Update-Server:

// Configure your update endpoint
{
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'atBackground',
      updateUrl: 'https://your-server.com/api/check-update'
    }
  }
}

Ihr Server sollte folgendes zurückgeben:

{
  "version": "1.0.1",
  "url": "https://your-server.com/updates/1.0.1.zip"
}

Siehe Selbstgeführter Modus für weitere Details.

Manueller Aktualisierungsprozess

Vollständige Kontrolle über Aktualisierungen:

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

async function checkAndUpdate() {
  // Check for updates from your server
  const response = await fetch('https://api.example.com/check-update');
  const { version, url } = await response.json();

  // Download the update
  const bundle = await CapacitorUpdater.download({
    url,
    version
  });

  // Notify bundle is ready
  await CapacitorUpdater.notifyAppReady();

  // Set as next version
  await CapacitorUpdater.set({ id: bundle.id });

  // Reload when ready
  await CapacitorUpdater.reload();
}

Gute Praktiken

• Rufen Sie immer notifyAppReady() Wenn Ihre App erfolgreich geladen wird
• Testen Sie Aktualisierungen gründlich, bevor Sie sie in die Produktion übernehmen
• Implementieren Sie eine ordnungsgemäße Fehlerbehandlung für Netzwerkfehler
• Verwenden Sie Versionsnummern konsistent
• Kleine Bundle-Größen für schnellere Downloads
• Überwachung der Erfolgsraten von Updates

Zukünftige Schritte

• Plugin API Reference Plugin API-Referenz
• - Vollständige __CAPGO_KEEP_0__-Dokumentation Plugin-Einstellungen
• - Alle Konfigurationsoptionen Events
• - Verfügbare Update-Ereignisse Eigenständiger Modus (Self-Hosted Mode) - Deinen eigenen Update-Server betreiben
• Entwicklungs-Überwachung - Lokale Updates testen
• Debugging - Fehlerbehebungshinweise

Unterstützung

• Unterstützung - Gemeinsame Probleme und Lösungen
• GitHub Diskussionen - Community-Unterstützung
• Discord - Echtzeit-Chat

Fortsetzung aus Getting Started

Wenn Sie native Plugin-Arbeit planen, verbinden Sie es mit Getting Started um native Plugin-Arbeit zu planen, verbinden Sie es mit Verwenden Sie @capgo/capacitor-Updater Verwenden Sie @capgo/capacitor-Updater für die native Fähigkeit in Verwenden Sie @capgo/capacitor-Updater Capgo Plugin-Verzeichnis Capgo Plugin-Verzeichnis für den Produktworkflow Capacitor Plugins von Capgo Capacitor Plugins von Capgo für die Implementierungsdetails Hinzufügen oder Aktualisieren von Plugins für die Implementierungsdetails in Plugins hinzufügen oder aktualisieren und Ionic Enterprise-Plugin-Alternativen für den Produktworkflow in Ionic Enterprise-Plugin-Alternativen.