forked from microsoft/vscode-mono-debug
-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Support just setting program property
- Update readme - Update launch template
- Loading branch information
Showing
3 changed files
with
36 additions
and
48 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,66 +1,46 @@ | ||
# VS Code Mono Debug | ||
# VS Code Rhino Debug | ||
|
||
A simple VS Code debugger extension for the Mono VM. Its implementation was inspired by the [SDB](https://github.com/mono/sdb) command line debugger. | ||
A simple VS Code debugger extension for Rhinoceros based on [vscode-mono-debug](https://github.com/microsoft/vscode-mono-debug). | ||
|
||
![Mono Debug](images/mono-debug.png) | ||
## Using the extension | ||
|
||
## Installing Mono | ||
|
||
You can either download the latest Mono version for Linux, macOS, or Windows at the [Mono project website](https://www.mono-project.com/download/) or you can use your package manager. | ||
|
||
* On OS X: `brew install mono` | ||
* On Ubuntu, Debian, Raspbian: `sudo apt-get install mono-complete` | ||
* On CentOS: `yum install mono-complete` | ||
* On Fedora: `dnf install mono-complete` | ||
|
||
## Enable Mono debugging | ||
|
||
To enable debugging of Mono based C# (and F#) programs, you have to pass the `-debug` option to the compiler: | ||
|
||
```bash | ||
csc -debug Program.cs | ||
``` | ||
|
||
If you want to attach the VS Code debugger to a Mono program, pass these additional arguments to the Mono runtime: | ||
|
||
```bash | ||
mono --debug --debugger-agent=transport=dt_socket,server=y,address=127.0.0.1:55555 Program.exe | ||
``` | ||
|
||
The corresponding attach `launch.json` configuration looks like this: | ||
Use a `launch.json` with the following: | ||
|
||
```json | ||
{ | ||
"version": "0.2.0", | ||
"configurations": [ | ||
{ | ||
"name": "Attach to Mono", | ||
"request": "attach", | ||
"type": "mono", | ||
"address": "localhost", | ||
"port": 55555 | ||
"name": "Launch Rhinoceros", | ||
"type": "rhino", | ||
"request": "launch", | ||
"runtimeExecutable": "/Applications/Rhinoceros.app/Contents/MacOS/Rhinoceros", | ||
"env": { | ||
// optional: register your plugin(s) to load | ||
"RHINO_PLUGIN_PATH": "${workspaceFolder}/Path/To/MyPlugin.rhp", | ||
"GRASSHOPPER_PLUGINS": "${workspaceFolder}/Path/To/MyGHPlugin.gha" | ||
} | ||
} | ||
] | ||
} | ||
``` | ||
|
||
## Building the mono-debug extension | ||
|
||
[![build status](https://github.com/microsoft/vscode-mono-debug/workflows/Extension%20CI/badge.svg)](https://github.com/microsoft/vscode-mono-debug/actions) | ||
## Building the rhino-debug extension | ||
|
||
Building and using VS Code mono-debug requires a basic POSIX-like environment, a Bash-like | ||
Building and using VS Code rhino-debug requires a basic POSIX-like environment, a Bash-like | ||
shell, and an installed Mono framework. | ||
|
||
First, clone the mono-debug project: | ||
First, clone the rhino-debug project: | ||
|
||
```bash | ||
$ git clone https://github.com/microsoft/vscode-mono-debug | ||
$ git clone https://github.com/mcneel/vscode-rhino-debug | ||
``` | ||
|
||
To build the extension vsix, run: | ||
|
||
```bash | ||
$ cd vscode-mono-debug | ||
$ cd vscode-rhino-debug | ||
$ npm install | ||
$ make | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters