Nastavení vývojového prostředí¶
Příspěvky do BeeWare vyžadují nastavení vývojového prostředí.
Předpoklady¶
Budete muset nainstalovat následující předpoklady.
BeeWare vyžaduje Python 3.10+. Budete také
potřebovat metodu pro správu virtuálních prostředí (například venv).
Verzi nainstalovaného Pythonu můžete ověřit spuštěním:
$ python3 --version
Pokud máte nainstalováno více než jednu verzi Pythonu, možná budete muset
nahradit python3 konkrétním číslem verze (např. python3.13)
Doporučujeme se vyhnout nedávno vydané verzi Pythonu (tj. verzím, které mají mikroverzi „.0“ nebo „.1“, jako např. 3.14.0). Důvodem je to, že nástroje potřebné pro podporu Pythonu na macOS často zaostávají a obvykle nejsou k dispozici pro nedávno vydané stabilní verze Pythonu.
BeeWare vyžaduje Python 3.10+. Budete také
potřebovat metodu pro správu virtuálních prostředí (například venv).
Verzi nainstalovaného Pythonu můžete ověřit spuštěním:
$ python3 --version
Pokud máte nainstalováno více než jednu verzi Pythonu, možná budete muset
nahradit python3 konkrétním číslem verze (např. python3.13)
Doporučujeme se vyhnout nedávno vydané verzi Pythonu (tj. verzím, které mají mikroverzi „.0“ nebo „.1“, jako např. 3.14.0). Důvodem je to, že nástroje potřebné pro podporu Pythonu v systému Linux často zaostávají a obvykle nejsou k dispozici pro nedávno vydané stabilní verze Pythonu.
BeeWare vyžaduje Python 3.10+. Budete také
potřebovat metodu pro správu virtuálních prostředí (například venv).
Verzi nainstalovaného Pythonu můžete ověřit spuštěním:
C:\...>py -3 --version
Pokud máte nainstalováno více než jednu verzi Pythonu, možná budete muset
nahradit -3 konkrétním číslem verze (např. -python3.13)
Doporučujeme se vyhnout nedávno vydané verzi Pythonu (tj. verzím, které mají mikroverzi „.0“ nebo „.1“, jako např. 3.14.0). Důvodem je to, že nástroje potřebné pro podporu Pythonu ve Windows často zaostávají a obvykle nejsou k dispozici pro nedávno vydané stabilní verze Pythonu.
Nastavte si vývojové prostředí¶
Doporučeným způsobem nastavení vývojového prostředí pro BeeWare je použití virtuálního prostředí, a následná instalace vývojové verze BeeWare a jejích závislostí.
Klonujte repozitář BeeWare¶
Dále přejděte na stránku BeeWare na GitHubu, a pokud jste tak ještě neučinili, forkněte repozitář do svého vlastního účtu. Poté klikněte na tlačítko „<> Code“ ve vašem forku. Pokud máte v počítači nainstalovanou desktopovou aplikaci GitHub, můžete vybrat možnost „Open with GitHub Desktop“ (Otevřít v GitHub Desktop); v opačném případě zkopírujte uvedenou adresu HTTPS URL a použijte ji ke klonování repozitáře do svého počítače pomocí příkazového řádku:
Rozdělte repozitář BeeWare a poté:
$ git clone https://github.com/<your username>/beeware.git
(nahraďte svým uživatelským jménem na GitHubu)
Rozdělte repozitář BeeWare a poté:
$ git clone https://github.com/<your username>/beeware.git
(nahraďte svým uživatelským jménem na GitHubu)
Rozdělte repozitář BeeWare a poté:
C:\...>git clone https://github.com/<your username>/beeware.git
(nahraďte svým uživatelským jménem na GitHubu)
Nastavit upstream repozitář¶
Po naklonování vaší větve přidejte repozitář BeeWare jako vzdálený repozitář
upstream. Tím získá váš lokální klon odkaz na původní repozitář, což usnadní
synchronizaci aktualizací v průběhu času.
Budete také potřebovat tagy z upstream, aby nástroje jako Toga a Briefcase
mohly určit přesná čísla verzí:
$ git remote add upstream https://github.com/beeware/beeware.git
$ git fetch --tags upstream
$ git remote add upstream https://github.com/beeware/beeware.git
$ git fetch --tags upstream
C:\...>git remote add upstream https://github.com/beeware/beeware.git
C:\...>git fetch --tags upstream
Pokud chcete, aby vaše vidlice také obsahovala tyto tagy, můžete je odeslat:
$ git push --tags
To může být užitečné, pokud později vytvoříte nový klon a chcete, aby byly tagy dostupné z vašeho forku.
Vytvořte virtuální prostředí¶
Chcete-li nastavit virtuální prostředí a upgradovat pip, spusťte:
$ 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
Vaše výzva by nyní měla mít před sebou předponu (.venv).
Nainstalovat BeeWare¶
Nyní, když máte zdrojový kód, můžete provést editovatelnou instalaci BeeWare do svého vývojového prostředí. Spusťte následující příkaz:
(.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
Povolit předběžné potvrzení¶
BeeWare používá nástroj nazvaný pre-commit, který identifikuje jednoduché problémy a standardizuje formátování kódu. Toho dosahuje instalací git hooku, který automaticky spustí sérii linterů kódu před finalizací jakéhokoli git commitu. Chcete-li povolit pre-commit, spusťte:
(.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
Nyní jste připraveni začít hackovat BeeWare!