To build and test Visual F# IDE Tools, install these requirements:

-[Visual Studio 2017](https://www.visualstudio.com/downloads/)

- Under the "Windows" workloads, select ".NET desktop development"

- Select "F# language support" under the optional components

- Select "F#desktoplanguage support" under the optional components

- Under the "Other Toolsets" workloads, select "Visual Studio extension development"

Steps to build:

Use``VisualFSharp.sln`` if you're building the Visual F# IDE Tools.

Note on Debug vs Release:``Release`` Configuration has a degraded debugging experience, so if you want to test a change locally, it is recommended to do it in the``Debug`` configuration. For more information seehttps://github.com/Microsoft/visualfsharp/issues/2771 andhttps://github.com/Microsoft/visualfsharp/pull/2773.

Note: if you face this error[#2351](https://github.com/Microsoft/visualfsharp/issues/2351):

At time of writing, the Visual F# IDE Tools can only be installed into the latest Visual Studio 2017 RC releases.

The new builds of the Visual F# IDE Tools can no longer be installed into Visual Studio 2015.

You can install Visual Studio 2017 fromhttps://www.visualstudio.com/downloads/.

Because this uses the "RoslynDev" hive you can simultaneously test changes to an appropriate build of Roslyn binaries.

For the brave, you can rapidly deploy incrementally updated versions of Visual F# IDE Tool components such as``FSHarp.Editor.dll`` by copying them directly into the extension directory in your user AppData folder:

-[Windows 8.1 SDK](http://msdn.microsoft.com/en-us/library/windows/desktop/bg162891.aspx)

-[Windows 10 SDK](https://developer.microsoft.com/en-US/windows/downloads/windows-10-sdk)

1. The`update.cmd` script adds required strong name validation skips and NGens the compiler and libraries. This requires admin privileges.

The primary technical guide to the core compiler code is[The F# Compiler Technical Guide](http://fsharp.github.io/2015/09/29/fsharp-compiler-guide.html). Please read and contribute to that guide.

Project("{F2A71F9B-5D33-465A-A702-920D77279786}") ="FSharp.Compiler.Private","src\fsharp\FSharp.Compiler.Private\FSharp.Compiler.Private.fsproj","{2E4D67B4-522D-4CF7-97E4-BA940F0B18F3}"

Project("{F2A71F9B-5D33-465A-A702-920D77279786}") ="FSharp.Build.UnitTests","src\fsharp\FSharp.Build.UnitTests\FSharp.Build.UnitTests.fsproj","{400FAB03-786E-40CC-85A8-04B0C2869B14}"

Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") ="PEVerify","tests\fsharpqa\testenv\src\PEVerify\PEVerify.csproj","{B0689A4E-07D8-494D-A0C8-791CB1D74E54}"

GlobalSection(SolutionConfigurationPlatforms) =preSolution

Debug|Any CPU=Debug|Any CPU

{400FAB03-786E-40CC-85A8-04B0C2869B14}.Release|Any CPU.Build.0=Release|Any CPU

{400FAB03-786E-40CC-85A8-04B0C2869B14}.Release|x86.ActiveCfg=Release|Any CPU

{400FAB03-786E-40CC-85A8-04B0C2869B14}.Release|x86.Build.0=Release|Any CPU

{B0689A4E-07D8-494D-A0C8-791CB1D74E54}.Debug|Any CPU.ActiveCfg=Debug|Any CPU

{B0689A4E-07D8-494D-A0C8-791CB1D74E54}.Debug|Any CPU.Build.0=Debug|Any CPU

{B0689A4E-07D8-494D-A0C8-791CB1D74E54}.Debug|x86.ActiveCfg=Debug|Any CPU

{B0689A4E-07D8-494D-A0C8-791CB1D74E54}.Debug|x86.Build.0=Debug|Any CPU

{B0689A4E-07D8-494D-A0C8-791CB1D74E54}.Proto|Any CPU.ActiveCfg=Debug|Any CPU

{B0689A4E-07D8-494D-A0C8-791CB1D74E54}.Proto|Any CPU.Build.0=Debug|Any CPU

{B0689A4E-07D8-494D-A0C8-791CB1D74E54}.Proto|x86.ActiveCfg=Debug|Any CPU

{B0689A4E-07D8-494D-A0C8-791CB1D74E54}.Proto|x86.Build.0=Debug|Any CPU

{B0689A4E-07D8-494D-A0C8-791CB1D74E54}.Release|Any CPU.ActiveCfg=Release|Any CPU

{B0689A4E-07D8-494D-A0C8-791CB1D74E54}.Release|Any CPU.Build.0=Release|Any CPU

{B0689A4E-07D8-494D-A0C8-791CB1D74E54}.Release|x86.ActiveCfg=Release|Any CPU

{B0689A4E-07D8-494D-A0C8-791CB1D74E54}.Release|x86.Build.0=Release|Any CPU

GlobalSection(SolutionProperties) =preSolution

{FF76BD3C-5E0A-4752-B6C3-044F6E15719B} ={35636A82-401A-4C3A-B2AB-EB7DC5E9C268}

{0385564F-07B4-4264-AB8A-17C393E9140C} ={F6DAEE9A-8BE1-4C4A-BC83-09215517C7DA}

{400FAB03-786E-40CC-85A8-04B0C2869B14} ={CFE3259A-2D30-4EB0-80D5-E8B5F3D01449}

{B0689A4E-07D8-494D-A0C8-791CB1D74E54} ={CFE3259A-2D30-4EB0-80D5-E8B5F3D01449}

GlobalSection(ExtensibilityGlobals) =postSolution

<ItemGroupCondition="'$(TEST_CORECLR_FSHARP_SUITE)'=='1'" >

<ProjectsWithCoreClrInclude="tests/fsharp/FSharp.Tests.FSharpSuite.DrivingCoreCLR/FSharp.Tests.FSharpSuite.DrivingCoreCLR.fsproj" />

<ProjectsWithCoreClrInclude="tests/fsharpqa/testenv/src/PEVerify/PEVerify.csproj" />

<ProjectsToRestoreInclude="tests/fsharpqa/testenv/src/PEVerify/PEVerify.csproj" />

</ItemGroup>

<ItemGroupCondition="'$(TEST_NET40_FSHARPQA_SUITE)'=='1' OR '$(TEST_NET40_FSHARP_SUITE)'=='1'" >

<ProjectsWithNet40Include="tests/fsharpqa/testenv/src/ILComparer/ILComparer.fsproj" />

<ProjectsWithNet40Include="tests/fsharpqa/testenv/src/HostedCompilerServer/HostedCompilerServer.fsproj" />

<ProjectsWithNet40Include="tests/fsharpqa/testenv/src/PEVerify/PEVerify.csproj" />

<ProjectsToRestoreInclude="tests/fsharpqa/testenv/src/PEVerify/PEVerify.csproj" />

</ItemGroup>

<ItemGroupCondition="'$(TEST_VS_IDEUNIT_SUITE)'=='1'" >

<MSBuildProjects="@(NugetProjects)"Targets="Clean"BuildInParallel="false"Properties="Configuration=$(Configuration);$(CustomProps)" />

<MSBuildProjects="@(SetupProjects)"Targets="Clean"BuildInParallel="false"Properties="Configuration=$(Configuration);BUILD_PUBLICSIGN=$(BUILD_PUBLICSIGN);$(CustomProps)" />

</Target>

<TargetName="Restore">

<MSBuildProjects="@(ProjectsToRestore)"Targets="Restore" />

</Target>

</Project>

echo ---------------- Done with proto, starting build ------------------------

if"%BUILD_PHASE%"=="1" (

echo%_msbuildexe%%msbuildflags% build-everything.proj /p:Configuration=%BUILD_CONFIG%%BUILD_DIAG% /p:BUILD_PUBLICSIGN=%BUILD_PUBLICSIGN%

%_msbuildexe%%msbuildflags% build-everything.proj /p:Configuration=%BUILD_CONFIG%%BUILD_DIAG% /p:BUILD_PUBLICSIGN=%BUILD_PUBLICSIGN%

echo%_msbuildexe%%msbuildflags% build-everything.proj /t:Restore

%_msbuildexe%%msbuildflags% build-everything.proj /t:Restore

echo%_msbuildexe%%msbuildflags% build-everything.proj /p:Configuration=%BUILD_CONFIG%%BUILD_DIAG% /p:BUILD_PUBLICSIGN=%BUILD_PUBLICSIGN%

%_msbuildexe%%msbuildflags% build-everything.proj /p:Configuration=%BUILD_CONFIG%%BUILD_DIAG% /p:BUILD_PUBLICSIGN=%BUILD_PUBLICSIGN%

@if ERRORLEVEL1echo Error build failed&&goto :failure

)

<CompileInclude="$(FSharpSourcesRoot)\..\tests\service\ProjectOptionsTests.fs">

<Link>ProjectOptionsTests.fs</Link>

</Compile>

<CompileInclude="$(FSharpSourcesRoot)\..\tests\service\StructureTests.fs">

<Link>StructureTests.fs</Link>

</Compile>

<NoneInclude="$(FSharpSourcesRoot)\..\packages\FSharp.Compiler.Tools.4.1.27\tools\FSharp.Core.optdata">

<Link>FSharp.Core.optdata</Link>

<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>

membersFunctionsAndValues

|> Seq.filter(fun x->not x.IsInstanceMember)

|> Seq.filter(fun x->not x.IsInstanceMember&&not x.IsPropertyGetterMethod&&not x.IsPropertySetterMethod)

|> Seq.collect(fun func->

{ FullName= fullName

| SynExpr.DotIndexedGet(e,_,_,_)

| SynExpr.DotIndexedSet(e,_,_,_,_,_)-> parseExpr e

| SynExpr.New(_,_,expr,r)->

letcollapse= Range.endToEnd expr.Range r

rcheck Scope.New Collapse.Below r collapse

rcheck Scope.New Collapse.Below r expr.Range

parseExpr expr

| SynExpr.YieldOrReturn(_,e,r)->

rcheck Scope.YieldOrReturn Collapse.Below r r

<?xml version="1.0" encoding="utf-8"?>

<packages>

<packageid="Microsoft.Net.Compilers"version="2.4.0" />

<packageid="NUnit3TestAdapter"version="3.7.0"targetFramework="net45" />

<packageid="runtime.win-x64.Microsoft.NETCore.ILDAsm"version="2.0.3" />

<packageid="runtime.win-x86.Microsoft.NETCore.ILDAsm"version="2.0.3" />

<packageid="runtime.win-x64.Microsoft.NETCore.Runtime.CoreCLR"version="2.0.3" />

<packageid="runtime.win-x86.Microsoft.NETCore.Runtime.CoreCLR"version="2.0.3" />

<packageid="System.Collections.Immutable"version="1.3.1"targetFramework="net45" />

<packageid="System.Reflection.Metadata"version="1.4.2"targetFramework="net45" />

</packages>

{ EnvironmentVariables:Map<string, string>

CORDIR:string

CORSDK:string

CSC:string

csc_flags:string

BUILD_CONFIG:string

[|"PROCESSOR_ARCHITECTURE"|]|> Seq.tryPick(fun s-> find s)|>function None->""| Some x-> x

value="AMD64"

match envVars|> Map.tryFind"windir"with

| Some x-> x

| None-> failwithf"environment variable '%s' required""WINDIR"

match Directory.EnumerateDirectories(windir++"Microsoft.NET"++"Framework","v4.0.?????")|> List.ofSeq|> List.revwith

| x::_-> x

|[]-> failwith"couldn't determine CORDIR"

if Is64BitOperatingSystem envVarsthen

CORDIR<- CORDIR.Replace("Framework","Framework64")

letfind s= envVars|> Map.tryFind s

|> Seq.tryPick find

| None->@"C:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.6.1 Tools\x64\"

| Some x-> x

CORDIR, CORSDK

{ FSCOREDLLPATH:string}

letCORDIR,CORSDK= WindowsPlatform.clrPaths envVars

letIs64BitOperatingSystem= WindowsPlatform.Is64BitOperatingSystem envVars

letarchitectureMoniker=if Is64BitOperatingSystemthen"x64"else"x86"

letCSC= requireFile(CORDIR++"csc.exe")

letCSC= requireFile(packagesDir++"Microsoft.Net.Compilers.2.4.0"++"tools"++"csc.exe")

letILDASM= requireFile(packagesDir++("runtime.win-"+ architectureMoniker+".Microsoft.NETCore.ILDAsm.2.0.3")++"runtimes"++("win-"+ architectureMoniker)++"native"++"ildasm.exe")

letPEVERIFY= requireFile(CORSDK++"peverify.exe")

letcoreclrdll= requireFile(packagesDir++("runtime.win-"+ architectureMoniker+".Microsoft.NETCore.Runtime.CoreCLR.2.0.3")++"runtimes"++("win-"+ architectureMoniker)++"native"++"coreclr.dll")

letPEVERIFY= requireFile(SCRIPT_ROOT++".."++"fsharpqa"++"testenv"++"src"++"PEVerify"++"bin"++ configurationName++"net46"++"PEVerify.exe")

match envVars|> Map.tryFind"_fsiexe"with

| Some fsiexewhen(not(String.IsNullOrWhiteSpace fsiexe))-> requireFile(SCRIPT_ROOT++".."++".."++(fsiexe.Trim([|'\"'|])))

|_-> failwithf"Found more than one 'FSharp.Compiler.Tools' inside '%s', please clean up." packagesDir

lettoolsDir= SCRIPT_ROOT++".."++".."++"Tools"

letdotNetExe= toolsDir++"dotnetcli"++"dotnet.exe"

letcoreclrSource= toolsDir++"dotnet20"++"shared"++"Microsoft.NETCore.App"++"2.0.0"++"coreclr.dll"

File.Copy(coreclrSource, Path.GetDirectoryName(ILDASM)++"coreclr.dll", overwrite=true)

File.Copy(coreclrdll, Path.GetDirectoryName(ILDASM)++"coreclr.dll", overwrite=true)

#if!FSHARP_SUITE_DRIVES_CORECLR_TESTS

letFSI= requireFile(FSCBinPath++"fsi.exe")

{ EnvironmentVariables= envVars

CORDIR= CORDIR|> Commands.pathAddBackslash

CORSDK= CORSDK|> Commands.pathAddBackslash

FSCBinPath= FSCBinPath|> Commands.pathAddBackslash

FSCOREDLLPATH= FSCOREDLLPATH

ILDASM= ILDASM

log"---------------------------------------------------------------"

log"Executables"

log""

log"CORDIR =%s" cfg.CORDIR

log"CORSDK =%s" cfg.CORSDK

log"CSC =%s" cfg.CSC

log"BUILD_CONFIG =%s" cfg.BUILD_CONFIG

log"csc_flags =%s" cfg.csc_flags

my$PEVERIFY =$ENV{PEVERIFY};

unless(defined($PEVERIFY)) {

foreach$_ (split /;/,$ENV{PATH}) {

$PEVERIFY ="peverify.exe"if(-e"$_\\peverify.exe");

my$scriptPath = dirname(__FILE__);

$PEVERIFY ="$scriptPath\\..\\testenv\\src\\PEVerify\\bin\\Release\\net46\\PEVerify.exe";

if (-e$PEVERIFY) {

$ENV{PEVERIFY} =$PEVERIFY;

}

else {

$ENV{PEVERIFY} ="$scriptPath\\..\\testenv\\src\\PEVerify\\bin\\Debug\\net46\\PEVerify.exe";

}

$ENV{PEVERIFY} =$PEVERIFY;

}