.NET Core SDK rc3

Links for installation:

• https://www.microsoft.com/net/download/core -> the Visual Studio 2017 Tools (RC 3) links.
• Or directly for sdk (no VS) https://github.com/dotnet/core/blob/master/release-notes/rc3-download.md

Use the simpler instructions but use --lang fsharp for dotnet new

F# works after install all supported os.

To check version, you can run

dotnet --version

and the output should be 1.0.0-rc3-004530

An quickstart, to create a console app and run it:

dotnet new -l fsharp
dotnet restore
dotnet run

To run an ASP.NET Core app, is the same, just use another template

dotnet new --lang fsharp -t web
dotnet restore
dotnet run

NOTE in this version 2.21.1 intellisense doesnt work (ref ionide/ionide-vscode-fsharp#341 ), fix will be included in the version of ionide

To use Visual Studio Code with Ionide with full intellisense,build,run (debug doesnt work) do dotnet build BEFORE opening the VSCode. You can also reload the language services by invoking the "Reload Window" command from the command palette by pressing F1 or Ctrl+Shift+P and typing Reload Window. Reloading the window can also help if the F# language services stall in VSCode for any reason.

dotnet new -l fsharp -t lib
dotnet restore
dotnet build
code .

Notes

Like preview4, this version is msbuild based

• This version is based on msbuild (version 15.0) so .fsproj for project file
• normal command (dotnet build, dotnet pack, etc) continue to work, but invoke the msbuild
• use dotnet msbuild to run msbuild directly

Changes from preview4

• BREAKING CHANGE set property EnableDefaultCompileItems to false (ref #64 )

  <PropertyGroup>
      <EnableDefaultCompileItems>false</EnableDefaultCompileItems>
  <PropertyGroup>

• see msdn blog post who contains changes and how-to-upgrade from preview4

Known issues

dotnet-migrate

dotnet migrate doesnt support F# yet:

• WORKAROUND: see tutorial in How-to-migrate-preview2-projects-to-rc3

error on build/pack using multiple frameworks (<TargetFrameworks>)

using <TargetFrameworks>net451;netcoreapp1.0</TargetFrameworks> the dotnet build/pack fails

• WORKAROUND: pass runtime to build net451, for example -r win7-x64

using .NET Framework as targets framework, the osx/unix build fails

Use a .net framwork (not core) like <TargetFramework>net451</TargetFramework> (or in TargetFrameworks) the dotnet build/pack fails on osx/unix, instead on windows work

• ISSUE: https://github.com/dotnet/sdk/issues/335
• WORKAROUND: see issue, if applicable

IDE Support

• VS Code with F# Ionide extension: ok (build/run), ko (debug/intellisense)
  • NOTE: in this version 2.21.1 intellisense doesnt work (ref ionide/ionide-vscode-fsharp#341 ), fix will be included in the version of ionide
  • NOTE: the VSCode should be opened after the first dotnet build (ref ionide/ionide-vscode-fsharp#312 )
• VS 2017RC: no
• Notepad and cli: from day 0 all dotnet sdk commands, ok (new,restore/build/run/pack/publish/test), ko (migrate)