|
1 | | -# ilspy-vscode (Extension) |
| 1 | +# ILSpy Visual Studio Code Extension |
2 | 2 |
|
3 | | -This is the actual VSCode extension part of the project, which fulfills following tasks: |
| 3 | +The ILSpy extension for VS Code is a cross-platform implementation of ILSpy .NET assembly browser and decompiler running inside of Visual Studio Code - in contrast to the [ILSpy desktop application](https://github.com/icsharpcode/ILSpy) running standalone on Windows systems. |
4 | 4 |
|
5 | | -* Integrates ILSpy UI elements (like Assembly Tree, Search and Analyze panels, palette commands) into VSCode shell |
6 | | -* Manages extension settings (global and workspace-specific) |
7 | | -* Controls [backend](../backend/README.md) process launching it at startup and initializing it with configuration |
8 | | -* Installs a required version of .NET runtime using Microsoft's [.NET Install Tool for Extension Authors](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.vscode-dotnet-runtime) |
| 5 | + |
9 | 6 |
|
10 | | -A description of the extension's features can be found in [Feature Tour](https://github.com/icsharpcode/ilspy-vscode/wiki/Feature-Tour). |
| 7 | +## Getting Started |
11 | 8 |
|
12 | | -## Export decompiled code |
| 9 | +* [Installation](https://github.com/icsharpcode/ilspy-vscode/wiki/Installation) |
| 10 | +* [Feature Tour](https://github.com/icsharpcode/ilspy-vscode/wiki/Feature-Tour) |
13 | 11 |
|
14 | | -To export all decompiled code of a loaded assembly, right-click the assembly node in the `ILSpy: Assemblies` view and run `Export Decompiled Code...`. This will generate a complete C# project including: |
15 | | -- All decompiled source files organized by namespace |
16 | | -- A .csproj project file for easy compilation |
| 12 | +See the [Feature Comparison List](https://github.com/icsharpcode/ilspy-vscode/wiki/Feature-Comparison) for the differences between ILSpy desktop application and the VS Code extension. |
17 | 13 |
|
18 | 14 | ## Requirements |
19 | 15 |
|
20 | | -- Visual Studio Code >= 1.101 |
| 16 | +- Visual Studio Code >= 1.110 |
21 | 17 | - .NET 10.0 (installed automatically on first start) |
22 | 18 | - Node.js (22 or newer) |
23 | 19 | - PNPM |
24 | | - |
25 | | -## Development |
26 | | - |
27 | | -To debug and run the extension, you first need to build and package the backend: |
28 | | - |
29 | | -``` |
30 | | -cd .. |
31 | | -buildtools/publish-backend |
32 | | -``` |
33 | | - |
34 | | -The backend's binaries are automatically copied to `vscode-extension/bin/ilspy-backend`, where the extension expects them. |
35 | | - |
36 | | -Then initialize the project with |
37 | | - |
38 | | -``` |
39 | | -pnpm install |
40 | | -``` |
41 | | - |
42 | | -Open this directory in Visual Studio Code and start debugging with <kbd>F5</kbd>. A development instance of VS Code will open with the latest extension code running. |
0 commit comments