You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* Update How To Debug MIEngine.md
Added information on how to debug with VS Code
* Update How To Debug MIEngine.md
* .dll -> .pdb
Mistake on symbol list
@@ -51,11 +52,13 @@ This will cause the debugger to look like it has hung once you start debugging,
51
52
52
53
### Debugging MIEngine running on Linux or Mac OS X
53
54
55
+
#### With MonoDevelop
56
+
54
57
On Linux and Mac OS X, we use `mono` as our framework. You can download Xamarin Studio v5.10.1.6 and remotely attach to your Mac or Linux box to debug there.
2. Install [Xamarin Studio v5.10.1.6](http://download.xamarin.com/studio/Windows/XamarinStudio-5.10.1.6-0.msi).
59
62
60
63
Remote attach functionality behind a flag. You can run it like this:
61
64
```PowerShell
@@ -64,26 +67,60 @@ set MONODEVELOP_SDB_TEST=1
64
67
MonoDevelop.exe
65
68
```
66
69
67
-
#### Create an empty project for attaching (one-time setup)
70
+
#####Create an empty project for attaching (one-time setup)
68
71
69
-
1. Launch MonoDevelop
70
-
2. File -> New Solution
71
-
3. Misc/Generic Project
72
-
4. Name project and hit "Create"
73
-
5. Right-click the project node (blue square) and do "Options"
72
+
1. Launch MonoDevelop.
73
+
2. File -> New Solution.
74
+
3. Misc/Generic Project.
75
+
4. Name project and hit "Create".
76
+
5. Right-click the project node (blue square) and do "Options".
74
77
6. Under Run -> Custom Commands, select "Execute" in the lower dropdown and choose a command (I use `c:\windows\notepad.exe` - it doesn't matter what the command is, but MonoDevelop requires it to exist before it'll light up the Run menu).
75
78
76
-
#### Configure the extension to enable remote debugging
79
+
#####Configure the extension to enable remote debugging
77
80
78
81
Open the **~/.vscode/extensions/ms-vscode.cpptools-\<version\>/debugAdapters/OpenDebugAD7** file with a text editor and locate and uncomment the line at the bottom. When you start debugging, it will now hang until the remote debugger is attached from Xamarin Studio.
79
82
80
-
#### Attach the remote debugger
83
+
#####Attach the remote debugger
81
84
82
-
In MonoDevelop: Run -> Run With -> Custom Command Mono Soft Debugger
83
-
Fill in the IP and port of the Linux/Mac OS X machine and hit "Connect" to start debugging
85
+
In MonoDevelop: Run -> Run With -> Custom Command Mono Soft Debugger.
86
+
Fill in the IP and port of the Linux/Mac OS X machine and hit "Connect" to start debugging.
84
87
85
88
After you've done this once, you can hit the MonoDevelop "Play" button or <kbd>F5</kbd> to bring up the connect dialog again.
86
89
87
-
Note: If you are debugging to CentOS, you will need to make an exception in the firewall
1. Open to a new folder and create `.vscode/launch.json`.
98
+
2. Create the following configuration in launch.json.
99
+
```
100
+
{
101
+
"version": "0.2.0",
102
+
"configurations": [
103
+
{
104
+
"name": "Attach to Mono",
105
+
"request": "attach",
106
+
"type": "mono",
107
+
"address": "<INSERT_MACHINE_IP_ADDRESS_HERE>",
108
+
"port": 1234
109
+
}
110
+
]
111
+
}
112
+
```
113
+
114
+
##### Configure the extension to enable remote debugging
115
+
116
+
Open the **~/.vscode/extensions/ms-vscode.cpptools-\<version\>/debugAdapters/OpenDebugAD7** file with a text editor and locate and uncomment the line at the bottom. When you start debugging, it will now hang until the remote debugger is attached from VS Code.
117
+
118
+
##### Attach the remote debugger
119
+
120
+
Selet the `Attach to Mono` configuration and hit F5.
121
+
122
+
#### Additional Notes
123
+
124
+
Note: If you are debugging to CentOS, you will need to make an exception in the firewall.
0 commit comments