Skip to content
Permalink
Browse files

Update "How to build" in readme.

  • Loading branch information...
dgrunwald committed Feb 24, 2019
1 parent d677ee6 commit c1f2ccf24f44a616402f1d6bd15bb9069d56f669
Showing with 14 additions and 7 deletions.
  1. +1 −1 ICSharpCode.Decompiler.Tests/Helpers/Tester.cs
  2. +13 −6 README.md
@@ -183,7 +183,7 @@ private static string ReplacePrivImplDetails(string il)

static readonly Lazy<IEnumerable<MetadataReference>> defaultReferences = new Lazy<IEnumerable<MetadataReference>>(delegate {
string refAsmPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.ProgramFilesX86),
@"Reference Assemblies\Microsoft\Framework\.NETFramework\v4.5");
@"Reference Assemblies\Microsoft\Framework\.NETFramework\v4.6.2");
string thisAsmPath = Path.GetDirectoryName(typeof(Tester).Assembly.Location);
return new[]
{
@@ -47,16 +47,23 @@ How to build
------------

Windows:
- Check out the repository using git.
- Execute `git submodule update --init --recursive` to get all required submodules.
- Use ILSpy.sln to work.

(Optional, Windows-only) Note: If you want to use the same build configuration as the build server, you will have to install `VC++ 2017 version 15.7 v14.14 latest v141 tools` (or similar) from the "Individual components" section in the Visual Studio Setup. We use `editbin.exe` to modify the stack size used by ILSpy.exe from 1MB to 16MB, because the decompiler makes heavy use of recursion, where small stack sizes lead to problems in very complex methods.
- Install Visual Studio (minimum version: 2017.7) with the following components:
- Workload ".NET Desktop Development"
- .NET Framework 4.6.2 Targeting Pack (if the VS installer does not offer this option, install the [.NET 4.6.2 developer pack](https://www.microsoft.com/en-us/download/details.aspx?id=53321) separately)
- Individual Component "VC++ 2017 version 15.9 v14.16 latest v141 tools" (or similar)
- The VC++ toolset is optional; if present it is used for `editbin.exe` to modify the stack size used by ILSpy.exe from 1MB to 16MB, because the decompiler makes heavy use of recursion, where small stack sizes lead to problems in very complex methods.
- Install the [.NET Core SDK 2.2](https://dotnet.microsoft.com/download)
- Check out the ILSpy repository using git.
- Execute `git submodule update --init --recursive` to download the ILSpy-Tests submodule (used by some test cases).
- Open ILSpy.sln in Visual Studio.
- NuGet package restore will automatically download further dependencies
- Run project "ILSpy" for the ILSpy UI
- Use the Visual Studio "Test Explorer" to see/run the tests

Unix:
- Make sure .NET Core 2.2 is installed (you can get it here: https://get.dot.net).
- Check out the repository using git.
- Execute `git submodule update --init --recursive` to get all required submodules.
- Execute `git submodule update --init --recursive` to download the ILSpy-Tests submodule (used by some test cases).
- Use `dotnet build Frontends.sln` to build the non-Windows flavors of ILSpy (cli and powershell core).

(Visual Studio for Mac users only:)

0 comments on commit c1f2ccf

Please sign in to comment.
You can’t perform that action at this time.