#Ionide-VSCode: FSharp
Enhanced F# Language Features for Visual Studio Code
Part of the Ionide plugin suite.
Need Help? You can find us on Gitter:
F# 4.0 needs to be installed on your system in order to use Ionide
For more detailed instructions on installing F# :
FSC (F# Compiler) and FSI/fsharpi on Mono (F# Interactive) need to be added to your system PATH.
The default location on Windows is
64-bit - C:\Program Files (x86)\Microsoft SDKs\F#\4.0\Framework\v4.0\
32-bit - C:\Program Files\Microsoft SDKs\F#\4.0\Framework\v4.0
You can download F# 4.0 here for Windows
Install the Microsoft Build Tools 2015
If you use chocolatey, you can install all the pre-requisites easily:
choco install windows-sdk-8.0 -y
choco install visualfsharptools -y
choco install microsoft-build-tools -y
choco install visualstudiocode -y
- Required: Mono >= 3.10
- Recommended: Mono >= 4.0.2
- Better syntax highlighting
- Auto completions
- Error highlighting and error list
- Tooltips
- Go to Declaration
- Show symbols in file
- Highlighting usages
WebView
allows the user to override the default conventions used to run and preview web applications. To do so You need to create an .ionide
file in the root folder of Your project opened by VSCode. The configuration file uses the TOML language.
Here is the default configuration values used if the .ionide
file doesn't exist or some entry is missing:
[WebPreview]
linuxPrefix = "mono"
command = "packages/FAKE/tools/FAKE.exe"
host = "localhost"
port = 8888
script = "build.fsx"
build = "Serve"
startString = "listener started"
parameters = []
startingPage = ""
-
linuxPrefix - command used as prefix on Linux / Mac - usually
sh
ormono
-
command - path to
FAKE.exe
-
host - address of webpage displayed in WebPreview - usually
localhost
-
port - port of webpage displayed in WebPreview (also passed to FAKE as environmental variable)
-
script - FAKE build script passed to FAKE - usually
build.fsx
-
build - FAKE build target executed to start WebPreview
-
startString - string which needs to be printed out in standard I/O to let know WebPreview to display webpage
-
parameters - list of parameters passed to FAKE.exe
-
startingPage - webpage displayed in WebPreview - usually
index.html
- Clone repo
- Run
build.cmd Build
(orbuild.sh Build
) - Open folder in VSCode
code .
- Make changes
- Press
F5
to build plugin and start experimental instance of VSCode - Make PR ;)
- Enable Logging in User settings with
// FSharp configuration
// Set the verbosity for F# Language Service Output Channel
"FSharp.logLanguageServiceRequestsOutputWindowLevel": "DEBUG",
// Enable logging language service requests (FSAC) to an output channel, the developer tools console, or both
"FSharp.logLanguageServiceRequests": "both"
- Open the Output Panel and switch to the
F# Language Service
Channel - Or Toggle Developer Tools (
Help |> Toggle Developer Tools
) and open the console tab
The project is hosted on GitHub where you can report issues, fork the project and submit pull requests.
The library is available under MIT license, which allows modification and redistribution for both commercial and non-commercial purposes.