How to install pre-releases: vscode-docs/v1_63.md at vnext · microsoft/vscode-docs · GitHub
Note: For now, only VSCode marketplace users can download the pre-release. VSX marketplace will follow soon!
We are happy to announce a Pre-Release for the new major version release for the VSCode Haskell Extension!
Many developers have contributed new features, and this announcement tells you about the latest and greatest changes!
Previously, VSCode downloaded new HLS binaries automatically. The big new exciting change is that we now use GHCup and can manage the following Haskell Tools for you: HLS, GHC, stack and cabal. To install HLS binaries automatically, make sure you have ghcup installed!
The first time you use the new Extension you will be asked whether you want to manually manage your Haskell Toolchain binaries or GHCup should take care of it as it sees fit.
The choice you have:
-
GHCup: Choose this if you don’t want to worry about HLS binaries, etc… -
PATH: Choose this if you need tight control over which tools you have installed. Nothing will be installed
However, you don’t have to choose between extremes! You have fine-grained control over which tools GHCup is allowed to install/manage.
Summary of Changes:
-
GHCup can now be used for managing all Haskell Toolchain binaries automatically
- This requires a pre-installed GHCup
- This is now the only option for managing binaries/HLS automatically
- The following flags have been removed:
updateBehavior
- The following new settings are available:
-
manageHLS: Do you wantghcupto manageHLSinstallations for you or use system PATH? -
ghcupExecutablePath: Set here the path toghcupif it non-standard - Other settings include:
-
toolchain,upgradeGHCup,releasesURL,metadataURL(refer to the VSCode settings for more details)
-
-
What this Pre-Release essentially enables us to do is to avoid $PATH issues, and we can manage the pre-built binaries more efficiently and correctly.
If you have issues with VSCode picking up the ghcup executable, you can either set ghcupExecutablePath to the full binary path or explicitly set PATH variable in VSCode:
"haskell.serverEnvironment": { "PATH": "${HOME}/.ghcup/bin:${PATH}" }
Since this is going to be very much a breaking release, please expect bugs and rough edges we have to iron out! Please report all issues you encounter at the vscode-haskell issue tracker or reply to this post
We ask you for your feedback, especially documentation wise: What do you think needs more explanations and what feature is harder than necessary to use or debug.
We thank all our contributors for making this release possible:
- Julian Ospald
- Fendor
- jneira
- Benjamin M
- PCloud
- soiamsoNG
- Simon Michael
