From a627fe83200888dd40e911a2dd9389591e900b8c Mon Sep 17 00:00:00 2001 From: Rafael Araujo Lehmkuhl Date: Fri, 22 Nov 2024 13:26:42 -0300 Subject: [PATCH] electron: Offer automatic app update With this new implementation, the user is informed that a new version of the application is available and can choose between downloading it or not. --- electron/main.ts | 25 ++-- electron/preload.ts | 12 ++ src/App.vue | 2 + src/components/UpdateNotification.vue | 168 ++++++++++++++++++++++++++ src/libs/cosmos.ts | 115 +++++++++++++++++- 5 files changed, 310 insertions(+), 12 deletions(-) create mode 100644 src/components/UpdateNotification.vue diff --git a/electron/main.ts b/electron/main.ts index abe2a48d2..4349fbf57 100644 --- a/electron/main.ts +++ b/electron/main.ts @@ -1,6 +1,7 @@ import { app, BrowserWindow, protocol, screen } from 'electron' import { join } from 'path' +import { setupAutoUpdater } from './services/auto-update' import { setupNetworkService } from './services/network' export const ROOT_PATH = { @@ -12,7 +13,7 @@ let mainWindow: BrowserWindow | null /** * Create electron window */ -function createWindow(): void { +async function createWindow(): Promise { const { width, height } = screen.getPrimaryDisplay().workAreaSize mainWindow = new BrowserWindow({ icon: join(ROOT_PATH.dist, 'pwa-512x512.png'), @@ -25,15 +26,10 @@ function createWindow(): void { height, }) - // Test active push message to Renderer-process. - mainWindow.webContents.on('did-finish-load', () => { - mainWindow?.webContents.send('main-process-message', new Date().toLocaleString()) - }) - if (process.env.VITE_DEV_SERVER_URL) { - mainWindow.loadURL(process.env.VITE_DEV_SERVER_URL) + mainWindow!.loadURL(process.env.VITE_DEV_SERVER_URL) } else { - mainWindow.loadFile(join(ROOT_PATH.dist, 'index.html')) + mainWindow!.loadFile(join(ROOT_PATH.dist, 'index.html')) } } @@ -63,7 +59,18 @@ protocol.registerSchemesAsPrivileged([ setupNetworkService() -app.whenReady().then(createWindow) +app.whenReady().then(async () => { + console.log('Electron app is ready.') + console.log(`Cockpit version: ${app.getVersion()}`) + + console.log('Creating window...') + await createWindow() + + console.log('Setting up auto updater...') + setTimeout(() => { + setupAutoUpdater(mainWindow as BrowserWindow) + }, 5000) +}) app.on('before-quit', () => { // @ts-ignore: import.meta.env does not exist in the types diff --git a/electron/preload.ts b/electron/preload.ts index 4312004c1..08977a09b 100644 --- a/electron/preload.ts +++ b/electron/preload.ts @@ -2,4 +2,16 @@ import { contextBridge, ipcRenderer } from 'electron' contextBridge.exposeInMainWorld('electronAPI', { getInfoOnSubnets: () => ipcRenderer.invoke('get-info-on-subnets'), + onUpdateAvailable: (callback: (info: any) => void) => + ipcRenderer.on('update-available', (_event, info) => callback(info)), + onUpdateDownloaded: (callback: (info: any) => void) => + ipcRenderer.on('update-downloaded', (_event, info) => callback(info)), + onCheckingForUpdate: (callback: () => void) => ipcRenderer.on('checking-for-update', () => callback()), + onUpdateNotAvailable: (callback: (info: any) => void) => + ipcRenderer.on('update-not-available', (_event, info) => callback(info)), + onDownloadProgress: (callback: (info: any) => void) => + ipcRenderer.on('download-progress', (_event, info) => callback(info)), + downloadUpdate: () => ipcRenderer.send('download-update'), + installUpdate: () => ipcRenderer.send('install-update'), + cancelUpdate: () => ipcRenderer.send('cancel-update'), }) diff --git a/src/App.vue b/src/App.vue index 94af043d2..f50106e6c 100644 --- a/src/App.vue +++ b/src/App.vue @@ -316,6 +316,7 @@ + diff --git a/src/libs/cosmos.ts b/src/libs/cosmos.ts index 41cc98050..f69ac685e 100644 --- a/src/libs/cosmos.ts +++ b/src/libs/cosmos.ts @@ -82,26 +82,104 @@ declare global { sum(): number } - /* eslint-disable jsdoc/require-jsdoc */ + /** + * Extended Window interface with some dedicated APIs, including data-lake methods, cockpit actions management and + * Electron messaging. + */ interface Window { + /** + * Exposed data-lake and cockpit action methods + */ cockpit: { - // Data lake: + /** + * The object that holds the data-lake variables data + */ cockpitActionVariableData: typeof cockpitActionVariableData + /** + * Get data from an specific data lake variable + * @param id - The id of the data to retrieve + * @returns The data or undefined if not available + */ getCockpitActionVariableData: typeof getCockpitActionVariableData + /** + * Listen to data changes on a specific data lake variable + * @param id - The id of the data to listen to + * @param listener - The listener callback + */ listenCockpitActionVariable: typeof listenCockpitActionVariable + /** + * Stop listening to data changes on a specific data lake variable + * @param id - The id of the data to stop listening to + */ unlistenCockpitActionVariable: typeof unlistenCockpitActionVariable + /** + * Get info about all variables in the data lake + * @returns Data lake data + */ getAllCockpitActionVariablesInfo: typeof getAllCockpitActionVariablesInfo + /** + * Get info about a specific variable in the data lake + * @param id - The id of the data to retrieve + * @returns The data info or undefined if not available + */ getCockpitActionVariableInfo: typeof getCockpitActionVariableInfo + /** + * Set the value of an specific data lake variable + * @param id - The id of the data to set + * @param value - The value to set + */ setCockpitActionVariableData: typeof setCockpitActionVariableData + /** + * Create a new variable in the data lake + * @param variable - The variable to create + * @param initialValue - The initial value for the variable + */ createCockpitActionVariable: typeof createCockpitActionVariable + /** + * Update information about an specific data lake variable + * @param variable - The variable to update + */ updateCockpitActionVariableInfo: typeof updateCockpitActionVariableInfo + /** + * Delete a variable from the data lake + * @param id - The id of the variable to delete + */ deleteCockpitActionVariable: typeof deleteCockpitActionVariable + + /** + * Cockpit actions related methods + */ // Cockpit actions: + /** + * Get all available cockpit actions + * @returns Available cockpit actions + */ availableCockpitActions: typeof availableCockpitActions + /** + * Register a new cockpit action + * @param action - The action to register + */ registerNewAction: typeof registerNewAction + /** + * Delete a cockpit action + * @param id - The id of the action to delete + */ deleteAction: typeof deleteAction + /** + * Register a callback for a cockpit action + * @param action - The action to register the callback for + * @param callback - The callback to register + */ registerActionCallback: typeof registerActionCallback + /** + * Unregister a callback for a cockpit action + * @param id - The id of the action to unregister the callback for + */ unregisterActionCallback: typeof unregisterActionCallback + /** + * Execute the callback for a cockpit action + * @param id - The id of the action to execute the callback for + */ executeActionCallback: typeof executeActionCallback } /** @@ -113,9 +191,40 @@ declare global { * @returns Promise containing subnet information */ getInfoOnSubnets: () => Promise + /** + * Register callback for update available event + */ + onUpdateAvailable: (callback: (info: any) => void) => void + /** + * Register callback for update downloaded event + */ + onUpdateDownloaded: (callback: (info: any) => void) => void + /** + * Trigger update download + */ + downloadUpdate: () => void + /** + * Trigger update installation + */ + installUpdate: () => void + /** + * Cancel ongoing update + */ + cancelUpdate: () => void + /** + * Register callback for checking for update event + */ + onCheckingForUpdate: (callback: () => void) => void + /** + * Register callback for update not available event + */ + onUpdateNotAvailable: (callback: (info: any) => void) => void + /** + * Register callback for download progress event + */ + onDownloadProgress: (callback: (info: any) => void) => void } } - /* eslint-enable jsdoc/require-jsdoc */ } // Use global as window when running for browsers