To begin working with OpenEdge ABL in Windsurf, follow these steps to install and configure the OpenEdge ABL extension:
  1. To install the OpenEdge ABL extension:
    1. Open the Extensions: Marketplace panel in Windsurf by clicking the Extensions icon in the sidebar.

    2. Search for ABL extensions.
    3. Select OpenEdge ABL by RiversideSoftware and click Install.

      After installation, Windsurf prompts you to configure runtime paths for OpenEdge.

  2. To configure OpenEdge runtime paths:
    1. Navigate to File > Preferences > Editor Settings in Windsurf.
    2. In the Editor Settings window:
      1. Go to the Workspace tab.
      2. Open the Extensions section and scroll to ABL configuration.
    3. Click Edit in settings.json to manually configure the runtime.

      Add the following configuration block to your settings.json file:
      
"abl.configuration.runtimes": 
[
	{
	"name": "12.8",
	"path": "C:\\Progress\\OpenEdge"
	}
]
      Note:
      • The default OpenEdge installation path is C:\Progress\OpenEdge. If your OpenEdge installation is in a different location, update the configuration paths accordingly.
      • While content assist is available for version numbers, you can manually specify any value. This identifier can be reused across multiple project configuration files for consistency.

Extension version considerations

A newer version of the Riverside extension may be available that is ahead of the one offered in the extension store. You can browse for extensions from within the Visual Studio Code (VS Code).

To install a newer version of the extension directly through Visual Studio Code (VS Code), perform the following steps:
  1. Launch the Extensions view by clicking on the Extensions icon in the activity bar on the side of the VS Code.

    You can now view a list of the most popular VS Code extensions on the VS Code Marketplace.

  2. In the Extensions view, enter RiversideSoftware.openedge-abl-lsp, which is the unique extension ID and initiate the search.
  3. Select the OpenEdge ABL support for Visual Studio Code extension from the results.
  4. Click Install.
    Note: To install a specific version of an extension, right-click the extension and select Install Another Version. You can then select a version from the available list.
    VS Code downloads and installs the extension from the Marketplace. When the installation is complete, the Install button is replaced with a Manage gear button.
To install a specific version of the extension manually if you do not have VS Code installed or need an offline installation:
  1. Obtain the .vsix file for the required version by consulting your administrator or internal resources.
  2. In Windsurf, open the Extensions: Marketplace view.
  3. Click the three dots (...) in the top-right corner and select Install from VSIX.
  4. Browse to and select the downloaded .vsix file to complete the installation.