Anleitung
Tutorial zum Electron-Updater
Verwendung von @capgo/electron-updater
@capgo/electron-updater Elektron-Anwendungen erhalten den gleichen Capgo-Live-Update-Modell wie @capgo/capacitor-updater. Sie initialisieren es im Hauptprozess, legen den Renderer-Brücke über den Vorkomma frei und rufen notifyAppReady() Installation
Hauptprozess-Einrichtung
bun add @capgo/electron-updater
Vorkomma-Brücke
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());
});
Installation des Hauptprozesses
import { exposeUpdaterAPI } from '@capgo/electron-updater/preload';
exposeUpdaterAPI();
Renderer-Anwendung
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 });
}
Hören Sie auf Update-Ereignisse
updater.addListener('download', ({ percent }) => {
console.log('Download progress', percent);
});
updater.addListener('updateFailed', ({ bundle }) => {
console.error('Update failed', bundle.version);
});
Bereitstellen Sie ein neues Bundle
bun run build
bunx @capgo/cli@latest bundle upload --channel=production
Praktische Tipps
- Rufen Sie immer auf
notifyAppReady()frühzeitig im Renderer, damit die Rollover-Schutzfunktion wie vorgesehen funktioniert. - Halten Sie den internen Pfad stabil und lassen Sie den Updater entscheiden, ob er das gelieferte Bundle oder ein heruntergeladenes laden soll.
- Wiederholen Sie die gleiche Capgo-Kanal- und Rollout-Modell, das Sie bereits auf mobilen Geräten verwenden, wenn Ihre Electron-Anwendung eine gemeinsame Backend-Release-Pipeline verwendet.
Fortsetzen Sie mit @capgo/electron-updater
Wenn Sie Mit @capgo/electron-updater zur Planung von native Plug-in-Arbeiten verwenden, verbinden Sie es mit @capgo/electron-updater for the implementation detail in @capgo/electron-updater, Anleitung zum Starten mit Elektron-Updater zur Implementierungsdetail in Anleitung zum Starten mit Elektron-Updater Capgo Plugin-Verzeichnis zur Produktworkflow in Capgo Plugin-Verzeichnis Capacitor Plugins von Capgo zur Implementierungsdetail in Capacitor Plugins von Capgo, und Plugins hinzufügen oder aktualisieren zur Implementierungsdetail in Plugins hinzufügen oder aktualisieren.