Panduan
Tutorial tentang Pembaruan Electron
Menggunakan @capgo/electron-updater
@capgo/electron-updater memberikan aplikasi Electron model pembaruan hidup yang sama seperti Capgo @capgo/capacitor-updater Anda menginisialisasinya di proses utama, mengekspos jembatan renderer melalui preload, dan memanggil notifyAppReady() on setiap peluncuran sehingga perlindungan rollback tahu paketnya sehat.
Pemasangan
bun add @capgo/electron-updater
Pengaturan proses utama
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());
});
Jembatan preload
import { exposeUpdaterAPI } from '@capgo/electron-updater/preload';
exposeUpdaterAPI();
Penggunaan 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 });
}
Dengarkan event pembaruan
updater.addListener('download', ({ percent }) => {
console.log('Download progress', percent);
});
updater.addListener('updateFailed', ({ bundle }) => {
console.error('Update failed', bundle.version);
});
Jalankan bundle baru
bun run build
bunx @capgo/cli@latest bundle upload --channel=production
Saran Praktis
- Selalu panggil
notifyAppReady()di awal renderer agar perlindungan rollback berfungsi sebagaimana mestinya. - Pertahankan jalur yang dibangun stabil dan biarkan pembaruan memutuskan apakah harus memuat bundle yang dikirim atau yang didownload.
- Gunakan saluran dan model peluncuran yang sama dengan Capgo yang sudah digunakan di mobile ketika aplikasi Electron Anda berbagi jalur rilis backend.
Teruskan dari Menggunakan @capgo/electron-updater
Jika Anda menggunakan Menggunakan @capgo/electron-updater untuk merencanakan pekerjaan plugin native, hubungkannya dengan Plugin @capgo/electron-updater untuk detail implementasi di @capgo/electron-updater Mulai Menggunakan Pembaruan Electron untuk detail implementasi di Mulai Menggunakan Pembaruan Electron Daftar Plugin @Capgo untuk alur kerja produk di Daftar Plugin @Capgo, Plugin @Capacitor oleh @Capgo untuk detail implementasi di Plugin @Capacitor oleh @Capgo, dan Menambahkan atau Mengupdate Plugin untuk detail implementasi di Menambahkan atau Mengupdate Plugin.