Allow deep links for VS Code handlers to specify an minimum extension version

[matv-stripe]

Background

The ability to have a link open in VS Code and be handled by a particular extension is a great feature. We use it for example here https://docs.stripe.com/samples:

vscode://stripe.vscode-stripe/createStripeSample?sample=checkout-one-time-payments

I also appreciate the feature to suggest the user to install the extension as well if they do not have it:

Problem

It would be nice to specify a version of the extension in the URI. This way, if a user is on an older version that does not support the URI handler, we could prompt them to update.

Potential solution

My limited understanding of the code is, when VS Code is opened, it passes the URI that eventually calls this code

vscode/src/vs/workbench/services/extensions/browser/extensionUrlHandler.ts

Lines 164 to 193 in bda07cf

	if (!isExtensionId(uri.authority)) {
	return false;
	}
	const overrideHandler = ExtensionUrlHandlerOverrideRegistry.getHandler(uri);
	if (overrideHandler) {
	const handled = await overrideHandler.handleURL(uri);
	if (handled) {
	return handled;
	}
	}
	const extensionId = uri.authority;
	this.telemetryService.publicLog2<ExtensionUrlHandlerEvent, ExtensionUrlHandlerClassification>('uri_invoked/start', { extensionId });
	const initialHandler = this.extensionHandlers.get(ExtensionIdentifier.toKey(extensionId));
	let extensionDisplayName: string;
	if (!initialHandler) {
	// The extension is not yet activated, so let's check if it is installed and enabled
	const extension = await this.extensionService.getExtension(extensionId);
	if (!extension) {
	await this.handleUnhandledURL(uri, extensionId, options);
	return true;
	} else {
	extensionDisplayName = extension.displayName ?? '';
	}
	} else {
	extensionDisplayName = initialHandler.extensionDisplayName;
	}

Related: #136313 , it seems possible to install the extension at a version using the command by passing @x.x.x.

Unfortunately, this will not work since the browser will manipulate this string:

vscode://stripe.vscode-stripe@3.4.0/createStripeSample?sample=checkout-one-time-payments

Perhaps we can make the format:

vscode://stripe.vscode-stripe#3.4.0/createStripeSample?sample=checkout-one-time-payments

and doing this will prompt the user to install 3.4.0 if that version does not exist? Happy to make a PR for this!

[vs-code-engineering]

This feature request is now a candidate for our backlog. The community has 60 days to upvote the issue. If it receives 20 upvotes we will move it to our backlog. If not, we will close it. To learn more about how we handle feature requests, please see our documentation.

Happy Coding!

[matv-stripe]

@bpasero would you be open to a PR for this?

[vs-code-engineering]

This feature request has not yet received the 20 community upvotes it takes to make to our backlog. 10 days to go. To learn more about how we handle feature requests, please see our documentation.

Happy Coding!

[vs-code-engineering]

🙁 In the last 60 days, this feature request has received less than 20 community upvotes and we closed it. Still a big Thank You to you for taking the time to create this issue! To learn more about how we handle feature requests, please see our documentation.

Happy Coding!