feat(startup): show message if vscode is outdated

Author: justinmk3

packages/amazonq/.changes/next-release/Deprecation-4577def6-0191-48db-bec3-480b226285b8.json

@@ -0,0 +1,4 @@
+{
+	"type": "Deprecation",
+	"description": "The next release of this extension will require VS Code 1.83.0 or newer."
+}

packages/amazonq/.changes/next-release/Feature-b02fae9d-cb44-4625-af37-0b119c18ef63.json

@@ -0,0 +1,4 @@
+{
+	"type": "Feature",
+	"description": "Show a one-time warning if new VS Code is required"
+}

packages/amazonq/package.json

@@ -112,6 +112,10 @@
                             "type": "boolean",
                             "default": false
                         },
+                        "minIdeVersion": {
+                            "type": "boolean",
+                            "default": false
+                        },
                         "ssoCacheError": {
                             "type": "boolean",
                             "default": false

packages/amazonq/src/extension.ts

@@ -40,6 +40,7 @@ import {
     placeholder,
     setContext,
     setupUninstallHandler,
+    maybeShowMinVscodeWarning,
 } from 'aws-core-vscode/shared'
 import { ExtStartUpSources, telemetry } from 'aws-core-vscode/telemetry'
 import { VSCODE_EXTENSION_ID } from 'aws-core-vscode/utils'
@@ -98,6 +99,8 @@ export async function activateAmazonQCommon(context: vscode.ExtensionContext, is
         }
     }
 
+    void maybeShowMinVscodeWarning('1.83.0')
+
     globals.machineId = await getMachineId()
     globals.awsContext = new DefaultAwsContext()
     globals.sdkClientBuilder = new DefaultAWSClientBuilder(globals.awsContext)

packages/core/src/extension.ts

@@ -55,7 +55,7 @@ import { registerCommands } from './commands'
 // In web mode everything must be in a single file, so things like the endpoints file will not be available.
 // The following imports the endpoints file, which causes webpack to bundle it in the final output file
 import endpoints from '../resources/endpoints.json'
-import { getLogger, setupUninstallHandler } from './shared'
+import { getLogger, maybeShowMinVscodeWarning, setupUninstallHandler } from './shared'
 import { showViewLogsMessage } from './shared/utilities/messages'
 
 disableAwsSdkWarning()
@@ -102,6 +102,8 @@ export async function activateCommon(
         getLogger().error('fs.init: invalid home directory given by env vars: %O', homeDirLogs)
     }
 
+    void maybeShowMinVscodeWarning('1.83.0')
+
     if (isCloud9()) {
         vscode.window.withProgress = wrapWithProgressForCloud9(globals.outputChannel)
         context.subscriptions.push(

packages/core/src/shared/extensionUtilities.ts

@@ -6,15 +6,17 @@
 import * as _ from 'lodash'
 import * as os from 'os'
 import * as vscode from 'vscode'
+import * as semver from 'semver'
 import * as nls from 'vscode-nls'
 import { getLogger } from './logger'
 import { VSCODE_EXTENSION_ID, extensionAlphaVersion } from './extensions'
 import { Ec2MetadataClient } from './clients/ec2MetadataClient'
 import { DefaultEc2MetadataClient } from './clients/ec2MetadataClient'
 import { extensionVersion, getCodeCatalystDevEnvId } from './vscode/env'
-import { DevSettings } from './settings'
+import { AmazonQPromptSettings, DevSettings, ToolkitPromptSettings } from './settings'
 import globals from './extensionGlobals'
 import { once } from './utilities/functionUtils'
+import * as localizedText from './localizedText'
 import {
     apprunnerCreateServiceDocUrl,
     debugNewSamAppDocUrl,
@@ -262,6 +264,33 @@ export function showWelcomeMessage(context: vscode.ExtensionContext): void {
     }
 }
 
+/**
+ * Shows a (suppressible) warning if the current vscode version is older than `minVscode`.
+ */
+export async function maybeShowMinVscodeWarning(minVscode: string) {
+    const settings = isAmazonQ() ? AmazonQPromptSettings.instance : ToolkitPromptSettings.instance
+    if (!(await settings.isPromptEnabled('minIdeVersion'))) {
+        return
+    }
+    const isVscode = !!vscode.env.appName?.startsWith(vscodeAppname)
+    const updateButton = `Update ${vscode.env.appName}`
+    if (isVscode && semver.lt(vscode.version, minVscode)) {
+        vscode.window
+            .showWarningMessage(
+                `The next release of the ${productName()} extension will require VS Code ${minVscode} or newer. Your are currently running ${vscode.version}`,
+                updateButton,
+                localizedText.dontShow
+            )
+            .then(async (resp) => {
+                if (resp === updateButton) {
+                    await vscode.commands.executeCommand('update.checkForUpdate')
+                } else if (resp === localizedText.dontShow) {
+                    settings.disablePrompt('minIdeVersion')
+                }
+            })
+    }
+}
+
 function _getDocumentationUrl(urls: { cloud9: vscode.Uri; toolkit: vscode.Uri }): vscode.Uri {
     return isCloud9() ? urls.cloud9 : urls.toolkit
 }

packages/core/src/shared/index.ts

@@ -14,7 +14,7 @@ export { activate as activateTelemetry } from './telemetry/activation'
 export { DefaultAwsContext } from './awsContext'
 export { DefaultAWSClientBuilder, ServiceOptions } from './awsClientBuilder'
 export { Settings } from './settings'
-export { initializeComputeRegion } from './extensionUtilities'
+export * from './extensionUtilities'
 export { RegionProvider } from './regions/regionProvider'
 export { Commands } from './vscode/commands2'
 export { getMachineId } from './vscode/env'

packages/core/src/shared/settings-amazonq.gen.ts

@@ -17,6 +17,7 @@ export const amazonqSettings = {
         "codeWhispererConnectionExpired": {},
         "amazonQWelcomePage": {},
         "amazonQSessionConfigurationMessage": {},
+        "minIdeVersion": {},
         "ssoCacheError": {}
     },
     "amazonQ.showInlineCodeSuggestionsWithCodeReferences": {},

packages/core/src/shared/settings-toolkit.gen.ts

@@ -37,6 +37,7 @@ export const toolkitSettings = {
         "samcliConfirmDevStack": {},
         "remoteConnected": {},
         "codeCatalystConnectionExpired": {},
+        "minIdeVersion": {},
         "ssoCacheError": {}
     },
     "aws.experiments": {

packages/toolkit/.changes/next-release/Deprecation-2df766d2-cbec-4fdc-bb69-80f90d9d15ef.json

@@ -0,0 +1,4 @@
+{
+	"type": "Deprecation",
+	"description": "The next release of this extension will require VS Code 1.83.0 or newer."
+}