FNA-VSCode-Template/README.md

44 lines
1.8 KiB
Markdown
Raw Normal View History

2020-03-04 00:03:33 +00:00
# FNA-VSCode-Template
2021-02-03 04:37:02 +00:00
Template and build tasks for developing a cross-platform multi-target .NET Framework, Mono, and .NET 5 FNA project in VSCode.
The generated solution file will also work in regular Visual Studio.
2020-03-04 00:03:33 +00:00
## Features
- Includes project boilerplate code
2021-02-03 04:37:02 +00:00
- Build tasks for both .NET Framework, Mono, and .NET 5 side by side
2020-11-17 06:55:53 +00:00
- VSCode debugger integration
2020-03-04 00:03:33 +00:00
## Requirements
2020-11-17 06:55:53 +00:00
- [Git](https://git-scm.com/) or [Git for Windows](https://gitforwindows.org/) on Windows
2021-02-03 04:37:02 +00:00
- [.NET 5 SDK](https://dotnet.microsoft.com/download/dotnet/5.0)
- [.NET Framework 4.6.1 Developer Pack](https://dotnet.microsoft.com/download/dotnet-framework/net461) on Windows
2020-11-17 06:55:53 +00:00
- [Build Tools for Visual Studio 2019](https://visualstudio.microsoft.com/downloads/) on Windows
- [Mono](https://www.mono-project.com/) on OSX or Linux
2020-03-04 00:03:33 +00:00
- [Visual Studio Code](https://code.visualstudio.com/)
- [VSCode C# Extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode.csharp)
2020-11-17 06:55:53 +00:00
- [VSCode Mono Debug Extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode.mono-debug) if debugging using Mono
2020-03-04 00:03:33 +00:00
## Installation
2020-03-04 00:25:53 +00:00
- Make sure you have Git Bash from Git for Windows if you are on Windows
2020-03-04 00:03:33 +00:00
- Download this repository
2020-03-04 00:25:53 +00:00
- Run `install.sh`
2020-03-04 00:22:12 +00:00
- Move the newly created project directory wherever you want
2020-11-17 06:55:53 +00:00
- On Windows, add `C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\MSBuild\Current\Bin` to your system environment PATH variable after installing Build Tools for VS 2019
2020-03-04 00:22:12 +00:00
## Usage
- Open the project directory in VSCode
- Press Ctrl-Shift-B to open the build tasks menu
2020-11-17 06:55:53 +00:00
- `Framework` tasks use .NET Framework to build and run (Windows only)
- `Mono` tasks use Mono to build and run
2021-02-03 04:37:02 +00:00
- `5` tasks use .NET 5 to build and run
2020-11-17 06:55:53 +00:00
- Press F5 to build and debug
2020-03-04 00:03:33 +00:00
## Acknowledgments
Thanks to Andrew Russell and Caleb Cornett's FNA templates for a starting point for this template.