2. Installation og opsætning#

Udviklingsmiljøet som bliver opsat i afsnittet her benytter sig af fire komponenter som alle virker på de tre store platforme (Windows, macOS og Linux):

Visual Studio Code (VS Code) (Microsoft [2]) benyttes som integrated development environment (IDE).

Git (free/libre, open source [3]) er det versionsstyringssytem som betjenes grafisk VS Code og github.com.

GitHub (Microsoft [4]) er en webbaseret hosting-service for såkaldte git repositories som tilbyder backup af repositories og tilbyder brugere at samarbejde om et repository.

Python er benyttet som programmeringssprog i alle eksempler og tutorials. VS Code, Git og github.com kan selvfølgelig bruges med et hvilket som helst andet programmeringssprog.

2.1. Installation af Git#

  1. Test om Git allerede er installeret (det kan det meget vel være).

    Åbn en terminal og kør kommandoen git --version.

    Hvis du får output ala git version 2.x så er Git allerede installeret og du behøver ikke gøre mere.

  2. Hvis Git ikke er installeret så kan du finde en installationsvejledning til de fleste store Linux-distributioner her:

    https://git-scm.com/download/linux

    Ubuntu

    I Ubuntu 16, 18, 20 og 22 kan Git installeres fra kommandolinjen med en enkelt kommando:

    sudo apt install git
    

2.2. Installation af Python#

  1. Test om Python 3.7 eller nyere er installeret.

    Kør kommandoen python3 --version i en terminal.

    1. Hvis outputtet er Python 3.x.y (og x er 7 eller større) så er Python 3 installeret og du behøver ikke gøre mere.

    2. Hvis Python ikke er installeret (output a la Command not found) kan Python med stor sandsynlighed installeres vha. din distributions package manager.

      Lav en internetsøgning efter <distro name> install python 3, e.g. ubuntu 16 install python 3.

  2. Test om Pythons package installer pip er installeret.

    Kør kommandoen pip –version i en terminal.

    1. Hvis outputtet er pip x.y.z from ... så er pip installeret og du behøver ikke gøre mere.

    2. Hvis pip ikke er installeret (output a al Command not found) kan pip med stor sandsynlighed installeres vha. din distributions package manager.

      Lav en internetsøgning efter <distro name> install python pip, e.g. ubuntu 16 install python pip.

Ubuntu

Hvis du bruger Ubuntu 18, 20 eller 22 er Python 3.7 eller nyere installeret, men du mangler Pythons package installer pip.

pip kan installeres fra kommandolinjen:

sudo apt update
sudo apt install python3-pip

2.3. Installation af VS Code#

Bemærk

Koden til VS Code er open source[1], men programmet som kan downloades fra https://code.visualstudio.com/ består af mere end blot open source koden til VS Code. Det indeholder også proprietære komponenter til telemetri/tracking.

Ønskes disse features ikke har du to muligheder:

  1. Slå dem fra i VS Code som beskrevet i afsnittet Telemetridata og online services (valgfrit).

  2. Installér VSCodium i stedet for VS Code: https://vscodium.com/#install

    VSCodium er en udgave af VS Code, baseret på samme open source kode, men med telemetri/tracking deaktiveret.

I de fleste moderne Linux-distributioner (Ubuntu, Debian, Fedora, CentOS m.f.) vil det nemmeste være at installere Visual Studio Code via snap-systemet.

  1. Besøg denne side https://snapcraft.io/code.

  2. Scroll til bunden af siden, vælg din distribution fra listen og følg instruktionerne i den guide du videresendes til.

    Ubuntu

    Hvis du bruger Ubuntu 16, 18, 20 eller 22 kan Visual Studio Code

    installeres fra kommandolinjen med en enkelt konmando:

    sudo snap install code --classic
    

2.4. Opsætning af VS Code#

Opsætningen af VS Code er den samme på alle tre platforme (Windows, macOS, Linux).

2.4.1. Første start#

Første gang VS Code startes ser du følgende skærmbillede:

../_images/vscode-config-first-start0.png
  1. Du kan skifte farvetema, f.eks. til et lyst farvetema (light mode).

  2. Tryk på < Get Started for at komme tilbage til startskærmen som vil møde dig næste gang du åbner VS Code.

VS Code ser nu ud som nedenfor.

../_images/vscode-config-first-start1.png

2.4.2. Telemetridata og online services (valgfrit)#

Hvis du ikke ønsker at VS Code sender data om din brug af VS Code tilbage til Microsoft kan du slå telemetry fra:

  1. Vælg menupunkt File ‣ Preferences ‣ Telemetry

    (macOS: Code ‣ Preferences ‣ Telemetry)

  2. Vælg Off fra drop-down-listen:

    ../_images/vscode-config-telemetry.png

Hvis du ikke ønsker VS Code skal benytte forskellige Microsoft online services, f.eks. Bing til at søge blandt indstillinger [5], så kan du slå dem fra:

  1. Vælg menupunkt File ‣ Preferences ‣ Online Services Settings

    (macOS: Code ‣ Preferences ‣ Online Services Settings)

  2. Vælg Off fra drop-down-listen:

2.4.3. Udvidelser/extensions#

  1. Åbn Extensions-panelet.

  2. Søg efter ms-python.python.

  3. Klik Install.

../_images/vscode-extensions-python.png

Installér på samme måde følgende udvidelser:

  • donjayamanne.githistory

  • mhutchie.git-graph

2.5. Opsætning af Git#

Git konfigureres med dit navn og din email-adrese, som du ønsker de skal fremgå af Gits log over hændelser i dine repositories.

  1. Vælg menupunkt Terminal ‣ New Terminal

    ../_images/vscode-terminal-gitconfig.png

    Fig. 2.1 a > kaldes en prompt og b er navnet på det program som modtager kommandoerne fra terminalen. Promptens udseende og programmets navn varierer fra system til system.#

  2. Indtast kommandoen git config --global user.name "Your Name", erstat Your Name med dit ønskede navn (husk citationstegn hvis dit navn indeholder mellemrum), og tryk Enter.

    Udfør på samme måde måde kommandoen git config --global user.email "your@email.com".

  3. Tjek om konfigurationen lykkedes ved at køre kommandoen git config user.name og git config user.email.

    De to kommandoer skulle gerne outputte det navn og den email-adresse du netop har indtastet.

2.6. Installation af pygame#

Introduktionen til versionsstyring med Git, GitHub og VS Code er bygget omkring et simpelt arkadespil, som benytter sig af Python-modulet pygame.

  1. Genbrug en allerede åbn terminal i VS Code eller åbn en Terminal ‣ New Terminal

  2. Kør kommandoen pip3 install pygame.

    ../_images/vscode-terminal-pippygame.png

    Bemærk

    Hvis kommandoen pip3 install pygame giver en fejl a la Command not found og du benytter Windows så har du måske glemt at sætte fluebenet [x] Add python.exe to path fra afsnit Installation af Python.

    Ret fejlen ved at geninstallere Python (og sætte fluebenet).

2.7. GitHub-konto#

  1. Udfyld oprettelsesformularen på signup

    Bemærk

    Det brugernavn du vælger under oprettelsen kommer til at være synligt for andre.

    URL’s til repositories har formatet https://github.com/<username>/<repository name> f.eks. user1234/cool-tool-x.

    Repositories omtales også som <username>/<repository name>, f.eks. user1234/cool-tool-x.

  2. Ved første har du mulighed for at personalisere din GitHub-konto.

    Jeg vil anbefale at vælge Skip personalization.

    ../_images/github-signup-skip.png
  3. Din GitHub-konto er nu klar til brug

    ../_images/github-signup-first-login.png

Se også

Git er uafhængigt af GitHub og man behøver således ikke en konto hos GitHub for at bruge Git til versionsstyring.

Skulle man imidlertid ønske sig et webbaseret sted at dele git-repositories, f.eks. for at have backup af sine repositories eller for at samarbejde, kan man selv hoste et github-lignende system kaldet GitLab:

https://about.gitlab.com/install/?version=ce

Fodnoter

2.8. Litteratur#