blob: 43bf635a9842360d13cddadaf6538f9c9c0437c9 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
|
_Please ensure that [pre-requisites](prerequisites-for-building.md) are installed for a successful build of the repo._
_Note_:
* Instructions below assume ```~/corert``` is the repo root.
# Setting up #
Please make sure you have latest VS Code, C# extension, and .NET Core available. This guide is tested under C# 1.6.2 + VS Code 1.8.1 + CLI 1.0.0-preview4-004233.
This guide assumes that your VS code workspace is set to the root of the repo.
# Running VS Code
We've checked-in reasonable default ```launch.json``` and ```tasks.json``` under ```corert/.vscode``` directory. You only need to run vscode form corert root:
```
code ~/corert
```
And then press SHIFT+COMMAND+B to start the build.
# Debugging ILC.exe using .NET Core Debugger #
Go to the debug pane and click Debug, choose .NET Core as the environment. If needed, you can change program property in launch.json (the gear button) to point to a different flavor of ilc:
```json
"windows": {
"program": "${workspaceRoot}/bin/Windows_NT.x64.Debug/tools/ilc.dll"
},
"osx": {
"program": "${workspaceRoot}/bin/OSX.x64.Debug/tools/ilc.dll"
},
"linux": {
"program": "${workspaceRoot}/bin/Linux.x64.Debug/tools/ilc.dll"
},
```
By default we've disabled automatic build before debug. If you want to change that, you can change the ```preLaunchTask``` property to ```"build"```. But this is not currently recommended.
# Getting ILC response files
A ```.ilc.rsp``` file path can be easily obtained from a .NET core project that you want to debug by following command:
```
dotnet build /t:LinkNative /t:Rebuild /v:Detailed | grep ".ilc.rsp"
```
Once you have the ilc path, you can change ```launch.json``` accordingly:
```json
"args": ["@obj/Debug/netcoreapp2.1/native/<netcore_app_name>.ilc.rsp"],
"cwd": "<netcore_app_root_folder>",
```
* ```args``` - the argument to ILC
* ```cwd``` - the current directory where ILC is running. You can set it to the .NET Core project root.
|
