Saltare al contenuto principale
Indietro ai plugin
@capgo/electron-updater
Istruzioni
@capgo/electron-updater

Aggiornamento di Electron

Aggiornamenti in tempo reale OTA per le app di Electron con la stessa superficie di API-aggiornamento come capacitor-aggiornamento

Guida

Tutorial su Aggiornamento di Electron

Utilizzando @capgo/electron-updater

@capgo/electron-updater fornisce agli app di Electron lo stesso modello di aggiornamento in tempo reale di Capgo @capgo/capacitor-updaterSi inizializza nel processo principale, si espongono i ponti del renderer attraverso il preload e si chiama notifyAppReady() su ogni avvio affinché la protezione del rollback sappia che il pacchetto è sano.

Installazione

bun add @capgo/electron-updater

Configurazione del processo principale

import { app, BrowserWindow } from 'electron';
import path from 'node:path';
import { ElectronUpdater, setupEventForwarding, setupIPCHandlers } from '@capgo/electron-updater';

const updater = new ElectronUpdater({
  appId: 'com.example.desktop',
  autoUpdate: true,
});

app.whenReady().then(async () => {
  const window = new BrowserWindow({
    webPreferences: {
      preload: path.join(__dirname, 'preload.js'),
      contextIsolation: true,
    },
  });

  const builtinPath = path.join(__dirname, 'www/index.html');
  await updater.initialize(window, builtinPath);
  setupIPCHandlers(updater);
  setupEventForwarding(updater, window);

  await window.loadFile(updater.getCurrentBundlePath());
});

Ponte del preload

import { exposeUpdaterAPI } from '@capgo/electron-updater/preload';

exposeUpdaterAPI();

Utilizzo del renderer

import { requireUpdater } from '@capgo/electron-updater/renderer';

const updater = requireUpdater();

await updater.notifyAppReady();

const latest = await updater.getLatest();

if (latest.url && !latest.error) {
  const bundle = await updater.download({
    url: latest.url,
    version: latest.version,
    checksum: latest.checksum,
  });

  await updater.next({ id: bundle.id });
}

Ascolta gli eventi di aggiornamento

updater.addListener('download', ({ percent }) => {
  console.log('Download progress', percent);
});

updater.addListener('updateFailed', ({ bundle }) => {
  console.error('Update failed', bundle.version);
});

Deploya un nuovo bundle

bun run build
bunx @capgo/cli@latest bundle upload --channel=production

Consigli pratici

  • Chiamalo sempre notifyAppReady() all'inizio del renderer in modo che la protezione del rollback funzioni correttamente.
  • Mantieni stabile la cartella costruita e lascia che l'aggiornatore decida se caricare il bundle spedito o uno scaricato.
  • Reutilizza lo stesso canale e modello di rilascio Capgo che già utilizzi su mobile quando la tua app Electron condivide una pipeline di rilascio backend.

Continua da Utilizzo di @capgo/electron-updater

Se stai utilizzando Utilizzo di @capgo/electron-updater per pianificare il lavoro di plugin nativo, connettilo con Elettroni Updater @capgo per i dettagli di implementazione in @capgo/elettroni-updater Iniziare con Elettroni Updater per i dettagli di implementazione in Iniziare con Elettroni Updater Directory dei Plugin @Capgo per il flusso di lavoro del prodotto in Directory dei Plugin @Capgo Plugin @Capacitor di @Capgo per i dettagli di implementazione in Plugin @Capacitor di @Capgo, e Aggiungere o Aggiornare i Plugin per i dettagli di implementazione in Aggiungere o Aggiornare i Plugin.