Merge pull request #164 from arduino/feature/launch-pkg-installer

ubidefeo · web-flow · commit a4ffba480d27 · 2025-03-05T14:06:51.000+01:00
Add button to launch package installer
diff --git a/backend/ipc.js b/backend/ipc.js
@@ -1,6 +1,7 @@
 const fs = require('fs')
 const registerMenu = require('./menu.js')
 const serial = require('./serial/serial.js').sharedInstance
+const { shell } = require('electron');
 
 const {
   openFolderDialog,
@@ -138,6 +139,25 @@ module.exports = function registerIPCHandlers(win, ipcMain, app, dialog) {
     registerMenu(win, state)
   })
 
+  ipcMain.handle('launch-app', async (event, urlScheme) => {
+    // Launch an external app with a custom protocol
+    return new Promise((resolve, reject) => {
+      try {
+        shell.openExternal(urlScheme).then(() => {
+          resolve(true);  // App opened successfully
+        }).catch(() => {
+          resolve(false);  // App not installed
+        });
+      } catch (err) {
+        reject(err);
+      }
+    });
+  });
+  
+  ipcMain.handle('open-url', async (event, url) => {
+    shell.openExternal(url);
+  });
+
   win.on('close', (event) => {
     console.log('BrowserWindow', 'close')
     event.preventDefault()
diff --git a/preload.js b/preload.js
@@ -2,7 +2,7 @@ console.log('preload')
 const { contextBridge, ipcRenderer } = require('electron')
 const path = require('path')
 const shortcuts = require('./backend/shortcuts.js').shortcuts.global
-const { emit, platform } = require('process')
+const { platform } = require('process')
 const SerialBridge = require('./backend/serial/serial-bridge.js')
 
 const Disk = {
@@ -85,6 +85,21 @@ const Window = {
   getShortcuts: () => shortcuts
 }
 
+/**
+ * Launches an app using the provided URL scheme (e.g. myapp://). If the app is not installed, it will
+ * fallback to open the provided fallback URL.
+ * @param {string} url The URL scheme to use to launch the app
+ * @param {string} fallbackUrl The URL to open if the app is not installed
+ */
+async function launchApp(url, fallbackUrl) {
+  const success = await ipcRenderer.invoke('launch-app', url);
+
+  if (!success) {      
+    await ipcRenderer.invoke('open-url', fallbackUrl); // Fallback to open a URL in the default browser
+  }
+}
+
+contextBridge.exposeInMainWorld('launchApp', launchApp)
 contextBridge.exposeInMainWorld('BridgeSerial', SerialBridge)
 contextBridge.exposeInMainWorld('BridgeDisk', Disk)
 contextBridge.exposeInMainWorld('BridgeWindow', Window)
diff --git a/ui/arduino/media/install-package.svg b/ui/arduino/media/install-package.svg
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" version="1.1" viewBox="0 0 50 50">
+  <defs>
+    <style>
+      .cls-1 {
+        fill: none;
+        stroke: #000;
+        stroke-linecap: round;
+        stroke-linejoin: round;
+        stroke-width: 3.2px;
+      }
+    </style>
+  </defs>
+  <!-- Generator: Adobe Illustrator 28.7.1, SVG Export Plug-In . SVG Version: 1.2.0 Build 142)  -->
+  <g>
+    <g id="Layer_1">
+      <g>
+        <g>
+          <line class="cls-1" x1="25" y1="3.2" x2="25" y2="14.2"/>
+          <polyline class="cls-1" points="19.8 8.4 25 3.2 30.2 8.4"/>
+        </g>
+        <g>
+          <polyline class="cls-1" points="8.8 29.6 8.8 46.8 28.3 46.8 28.3 20.7 8.8 20.7"/>
+          <polyline class="cls-1" points="41.2 29.6 41.2 46.8 28.3 46.8 28.3 20.7 41.2 20.7"/>
+        </g>
+        <polygon class="cls-1" points="28.3 20.7 33.5 29.6 46.4 29.6 41.2 20.7 28.3 20.7"/>
+        <polygon class="cls-1" points="28.3 20.7 23.1 29.6 3.6 29.6 8.8 20.7 28.3 20.7"/>
+        <line class="cls-1" x1="13.1" y1="42.2" x2="21.4" y2="42.2"/>
+        <line class="cls-1" x1="13.1" y1="37.9" x2="16.6" y2="37.9"/>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/ui/arduino/store.js b/ui/arduino/store.js
@@ -116,6 +116,10 @@ async function store(state, emitter) {
     updateMenu()
   })
 
+  emitter.on('launch-app', async (url, fallbackUrl) => {
+    window.launchApp(url, fallbackUrl)
+  })
+
   // CONNECTION DIALOG
   emitter.on('open-connection-dialog', async () => {
     log('open-connection-dialog')
diff --git a/ui/arduino/views/components/toolbar.js b/ui/arduino/views/components/toolbar.js
@@ -69,6 +69,17 @@ function Toolbar(state, emit) {
           disabled: !_canSave,
           onClick: () => emit('save')
         })}
+
+        ${!window.BridgeWindow.isLinux() ? html`<div class="separator"></div>` : ''}
+
+        ${!window.BridgeWindow.isLinux() ? Button({
+          icon: 'install-package.svg',
+          label: `Add Package`,          
+          onClick: () => {
+            if(state.isConnected) emit('disconnect') // Package installer requires exclusive access to the serial port
+            emit('launch-app', 'micropython-package-installer://', 'https://github.com/arduino/lab-micropython-package-installer/releases/latest')          
+          }
+        }) : '' }
       </div>
         
       <div id="app-views">
@@ -88,7 +99,6 @@ function Toolbar(state, emit) {
           square: true,
           onClick: () => emit('change-view', 'file-manager')
         })}
-      
       </div>
     </div>
   `
