Installing SQL Developer in IDEs Implementing the VS Code Extension API

Installing Oracle SQL Developer Extension for VSCode in Cursor

Introduction

The Oracle SQL Developer team is working on bringing the essential functionality built over the last 20 years in the classic SQL Developer IDE—a JDeveloper extension running as a standalone application—to the modern VS Code IDE. The integration with the VS Code ecosystem greatly enhances the developer experience.

Is it time to switch? – Well, it depends on which part of SQL Developer you use and how often. I’d say it’s time to start using the SQL Developer extension for VS Code. Use the classic SQL Developer when needed. You will do it less and less over time.

The SQL Developer extension is available in the VS Code Marketplace. That simplifies the installation for VS Code users. Unfortunately, this marketplace is not available in forks of VS Code or, more precisely, in IDEs that implement the VS Code extension API, such as VSCodium, Cursor, Winsurf and Theia IDE. So, how do we install VS Code extensions, specifically SQL Developer, in these IDEs? – I’ll answer this question in this blog post.

Installing SQL Developer in VS Code

The easiest way to install SQL Developer in VS Code is to start VS Code, search for oracle sql developer in the Extensions view, and click on the Install button. That’s it.

Install SQL Developer within VS Code

Please note that the second entry shown in the screenshot above is a deprecated/decommissioned extension developed by another team at Oracle. It’s a completely unrelated product.

Downloading SQL Developer’s .vsix File

At the time of writing, it is not possible (anymore) to download an extension such as SQL Developer directly from the VS Code Marketplace website. At least not officially. However, it’s possible in VS Code.

Instead of clicking on the install button as before, right-click on the extension and select Download VSIX.

Download VSIX file within VS Code

and then select the platform architecture.

Select the platform for which you want to download the VSIX

This is necessary because SQL Developer comes with a Java Runtime Environment, which contains platform-specific binaries.

Installing a VSIX File

VS Code, Windsurf, Cursor and Theila IDE provide a Install from VSIX... command. You find it via View -> Command Pallette.... Run it,

Install from VSIX...

and select the VSIX file to install, and you’re done.

Open VSX Registry

Why are VSCodium, Cursor, Winsurf and Theia IDE not using the VS Code Marketplace? – Because the Terms of Use do not allow this. Here’s the relevant passage:

(…) you may not access, search, obtain or attempt to obtain any Offerings, materials, or information from the Sites through any means other than directly from Microsoft’s publicly supported interfaces (…)

This is why VSCodium, Cursor, Winsurf and Theia IDE use the alternative marketplace Open VSX Registry.

At the time of writing, the Oracle SQL Developer Extension for VSCode is not available in the Open VSX Registry. Here’s a screenshot of a search in Cursor:

Search for Oracle SQL Developer  within Cursor

As you see, the deprecated/decommissioned extension is listed, but the successor is missing.

Summary

Installing an extension in VS Code via the integrated marketplace is super easy. Getting the .vsix file is also straightforward and enables the installation of VS Code extensions in IDEs that implement the VS Code extension API.

It would be great if the Oracle SQL Developer team published their SQL Developer extension on the Open VSX Registry too. This would make the initial installation and subsequent updates much simpler.

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.