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 wantghcup
to manageHLS
installations for you or use system PATH? -
ghcupExecutablePath
: Set here the path toghcup
if 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