Referensi Electron Updater API

Metode Utama

Judul bagian “Metode Utama”

notifyAppReady()

Harus dipanggil pada setiap peluncuran aplikasi. Mengkonfirmasi bahwa bundle telah dimuat dengan sukses dan mencegah rollback otomatis.

await updater.notifyAppReady();

Peringatan

Jika tidak dipanggil dalam appReadyTimeout (10 detik default), update dianggap gagal dan aplikasi kembali ke versi sebelumnya.

download(options)

Unduh bundle dari URL.

const bundle = await updater.download({
  url: 'https://example.com/bundle.zip',
  version: '1.0.1',
  checksum: 'sha256-hash', // Optional but recommended
  sessionKey: '...', // For encrypted bundles
});

Parameter:

Opsi	Tipe	Diperlukan	Deskripsi
url	string	Ya	URL untuk mengunduh bundle dari
version	string	Ya	Identifikasi versi untuk bundle
checksum	Bahasa Indonesia	Tidak	SHA256 untuk verifikasi
sessionKey	Tidak	Kunci sesi untuk bundle yang dienkripsi	Kembali:

objek dengan BundleInfo next(options) id, version, status

Judul bagian “next(options)”

Salin ke clipboard

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

Parameter:

Pilihan	Tipe	Diperlukan	Deskripsi
id	string	Ya	ID Paket untuk antrian

set(options)

Segera berganti ke paket dan muat ulang aplikasi.

await updater.set({ id: 'bundle-id' });

Parameter:

Pilihan	Tipe	Diperlukan	Deskripsi
id	string	Iya	ID Paket untuk Mengaktifkan

reload()

Meng_reload Aplikasi secara Manual dengan Paket yang Sementara

await updater.reload();

hapus(options)

Hapus sebuah bundle dari penyimpanan.

await updater.delete({ id: 'bundle-id' });

Parameter:

Option	Tipe	Wajib	Deskripsi
id	string	Ya	ID Bundle untuk dihapus

reset(options)

Reset ke versi bawaan atau bundle terakhir yang sukses.

// Reset to builtin
await updater.reset({ toLastSuccessful: false });

// Reset to last successful bundle
await updater.reset({ toLastSuccessful: true });

Parameter:

Pilihan	Tipe	Wajib	Deskripsi
toLastSuccessful	boolean	Tidak	Jika true, reset ke bundle terakhir yang sukses bukan versi bawaan

Informasi Paket

current()

Dapatkan informasi tentang paket saat ini dan versi native.

const info = await updater.current();
// { bundle: { id, version, status }, native: '1.0.0' }

list(options)

Tampilkan semua paket yang diunduh.

const bundles = await updater.list();
// [{ id, version, status, downloaded, checksum }, ...]

getNextBundle()

Ambil bundle yang ditunggu untuk restart berikutnya.

const next = await updater.getNextBundle();
// { id, version, status } or null

getFailedUpdate()

Dapatkan informasi tentang update terakhir yang gagal (bermanfaat untuk debugging rollback).

const failed = await updater.getFailedUpdate();
// { id, version, reason } or null

getBuiltinVersion()

Dapatkan versi yang dikirimkan bersama dengan file biner aplikasi.

const version = await updater.getBuiltinVersion();
// '1.0.0'

Pengecekan Update

getTerbaru(options)

Periksa server untuk versi terbaru yang tersedia.

const latest = await updater.getLatest();

if (latest.url && !latest.error) {
  // Update available
  console.log('New version:', latest.version);
  console.log('Download URL:', latest.url);
} else if (latest.error) {
  console.error('Error checking updates:', latest.error);
}

Mengembalikan:

Sifat	Tipe	Deskripsi
url	string	URL Unduh (kosong jika tidak ada update)
version	string	Versi tersedia
checksum	string	Checksum SHA256
sessionKey	string	Kunci Enkripsi Sesi
error	string	Pesan Kesalahan Jika Cek Gagal
message	string	Pesan Server

Pengelolaan Saluran

setChannel(options)

Tetapkan perangkat ke saluran tertentu.

await updater.setChannel({ channel: 'beta' });

unsetChannel(options)

Hapus penugasan saluran dan gunakan default.

await updater.unsetChannel();

getChannel()

Dapatkan penugasan saluran saat ini.

const channel = await updater.getChannel();
// { channel: 'production', status: 'set' }

listChannels()

Daftar semua saluran yang tersedia untuk aplikasi ini.

const channels = await updater.listChannels();
// ['production', 'beta', 'staging']

Kondisi Delay

Kontrol kapan pembaruan yang diunduh diterapkan.

setMultiDelay(options)

Tetapkan kondisi yang harus dipenuhi sebelum pembaruan diterapkan.

// Wait for app to be backgrounded
await updater.setMultiDelay({
  delayConditions: [{ kind: 'background' }]
});

// Wait until specific date
await updater.setMultiDelay({
  delayConditions: [{ kind: 'date', value: '2024-12-25T00:00:00Z' }]
});

// Wait for app to be killed and restarted
await updater.setMultiDelay({
  delayConditions: [{ kind: 'kill' }]
});

// Multiple conditions (all must be met)
await updater.setMultiDelay({
  delayConditions: [
    { kind: 'background' },
    { kind: 'date', value: '2024-12-25T00:00:00Z' }
  ]
});

Jenis Kondisi Delay:

Jenis	Nilai	Deskripsi
background	__CAPGO_KEEP_0__ (ms)	Tunggu aplikasi menjadi background
kill	-	Tunggu aplikasi dihentikan dan diulang
date	String tanggal ISO	Tunggu tanggal/ketika spesifik
nativeVersion	String versi	Tunggu aplikasi native diperbarui

cancelDelay()

Bersihkan semua kondisi delay dan terapkan update segera pada cek berikutnya

await updater.cancelDelay();

Identifikasi Perangkat

getDeviceId()

Dapatkan identifikasi unik perangkat.

const deviceId = await updater.getDeviceId();
// 'uuid-xxxx-xxxx-xxxx'

setCustomId(options)

Tetapkan identifikasi khusus untuk perangkat (bermanfaat untuk analisis).

await updater.setCustomId({ customId: 'user-123' });

Konfigurasi

setUpdateUrl(options)

Ubah URL Server Perbarui secara waktu nyata.

await updater.setUpdateUrl({ url: 'https://my-server.com/updates' });

Catatan

Diperlukan allowModifyUrl: true di dalam konstruktor opsi.

setStatsUrl(options)

Ubah URL Pelaporan Statistik.

await updater.setStatsUrl({ url: 'https://my-server.com/stats' });

setChannelUrl(options)

Ubah URL Pengelolaan Saluran.

await updater.setChannelUrl({ url: 'https://my-server.com/channel' });

setAppId(options)

Ubah ID Aplikasi secara waktu jalannya.

await updater.setAppId({ appId: 'com.example.newapp' });

Catatan

Diperlukan allowModifyAppId: true di dalam opsi konstruktor.

getAppId()

Dapatkan ID Aplikasi saat ini.

const appId = await updater.getAppId();

Debug

setDebugMenu(options)

Aktifkan atau nonaktifkan menu debug.

await updater.setDebugMenu({ enabled: true });

isDebugMenuEnabled()

Periksa jika menu debug diaktifkan.

const enabled = await updater.isDebugMenuEnabled();

Event

Dengarkan event pembaruan menggunakan addListener:

updater.addListener('eventName', (event) => {
  // Handle event
});

Event yang Tersedia

Event	Payload	Deskripsi
download	{ percent, status }	Progres download yang diperbarui
updateAvailable	{ bundle }	Tersedia pembaruan baru
noNeedUpdate	{ message }	Sudah terupdate
downloadComplete	{ bundle }	Pengunduhan selesai dengan sukses
downloadFailed	{ bundle, error }	Pengunduhan gagal
breakingAvailable	{ bundle }	Pembaruan tidak kompatibel (memerlukan pembaruan asli)
updateFailed	{ bundle, reason }	Penginstalan pembaruan gagal
appReloaded	{}	Aplikasi telah di-reload
appReady	{}	notifyAppReady() dipanggil

Contoh: Penggunaan Penuh Event Handling

// Progress tracking
updater.addListener('download', (event) => {
  updateProgressBar(event.percent);
});

// Update available notification
updater.addListener('updateAvailable', (event) => {
  showNotification(`Update ${event.bundle.version} available!`);
});

// Handle completion
updater.addListener('downloadComplete', async (event) => {
  // Queue for next restart
  await updater.next({ id: event.bundle.id });
  showNotification('Update will apply on next restart');
});

// Handle failures
updater.addListener('updateFailed', (event) => {
  console.error('Update failed:', event.reason);
  reportError(event);
});

Opsi Konstruktor

Opsi konfigurasi lengkap untuk ElectronUpdater:

const updater = new ElectronUpdater({
  // Required
  appId: 'com.example.app',

  // Version override
  version: '1.0.0', // Override builtin version detection

  // Server URLs
  updateUrl: 'https://plugin.capgo.app/updates',
  channelUrl: 'https://plugin.capgo.app/channel_self',
  statsUrl: 'https://plugin.capgo.app/stats',

  // Behavior
  autoUpdate: true,           // Enable automatic update checks
  appReadyTimeout: 10000,     // Milliseconds before rollback (default: 10000)
  autoDeleteFailed: true,     // Auto-delete failed bundles
  autoDeletePrevious: true,   // Auto-delete old bundles
  resetWhenUpdate: true,      // Reset to builtin on native update

  // Channels
  defaultChannel: 'production',

  // Direct Update Mode
  directUpdate: false,        // 'atInstall' | 'onLaunch' | 'always' | false

  // Security
  publicKey: '...',           // RSA public key for E2E encryption

  // Dynamic Configuration
  allowModifyUrl: false,      // Allow runtime URL changes
  allowModifyAppId: false,    // Allow runtime App ID changes
  persistCustomId: false,     // Persist custom ID across updates
  persistModifyUrl: false,    // Persist URL changes

  // Debug
  debugMenu: false,           // Enable debug menu (Ctrl+Shift+D)
  disableJSLogging: false,    // Disable console logs

  // Periodic Updates
  periodCheckDelay: 0,        // Seconds between auto-checks (0 = disabled, min 600)
});

Lanjutkan dari Electron Updater API Referensi

Jika Anda menggunakan Referensi Electron Updater API untuk merencanakan dashboard dan API operasi, hubungkannya dengan Menggunakan @capgo/electron-updater untuk kemampuan asli dalam Menggunakan @capgo/electron-updater, API Ringkasan untuk detail implementasi dalam API Ringkasan, Pendahuluan untuk detail implementasi di Pendahuluan, API Kunci untuk detail implementasi di API Kunci, dan Perangkat untuk detail implementasi di Perangkat.