ガイド
Electron アップデートの使用方法
Electronで@capgo/electron-updaterを使用
@capgo/electron-updater CapgoのライブアップデートモデルをElectronアプリに与える @capgo/capacitor-updaterを実行すると、Electronアプリに__CAPGO_KEEP_0__のライブアップデートモデルが与えられます。 notifyAppReady() を初期化して、メインプロセスで実行し、プリロードでレンダラーのブリッジを公開し、
Installation
bun add @capgo/electron-updater
インストール
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());
});
メインプロセス設定
import { exposeUpdaterAPI } from '@capgo/electron-updater/preload';
exposeUpdaterAPI();
プリロードブリッジ
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 });
}
レンダラーの使用
updater.addListener('download', ({ percent }) => {
console.log('Download progress', percent);
});
updater.addListener('updateFailed', ({ bundle }) => {
console.error('Update failed', bundle.version);
});
アップデートイベントを待つ
bun run build
bunx @capgo/cli@latest bundle upload --channel=production
新しいバンドルを展開する
- 常に呼び出す
notifyAppReady()レンダラー内で早く呼び出すことにより、ロールバック保護が意図どおりに機能するようにします。 - ビルトインパスを安定させ、アップデータが配布されたバンドルかダウンロードしたバンドルを読み込むかを決定するようにします。
- 既存のモバイルアプリでバックエンドリリースパイプラインを共有しているElectronアプリでは、同じCapgoチャンネルとロールアウトモデルを再利用してください。
Using @capgo/electron-updater
あなたが使用している @capgo/エレクトロンアップデーター native plugin work を計画するには、を接続する @capgo/エレクトロンアップデーター @capgo/electron-updaterの実装詳細 Electron アップデータの導入 Getting Started with Electron Updaterの実装詳細 Capgo プラグイン ディレクトリ Capgo プラグイン ディレクトリの製品ワークフロー用 Capacitor プラグイン (Capgo によって提供) Capacitor プラグイン (Capgo によって提供)の実装詳細 プラグインの追加または更新 __CAPGO_KEEP_0__ プラグイン (__CAPGO_KEEP_1__ によって提供)の実装詳細