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)
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!