Dette kurset forutsetter at du har noen verktøy installert på maskinen din. Se gjennom listen under for å sørge for at du har det som trengs.
Å installere og bruke Git er valgfritt, men er kjekt å ha dersom du ønsker å ha veiledningen, og løsningsforslag, lokalt på maskinen din.
For å gjennomføre kurset må du ha satt opp følgende:
Når man installerer .NET har man valget mellom å installere
Ettersom du gjennom kurset skal utvikle og kjøre .NET-applikasjoner trenger du .NET SDK installert på maskinen din. Kurset er laget med .NET 6, men de fleste kommandoene fungerer nok med en versjon av .NET Core, og vil trolig være tilgjengelig i fremtidige versjoner også. Du kan undersøke hvilken versjon av .NET du har lokalt (om noen i det hele tatt) ved å kjøre følgende kommando
dotnet --version
6.0.101
Dersom du ikke har .NET installert på maskinen din, kan du laste det ned her: https://dotnet.microsoft.com/download/dotnet
Som nevnt over inkluderer .NET SDK også .NET CLI som gir oss muligheten til å bygge, kjøre og publisere .NET-applikasjoner. Etter å ha installert .NET CLI kan man kjøre dotnet-kommandoer i terminalen. For at kurset skal kunne gjennomføres uavhengig av plattform og IDE skal vi bruke .NET CLI til oppsett av løsningen vår.
Veiledningen forklarer det grunnleggende om kommandoene vi kommer til å bruke i .NET CLI. Dersom du ønsker mer utfyllende informasjon eller oversikt over alle kommandoene kan du lese mer om .NET CLI her: https://docs.microsoft.com/en-us/dotnet/core/tools/
Som vi skal se nøyere på i steg 4 bruker man “NuGet”-pakker for å dele kode mellom .NET-prosjekter. NuGet har en offentlig repo med pakker som er tilgjengelig på https://www.nuget.org/. Dersom du ikke har brukt NuGet på Windows-maskinen din før kan det være at du må instruere NuGet til å hente pakker derfra.
Åpne filen C:/Users/<ditt brukernavn>/AppData/Roaming/NuGet/NuGet.Config, og lim inn følgende innhold:
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<packageSources>
<add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
</packageSources>
</configuration>
For å kunne debugge kode, få syntax highlighting og visning av kompileringsfeil, autocomplete, og kodenavigering er det kjekt å ha en IDE. De mest brukte IDE-ene for .NET er oppsummert i tabellen under.
| Navn | Plattform | Lisens | Download |
|---|---|---|---|
| Visual Studio | Windows | Community-versjon er gratis. Øvrige versjoner krever lisens. | https://visualstudio.microsoft.com/vs/community |
| Visual Studio Code | Kryssplattform | Gratis | https://code.visualstudio.com/download |
| Rider | Kryssplattform | Gratis i 30 dager. Deretter kreves lisens. | https://www.jetbrains.com/rider/download |
Velg den IDE-en som passer dine behov.
Dersom du skal bruke Visual Studio Code, anbefales det å installere pluginen “Ionide”.
- Du kan laste ned Ionide her: https://docs.microsoft.com/en-us/dotnet/fsharp/get-started/get-started-vscode
- Du kan lese mer om Ionide her: https://ionide.io/
Merk at et vanlig use case for IDE-er er at de også blir brukt til å kompilere og kjøre kode. Instruksjonene i kurset kommer imidlertid til å benytte .NET CLI til dette. Du står selvfølgelig fritt frem til å bygge og kjøre koden ved hjelp av din IDE hvis du ønsker det.
Git er et gratis versjonshåndteringssystem som finnes til alle plattformer. Dersom du ønsker å ha instruksjonene til kurset (dokumentet du leser nå), eller se forventet resultat etter å ha gjennomført hvert av de ulike stegene, på din egen maskin, trenger du Git installert. Med Git kan du også lage din egen versjon av dette repoet slik som forklart her.
Du kan laste ned Git her: https://git-scm.com/downloads.
Dersom Git er nytt for deg kan det være nyttig å lese denne artikkelen om hvordan man jobber med endringer i et Git-repo: https://git-scm.com/book/en/v2/Git-Basics-Recording-Changes-to-the-Repository. Det er forøvrig instruksjoner på slutten av første steg for hvordan du kan lagre endringer du gjør underveis i kurset i Git.
Dersom du ønsker dette repoet lokalt på din maskin, kan forke dette repoet til din egen bruker ved å følge denne guiden: https://docs.github.com/en/get-started/quickstart/fork-a-repo. Deretter kan du klone det, slik:
git clone git@github.com:<ditt brukernavn>/dotnetskolen.git # Last ned repo fra GitHub til din maskin
Cloning into 'dotnetskolen'...
remote: Enumerating objects: 9, done.
remote: Counting objects: 100% (9/9), done.
remote: Compressing objects: 100% (5/5), done.
remote: Total 9 (delta 2), reused 4 (delta 1), pack-reused 0
Receiving objects: 100% (9/9), done.
Resolving deltas: 100% (2/2), done.
Kommandoen over forutsetter at man bruker SSH for autentisering overfor GitHub. For mer informasjon om SSH-autentisering i GitHub se https://docs.github.com/en/authentication/connecting-to-github-with-ssh
Dersom man ønsker å klone med HTTPS istedenfor må man kjøre kommandoen over med denne URL-en istedenfor:
https://github.com/<ditt brukernavn>/dotnetskolen.git, og oppgi brukernavn og passord.Ev. kan man bruke GitHub sin desktopklient
Da skal nå ha main-branchen sjekket ut lokalt på din maskin. Det kan du verifisere ved å gå inn i mappen til repoet og liste ut branchene i Git:
cd dotnetskolen # Gå inn i mappen som repoet ligger i lokalt
git branch # List ut alle brancher du har sjekket ut lokalt
* main
Før du begynner å kode kan du gjerne lage din egen branch med git checkout -b <branchnavn>. På denne måten kan du holde dine endringer adskilt fra koden som ligger i repoet fra før, og det er lettere for kursholder å hjelpe deg dersom du har behov for det.
git checkout -b my-branch
Switched to a new branch 'my-branch'
Vanligvis er det en del filer man ikke ønsker å ha inkludert i Git. Dette er noe man fort merker ved etablering av et nytt system. For å fortelle Git hvilke filer man vil ignorere, oppretter man en .gitignore-fil i roten av repoet.
GitHub har et eget repo som inneholder .gitignore-filer for ulike typer prosjekter: https://github.com/github/gitignore. .gitignore-filene GitHub har utarbeidet inneholder filtypene det er vanligst å utelate fra Git for de ulike prosjekttypene. Ettersom dette kurset omhandler .NET kan vi bruke VisualStudio.gitignore fra repoet deres.
For å sette opp .gitignore i ditt lokale repo:
.gitignore i roten av repoet.gitignore-filen..gitignoreFor å vise status i Git, kjør følgende kommando:
git status
On branch my-branch
Untracked files:
(use "git add <file>..." to include in what will be committed)
.gitignore
nothing added to commit but untracked files present (use "git add" to track)
Over ser vi at Git har oppdaget at .gitignore er en ny fil som Git ikke sporer.
For å legge til .gitignore i Git slik at Git kan spore ev. endringer i den filen i fremtiden, kjør følgende kommando:
git add .gitignore
For å se status i Git igjen, kjør følgende kommando:
git status
On branch my-branch
Changes to be committed:
(use "git restore --staged <file>..." to unstage)
new file: .gitignore
For å lagre nåværende versjon av .gitignore i Git, kjør følgende kommando:
git commit -m "La til .gitignore"
[my-branch 478fb9b] La til .gitignore
1 file changed, 1 insertion(+)
create mode 100644 .gitignore
Nå er innholdet i .gitignore lagret i Git. Dersom du nå kjører git status på nytt, vil du se at det ikke er noen gjenstående endringer i repoet som Git ikke har fått med seg:
git status
On branch my-branch
nothing to commit, working tree clean