1-setup.md

Machine Setup

This workshop will be using the following tools:

• .NET 8 SDK
• .NET Aspire Workload
• Docker Desktop or Podman
• Visual Studio 2022 or Visual Studio Code with C# Dev Kit

For the best experience, we recommend using Visual Studio 2022 with the .NET Aspire workload. However, you can use Visual Studio Code with the C# Dev Kit and .NET Aspire workload. Below are setup guides for each platform.

Windows with Visual Studio

• Install Visual Studio 2022 version 17.11 or newer.
  • Any edition will work including the free to use Visual Studio Community
  • Select the following workloads:
    • ASP.NET and web development workload.
    • .NET Aspire SDK component in Individual components.

Mac, Linux, & Windows without Visual Studio

• Install the latest .NET 8 SDK
• Install the .NET Aspire workload with the following commands:

dotnet workload update
dotnet workload install aspire

Note: These commands may require sudo

• Install Visual Studio Code with C# Dev Kit

Note: When running on Mac with Apple Silicon (M series processor), Rosetta 2 for grpc-tools.

Test Installation

To test your installation, see the Build your first .NET Aspire project for more information.

Open Workshop Start Solution

To start the workshop open start-with-api/MyWeatherHub.sln in Visual Studio 2022. If you are using Visual Studio code open the start-with-api folder and when prompted by the C# Dev Kit which solution to open, select MyWeatherHub.sln.