Opsætning af et udviklingsmiljø¶
For at bidrage til BeeWare skal du oprette et udviklingsmiljø.
Forudsætninger¶
Du skal installere følgende forudsætninger.
BeeWare kræver Python 3.10+. Du skal også bruge en
metode til at administrere virtuelle miljøer (f.eks. venv).
Du kan kontrollere den version af Python, du har installeret, ved at køre:
$ python3 --version
Hvis du har mere end én version af Python installeret, skal du muligvis erstatte
python3 med et specifikt versionsnummer (f.eks. python3.13)
Vi anbefaler at undgå den seneste version af Python (dvs. versioner med et ".0" eller ".1" mikroversionsnummer, som f.eks. 3.14.0). Dette skyldes, at de værktøjer, der er nødvendige for at understøtte Python på macOS, ofte ikke er tilgængelige for de seneste stabile Python-versioner.
BeeWare kræver Python 3.10+. Du skal også bruge en
metode til at administrere virtuelle miljøer (f.eks. venv).
Du kan kontrollere den version af Python, du har installeret, ved at køre:
$ python3 --version
Hvis du har mere end én version af Python installeret, skal du muligvis erstatte
python3 med et specifikt versionsnummer (f.eks. python3.13)
Vi anbefaler at undgå den seneste version af Python (dvs. versioner med et ".0" eller ".1" mikroversionsnummer, som f.eks. 3.14.0). Dette skyldes, at de værktøjer, der er nødvendige for at understøtte Python på Linux, ofte er forsinkede og normalt ikke er tilgængelige for de seneste stabile Python-versioner.
BeeWare kræver Python 3.10+. Du skal også bruge en
metode til at administrere virtuelle miljøer (f.eks. venv).
Du kan kontrollere den version af Python, du har installeret, ved at køre:
C:\...>py -3 --version
Hvis du har mere end én version af Python installeret, skal du muligvis erstatte
-3 med et specifikt versionsnummer (f.eks. -python3.13)
Vi anbefaler at undgå nyligt udgivne versioner af Python (dvs. versioner med et ".0" eller ".1" mikroversionsnummer, som f.eks. 3.14.0). Dette skyldes, at de værktøjer, der er nødvendige for at understøtte Python på Windows, ofte er forsinkede og normalt ikke er tilgængelige for nyligt udgivne stabile Python-versioner.
Opsæt dit udviklingsmiljø¶
Den anbefalede måde at opsætte dit udviklingsmiljø til BeeWare er at bruge et virtuelt miljø, og derefter installere udviklingsversionen af BeeWare og dens afhængigheder.
Klon BeeWare repositoryet¶
Gå derefter til BeeWare siden på GitHub, og hvis du ikke allerede har gjort det, skal du forke repositoryet til din egen konto. Klik derefter på knappen "<> Code" på din fork. Hvis du har GitHub-desktopapplikationen installeret på din computer, kan du vælge "Open with GitHub Desktop" (Åbn med GitHub Desktop). Ellers skal du kopiere den angivne HTTPS-URL og bruge den til at klone repositoryet til din computer ved hjælp af kommandolinjen:
Fork BeeWare repositoryet, og derefter:
$ git clone https://github.com/<your username>/beeware.git
(erstatt dit GitHub-brugernavn)
Fork BeeWare repositoryet, og derefter:
$ git clone https://github.com/<your username>/beeware.git
(erstatt dit GitHub-brugernavn)
Fork BeeWare repositoryet, og derefter:
C:\...>git clone https://github.com/<your username>/beeware.git
(erstatt dit GitHub-brugernavn)
Opret et virtuelt miljø¶
For at oprette et virtuelt miljø og opgradere pip, skal du køre:
$ cd beeware
$ python3 -m venv .venv
$ source .venv/bin/activate
(.venv) $ python -m pip install -U pip
$ cd beeware
$ python3 -m venv .venv
$ source .venv/bin/activate
(.venv) $ python -m pip install -U pip
C:\...>cd beeware
C:\...>py -3 -m venv .venv
C:\...>.venv\Scripts\activate
(.venv) $ python -m pip install -U pip
Din prompt bør nu have et (.venv) præfiks foran sig.
Installer BeeWare¶
Nu hvor du har kildekoden, kan du foretage en redigerbar installation af BeeWare i dit udviklingsmiljø. Kør følgende kommando:
(.venv) $ python -m pip install -U -e . --group dev
(.venv) $ python -m pip install -U -e . --group dev
(.venv) C:\...>python -m pip install -U -e . --group dev
Aktivér pre-commit¶
BeeWare bruger et værktøj kaldet pre-commit til at identificere enkle problemer og standardisere kodeformatering. Det gør det ved at installere en git-hook, der automatisk kører en række kode-linters, inden en git-commit færdiggøres. For at aktivere pre-commit skal du køre:
(.venv) $ pre-commit install
pre-commit installed at .git/hooks/pre-commit
(.venv) $ pre-commit install
pre-commit installed at .git/hooks/pre-commit
(.venv) C:\...>pre-commit install
pre-commit installed at .git/hooks/pre-commit
Nu er du klar til at begynde at hacke på BeeWare!