Løsning og projekt

En C# løsning (solution på engelsk – løsning på dansk er en lidt skidt oversættelse) består typisk af et eller flere projekter, og et enkelt projekt kan være en konsol-applikation (ligesom du oprettede i forrige afsnit), en web-applikation, en Windows-applikation, mobil-applikation og meget andet.

En løsning er repræsenteret af en .sln-fil, og du kan finde en visuel repræsentation i Solution Explorer-vinduet. Der kan kun være én løsning ad gangen i VS/VSC, men du må gerne have flere udviklingsmiljøer åbne på samme tid.

Hvert projekt kan være opdelt i flere filer, som kompileren vil sørge for at kompilere sammen. Et projekt er repræsenteret af en .csproj-fil, og består typisk af en eller flere .cs-filer med kode samt eventuelle konfigurationsfiler. Der kan være mange projekter under hver løsning.

Et projekt kan have en filstruktur som følger:

c:\temp\MinTest
    MinTest.sln
    \MinTest
        MinTest.csproj
        Program.cs

Hvis du åbner .sln-filen eller csproj-filen i Notepad, vil du kunne se, at det er filer VS bruger til at holde styr på løsning og tilhørende projekter. Du vil sjældent tosse rundt i disse filer, men nu ved du, hvad de består af.

Du må gerne have mange cs-filer (kodefiler) i et projekt, og du kan organisere disse, som du ønsker i mapper. Typisk vil du have en .cs-fil til hver typedefinition, og dermed ende med mange filer, men du kan også vælge at have flere typer i samme fil – kompilereren er ligeglad.

Eksempel

For at se en konkret løsning med projekter kan du gøre følgende

• åbn en terminal og naviger til en temp-mappe c:\temp eksempelvis
• opret en ny mappe MinApp og naviger til den
• opret en konsol app med dotnet new console -n MinApp.Console
• opret et klasse bibliotek med dotnet new classlib -n MinApp.ClassLibrary
• opret en sln-fil med dotnet new sln -n MinApp
• tilføj MinApp.Console til sln-fil med dotnet sln .\MinApp.sln add .\MinApp.Console\MinApp.Console.csproj
• tilføj MinApp.ClassLibrary til sln-fil med dotnet sln .\MinApp.sln add .\MinApp.ClassLibrary\MinApp.ClassLibrary.csproj
• prøv en dir for at se fil strukturen
• åbn sln-filen for at se indholdet
• gå til MinApp.Console med cd .\MinApp.Console\
• skab en reference fra MinApp.Console til MinApp.ClassLibrary med dotnet add reference ..\MinApp.ClassLibrary\MinApp.ClassLibrary.csproj
• ret class1.cs i .\MinApp.ClassLibrary til

namespace MinApp.ClassLibrary;
public class Class1
{
    public static string Test()
    {
        return "Test";
    }
}

• ret program.cs i .\MinApp.Console til

Console.WriteLine("Hello, World!");
Console.WriteLine(MinApp.ClassLibrary.Class1.Test());

• naviger til ./MinApp.Console og kør applikation med dotnet run
• det skulle gerne resultere i

Hello, World!
Test

• som beviser at de to projekter er bundet sammen

Det er et kort eksempel på en løsning med to projekter. Det kan naturligvis også gøres i VS eller Rider, men mange gange er det faktisk nemmere og hurtigere at gøre fra en terminal.

Her er et sæt AI-spørgsmål til afsnittet om Løsning og projekt – først basis, derefter ekstra/fordybelse.

Spørgsmål til AI

For at få mest muligt ud af AI-værktøjer som ChatGPT, er det vigtigt at stille klare og præcise spørgsmål (og skabe det rigtige kontekst - se her). Her er nogle spørgsmål til denne side:

Grundlæggende spørgsmål

• Hvad er forskellen på en solution (.sln) og et projekt (.csproj) i .NET?
• Hvorfor giver det mening at samle flere projekter i én løsning?
• Kan du forklare, hvordan Solution Explorer afspejler indholdet af .sln og .csproj?
• Hvad indeholder en typisk .csproj-fil, og hvad bruger værktøjerne den til?
• Hvornår giver det mening at have flere .cs-filer vs. flere typer i samme fil?
• Hvordan opretter jeg en løsning fra terminalen med dotnet new sln?
• Hvordan tilføjer jeg et eksisterende projekt til en løsning med dotnet sln add?
• Hvordan opretter jeg en konsolapp og et klassebibliotek fra terminalen?
• Hvordan opretter jeg en projektreference mellem to projekter (dotnet add reference) – og hvorfor?

Ekstra spørgsmål (til fordybelse)

• Hvad sker der, hvis .sln-filen mangler, men projekterne stadig findes – kan jeg bygge alligevel?
• Hvordan påvirker projektreferencer build-rækkefølge og afhængigheder?
• Hvilke alternativer findes til projektreferencer (fx pakke-referencer/NuGet), og hvornår bruger man hvad?
• Kan du vise et mini-eksempel på et klassebibliotek med en metode, der kaldes fra en konsolapp (og forklare namespaces)?
• Hvordan renamer man et projekt, så både mappe, .csproj-fil og namespaces hænger sammen?
• Hvad er forskellen på dotnet run i roden af løsningen vs. inde i et bestemt projekt?
• Hvordan opretter man en test-projektmappe og kobler den på løsningen (fx dotnet new xunit + dotnet sln add)?
• Kan du vise, hvordan man læser og forstår de vigtigste elementer i en simpel .csproj (TargetFramework, ItemGroup, ProjectReference)?