Visual Studio Code

Note

This guide is about Visual Studio Code (VSCode), not the regular Visual Studio

Now that you have the source code you should first make sure that the lib folder in the repository contains the correct files

You should also make sure that you have the following extensions installed in VSCode:

• C#

• C# Dev Kit

Now open the root of the repository in VSCode.

Go to “Run and Debug” from the Primary Side Bar.

This should prompt you to create a launch.json file. Accept the creation of this file and make sure it has the following content:

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "C#: SegnoSharp Debug",
            "type": "coreclr",
            "request": "launch",
            "program": "${workspaceFolder}/src/SegnoSharp/bin/Debug/net9.0/Whitestone.SegnoSharp.dll",
            "cwd": "${workspaceFolder}/src/SegnoSharp",
            "env": {
                "SegnoSharp_SiteConfig__DataPath": "${workspaceFolder}/data",
                "SegnoSharp_SiteConfig__LibPath": "${workspaceFolder}/lib",
                "SegnoSharp_SiteConfig__MusicPath": "${workspaceFolder}/music",
                "SegnoSharp_OpenIdConnect__UseOidc": "false"
            }
        }
    ]
}

You can now open src/SegnoSharp.sln in Visual Studio.

When the repository has been opened, make sure to create a tasks.json in the same place that launch.json was created (a hidden folder called .vscode). Make sure it has the following content:

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "dotnet",
            "task": "build",
            "file": "${workspaceFolder}/src/SegnoSharp.sln",
            "group": "build",
            "problemMatcher": [],
            "label": "dotnet: Build SegnoSharp solution"
        }
    ]
}

You can now open the build tasks (default shortcut is Ctrl+Shift+B) and select dotnet: Build SegnoSharp Solution. This should build the solution and you can observe the build progress in the Terminal.

Now that the solution has been built, go back to “Run and Debug” from the Primary Side Bar, and press the play button, which should have C#: SegnoSharp Debug next to it. SegnoSharp will now start.