add notes about building on windows

cosmonaut 2020-11-16 22:55:53 -08:00
parent be35d44944
commit d27aee2705
1 changed files with 13 additions and 10 deletions

View File

@ -1,22 +1,23 @@
# FNA-VSCode-Template # FNA-VSCode-Template
Template and build tasks for developing a cross-platform multi-target .NET Framework and .NET Core FNA project in VSCode. Template and build tasks for developing a cross-platform multi-target .NET Framework, Mono, and .NET Core FNA project in VSCode.
## Features ## Features
- Includes project boilerplate code - Includes project boilerplate code
- Build tasks for both .NET Framework and .NET Core side by side - Build tasks for both .NET Framework, Mono, and .NET Core side by side
- Press F5 to build and debug in-editor with Core Debugger - VSCode debugger integration
## Requirements ## Requirements
- [Git](https://git-scm.com/) - [Git](https://git-scm.com/) or [Git for Windows](https://gitforwindows.org/) on Windows
- [Git for Windows](https://gitforwindows.org/) if on Windows - [.NET Core SDK](https://dotnet.microsoft.com/download/dotnet-core)
- [.NET Framework 4.8 SDK](https://dotnet.microsoft.com/download/visual-studio-sdks) on Windows
- [Build Tools for Visual Studio 2019](https://visualstudio.microsoft.com/downloads/) on Windows
- [Mono](https://www.mono-project.com/) on OSX or Linux
- [Visual Studio Code](https://code.visualstudio.com/) - [Visual Studio Code](https://code.visualstudio.com/)
- [VSCode C# Extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode.csharp) - [VSCode C# Extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode.csharp)
- [.NET Core SDK](https://dotnet.microsoft.com/download/dotnet-core) - [VSCode Mono Debug Extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode.mono-debug) if debugging using Mono
- [.NET Framework SDK](https://dotnet.microsoft.com/download/visual-studio-sdks) or [Mono](https://www.mono-project.com/)
## Installation ## Installation
@ -24,14 +25,16 @@ Template and build tasks for developing a cross-platform multi-target .NET Frame
- Download this repository - Download this repository
- Run `install.sh` - Run `install.sh`
- Move the newly created project directory wherever you want - Move the newly created project directory wherever you want
- 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
## Usage ## Usage
- Open the project directory in VSCode - Open the project directory in VSCode
- Press Ctrl-Shift-B to open the build tasks menu - Press Ctrl-Shift-B to open the build tasks menu
- `Framework` tasks use .NET Framework or Mono to build and run - `Framework` tasks use .NET Framework to build and run (Windows only)
- `Mono` tasks use Mono to build and run
- `Core` tasks use .NET Core to build and run - `Core` tasks use .NET Core to build and run
- Press F5 to build and debug with Core Debugger - Press F5 to build and debug
## Acknowledgments ## Acknowledgments