가이드
Electron에서 Electron Updater 사용 방법
@capgo/electron-updater 사용하기
@capgo/electron-updater Electron 앱에 Capgo 라이브 업데이트 모델을 그대로 제공합니다. @capgo/capacitor-updater메인 프로세스에서 초기화하고, preload를 통해 renderer bridge를 노출한 뒤 호출하세요. notifyAppReady() 매 실행 시 롤백 보호가 번들이 정상임을 알 수 있도록 합니다.
설치
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 채널과 롤아웃 모델을 재사용하세요.
@capgo/electron-updater 사용하기 단계부터 계속 진행하세요
사용 중이라면 @capgo/electron-updater 사용하기 네이티브 플러그인 작업을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/electron-updater @capgo/electron-updater의 구현 세부 사항은 Electron Updater 시작하기 Electron Updater 시작하기에서의 구현 세부 사항은 Capgo 플러그인 디렉토리 Capgo Plugin Directory의 제품 워크플로우에 맞춰, Capgo의 Capacitor 플러그인 Capgo의 Capacitor Plugins 구현 세부 사항 및 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트의 구현 세부 사항은.