Skip to content

Commit 8ddba53

Browse files
committed
added missing marketplace.md
1 parent 7009f2e commit 8ddba53

File tree

1 file changed

+149
-0
lines changed

1 file changed

+149
-0
lines changed

marketplace.md

Lines changed: 149 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,149 @@
1+
# [VS .NET Linux Debugger](https://github.com/SuessLabs/VsLinuxDebug)
2+
3+
<image align="right" width="200" height="200" src="https://github.com/SuessLabs/VsLinuxDebug/blob/master/docs/TuxDebug.png" />
4+
5+
Remotely deploy and debug your .NET C# apps via SSH to Linux using Visual Studio 2022.
6+
7+
Get it on the [VS MarketPlace](https://marketplace.visualstudio.com/items?itemName=SuessLabs.VSLinuxDebugger)!
8+
9+
Visual Studio's "attach to process via SSH" is cute, but it lacks deployment and automatic attaching. This project allows you to do just that on your Linux VM or Raspberry Pi over the network!
10+
11+
Suess Labs consulting is sponsored by _Xeno Innovations, Inc._
12+
13+
## Overview
14+
15+
Now developers can build, deploy and debug projects on their remote Linux (Ubuntu, Raspberry PI, etc) devices! Customize your SSH connection to use either a _password_ or a _private key_.
16+
17+
### Usage
18+
19+
![Menu Screenshot](https://raw.githubusercontent.com/SuessLabs/VsLinuxDebug/develop/docs/ScreenShot-MenuItems.png)
20+
21+
* Build and upload to remote devices
22+
* Remote debugging*
23+
* _This is still in the experimental stages. Please use VS' Attach to Process if you have issues_
24+
* VS Linux Debugger will automatically detect and install `vsdbg` for you!
25+
26+
For GUI app debugging, you can use the _Build and Deploy_ feature, however, you must manually _Attach to Process_ via SSH using Visual Studio at this time.
27+
28+
### Getting Started
29+
30+
**Linux**, we'll need **SSH** and **cURL** for access and downloading any missing tools:
31+
32+
```bash
33+
sudo apt install openssh-server
34+
sudo apt install curl
35+
```
36+
37+
**Windows**:
38+
39+
1. Open Visual Studio (VS) > Tools > Options > **Linux Debugger**
40+
2. **Input:** Remote Host IP address
41+
3. **Input:** Remote's User Name and Password
42+
4. VS > Extensions > Linux Debugger > **Build, Deploy, Debug**
43+
44+
![Tools Options](https://raw.githubusercontent.com/SuessLabs/VsLinuxDebug/develop/docs/ScreenShot-ToolsOptions.png)
45+
46+
### Manually Attaching (for GUI apps)
47+
48+
For GUI projects, you can use **Build and Deploy** and then manually attach to the process via SSH by using Visual Studio's built-in tool
49+
50+
1. Deploy to remote machine via
51+
1. Extensions > Linux Debugger > **"Build and Deploy"**
52+
2. Run GUI app on remote machine
53+
1. `dotnet MyGuiApp.dll`
54+
3. Debug > **"Attach to Process.."**
55+
4. Connection Type: **SSH**
56+
5. Connection Target: **(Remote machine's IP)**
57+
6. (Select process)
58+
7. Click, **Attach**
59+
8. Check, **"Managed (.NET Core for Unix)"**
60+
9. Click, **OK**
61+
62+
This will save you 1.5 minutes on every build of manual uploading and updating rights via `chown -R`.
63+
64+
## Developers Wanted
65+
66+
Contributors and Q/A are welcomed!
67+
68+
To contribute, please pick off an item from the project or issue page. We'd love to hear your enhancement ideas as well.
69+
70+
## Revision History
71+
72+
This document contains the release information for the project.
73+
74+
### 2.0.1 (Prev-1)
75+
76+
* Added: Option to set output window focus to Linux Debugger, default=`false`. (PR #46)
77+
* `Tools > Options > Linux Debugger > "Switch to LinuxDbg Output on Build"`
78+
* Added: Async BASH and SFTP operations to not lock up Visual Studio (PR #40)
79+
* Added: "Experimental" tag to menu items for Alpha/Beta items. (PR# 41)
80+
* `Build, Deploy, and Debug`
81+
* `Build, Deploy, and Launch` - _Temp disabled in Preview-1_
82+
* Added: Deploy and Launch (**ALPHA Feature**) (PR #36)
83+
* Added: BashSudo (PR #36)
84+
* Update: Default VSDBG path to match Visual Studio 2022's deployed path (`~/.vs-debugger/vs2022/`). (PR #36, #47)
85+
* Update: Sample's NuGet package for Prism.Avalonia
86+
* Fixed: Typo, "Build was notsuccessful" (PR #43) `User Contribution` :rocket:
87+
* Fixed: Auto-install cURL (PR #36)
88+
* Fixed: Reduced duplicate output messages (PR #40)
89+
* Removed: Publish (PR #36)
90+
* Removed: Redundant sample project
91+
92+
### 1.9.0
93+
94+
* Added: Now comes with PLink embedded. You can still manually set this if you prefer.
95+
* Removed: Option to enable/disable PLink
96+
97+
### 1.8.1
98+
99+
* Fixed: Remote folder pre-cleanup.
100+
* Added: Upload files async to reduce locking of Visual Studio
101+
* Added: Removal of `launch.json` if it previously existed
102+
* Added: More output logging.
103+
* Update: Enhanced Output
104+
* Updated: Output Window drop-down title to "Linux Debugger" from "Remote Debugger"
105+
106+
### 1.8.0
107+
108+
* Added: Logging to Output window under "_Remote Debugging_" dropdown
109+
* Update: Do not include `launch.json` in the uploaded `.tar.gz` package
110+
* Update: Readme notes
111+
* Update: Code cleanup
112+
113+
### 1.7.0
114+
115+
* Fixed: Remote debugging for PLink
116+
* Fixed: VSDBG default path
117+
* Update: DeleteLaunchJsonAfterBuild set to false by default
118+
* Update: Separated LaunchJson class into separate objects
119+
* Updated: SSH parameters to include `-o` (option) for `StrictHostKeyChecking = NO`.
120+
* Added: Additional internal logging
121+
* Added: documentation to Launch and Configure classes
122+
123+
### 1.6.0
124+
125+
* Added: Ability to use SSH KeyFile with or without a passphrase.
126+
* Added: Directions for creating and configuring local and remote devices
127+
* Added: Additional directions in the Docs folder
128+
129+
### 1.2.0
130+
131+
* Removed: Publish option
132+
* Updated Options page defaults
133+
* Update: Remote output folder is now the assembly name
134+
* Update: Remote output folder only clears intended target sub-folder
135+
* Added: Remote Debugging (_still in preview stages.._)
136+
137+
### 1.1.1
138+
139+
* Updated: Branding name
140+
* Removed: Temp disabled remote debugger
141+
142+
### 1.0.1
143+
144+
* Update: Remote output folder now creates subfolders with the same name as your project.
145+
* Updated: project icon
146+
147+
### 1.0.0
148+
149+
* Initial release

0 commit comments

Comments
 (0)