Add automated Linux install and upgrade support using official setup scripts

Co-authored-by: garrytrinder <11563347+garrytrinder@users.noreply.github.com>

Author: Copilot

src/commands/install.ts

@@ -1,8 +1,9 @@
 import * as vscode from 'vscode';
-import { Commands, Urls } from '../constants';
+import { Commands } from '../constants';
 import {
   executeCommand,
   getPackageIdentifier,
+  getInstallScriptUrl,
   upgradeDevProxyWithPackageManager,
   openUpgradeDocumentation,
 } from '../utils/shell';
@@ -40,8 +41,7 @@ async function installDevProxy(
     } else if (platform === 'darwin') {
       await installOnMac(versionPreference);
     } else if (platform === 'linux') {
-      // Linux requires manual installation
-      vscode.env.openExternal(vscode.Uri.parse(Urls.linuxInstall));
+      await installOnLinux(versionPreference);
     }
   } finally {
     message.dispose();
@@ -93,14 +93,62 @@ async function installOnMac(versionPreference: VersionPreference): Promise<void>
   }
 }
 
+async function installOnLinux(versionPreference: VersionPreference): Promise<void> {
+  const scriptUrl = getInstallScriptUrl(versionPreference);
+
+  // Check if bash is available
+  try {
+    await executeCommand('bash --version');
+  } catch {
+    vscode.window.showErrorMessage('Bash is not available. Please install bash and try again.');
+    return;
+  }
+
+  // Check if curl is available
+  try {
+    await executeCommand('curl --version');
+  } catch {
+    vscode.window.showErrorMessage('curl is not installed. Please install curl and try again.');
+    return;
+  }
+
+  try {
+    await executeCommand(`bash -c "$(curl -sL ${scriptUrl})"`);
+    const result = await vscode.window.showInformationMessage('Dev Proxy installed.', 'Reload');
+    if (result === 'Reload') {
+      await vscode.commands.executeCommand('workbench.action.reloadWindow');
+    }
+  } catch (error) {
+    vscode.window.showErrorMessage(`Failed to install Dev Proxy.\n${error}`);
+  }
+}
+
 async function upgradeDevProxy(configuration: vscode.WorkspaceConfiguration): Promise<void> {
   const platform = process.platform;
   const versionPreference = configuration.get('version') as VersionPreference;
   const isBeta = versionPreference === VersionPreference.Beta;
 
-  // Linux always redirects to documentation
+  // Linux uses install script to upgrade
   if (platform === 'linux') {
-    openUpgradeDocumentation();
+    const scriptUrl = getInstallScriptUrl(versionPreference);
+    const versionText = isBeta ? 'Dev Proxy Beta' : 'Dev Proxy';
+    const statusMessage = vscode.window.setStatusBarMessage(`Upgrading ${versionText}...`);
+
+    try {
+      await executeCommand(`bash -c "$(curl -sL ${scriptUrl})"`);
+      statusMessage.dispose();
+
+      const result = await vscode.window.showInformationMessage(
+        `${versionText} has been successfully upgraded!`,
+        'Reload Window'
+      );
+      if (result === 'Reload Window') {
+        await vscode.commands.executeCommand('workbench.action.reloadWindow');
+      }
+    } catch {
+      statusMessage.dispose();
+      openUpgradeDocumentation();
+    }
     return;
   }
 

src/constants.ts

@@ -89,6 +89,8 @@ export const DiagnosticCodes = {
 export const Urls = {
   upgradeDoc: 'https://aka.ms/devproxy/upgrade',
   linuxInstall: 'https://aka.ms/devproxy/start/linux',
+  linuxSetupScript: 'https://aka.ms/devproxy/setup.sh',
+  linuxSetupBetaScript: 'https://aka.ms/devproxy/setup-beta.sh',
   schemaBase: 'https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas',
   diagnosticsDoc: 'https://learn.microsoft.com/microsoft-cloud/dev/dev-proxy/technical-reference/toolkit-diagnostics',
 } as const;

src/test/notifications.test.ts

@@ -73,7 +73,7 @@ suite('notifications', () => {
     assert.strictEqual(actual, expected);
   });
 
-  test('should not show install notification when running in unsupported operating system', async () => {
+  test('should not show install notification when devproxy is installed on linux', async () => {
     const context = await getExtensionContext();
     await context.globalState.update(
       'devProxyInstall',

src/test/shell.test.ts

@@ -3,13 +3,14 @@
  * Tests for pure utility functions in shell.ts.
  */
 import * as assert from 'assert';
-import { getPackageIdentifier, resolveDevProxyExecutable } from '../utils/shell';
+import { getPackageIdentifier, getInstallScriptUrl, resolveDevProxyExecutable } from '../utils/shell';
 import {
   PackageManager,
   VersionPreference,
   HomebrewPackageIdentifier,
   WingetPackageIdentifier,
 } from '../enums';
+import { Urls } from '../constants';
 
 suite('getPackageIdentifier', () => {
   test('should return stable Homebrew package for stable preference', () => {
@@ -41,6 +42,18 @@ suite('getPackageIdentifier', () => {
   });
 });
 
+suite('getInstallScriptUrl', () => {
+  test('should return stable script URL for stable preference', () => {
+    const result = getInstallScriptUrl(VersionPreference.Stable);
+    assert.strictEqual(result, Urls.linuxSetupScript);
+  });
+
+  test('should return beta script URL for beta preference', () => {
+    const result = getInstallScriptUrl(VersionPreference.Beta);
+    assert.strictEqual(result, Urls.linuxSetupBetaScript);
+  });
+});
+
 suite('resolveDevProxyExecutable', () => {
   const NONEXISTENT_DEVPROXY_COMMAND = 'devproxy-command-that-does-not-exist-for-tests';
 

src/utils/index.ts

@@ -23,6 +23,7 @@ export {
   executeCommand,
   sleep,
   getPackageIdentifier,
+  getInstallScriptUrl,
   upgradeDevProxyWithPackageManager,
   openUpgradeDocumentation,
   resolveDevProxyExecutable,

src/utils/shell.ts

@@ -58,6 +58,15 @@ export function getPackageIdentifier(
   return undefined;
 }
 
+/**
+ * Get the Linux install script URL based on version preference.
+ */
+export function getInstallScriptUrl(versionPreference: VersionPreference): string {
+  return versionPreference === VersionPreference.Stable
+    ? Urls.linuxSetupScript
+    : Urls.linuxSetupBetaScript;
+}
+
 /**
  * Upgrade Dev Proxy using a package manager.
  *