Настройка среды разработки¶
Для участия в BeeWare необходимо настроить среду разработки.
Предпосылки¶
Вам необходимо установить следующие предварительные компоненты.
BeeWare требует Python 3.10+. Вам также
понадобится метод для управления виртуальными средами (например, venv).
Вы можете проверить версию Python, которую вы установили, запустив:
$ python3 --version
Если у вас установлено более одной версии Python, вам может потребоваться
заменить python3 конкретным номером версии (например, python3.13)
Мы рекомендуем избегать недавно выпущенных версий Python (т. е. версий с микроверсией «.0» или «.1», например 3.14.0). Это связано с тем, что инструменты, необходимые для поддержки Python в macOS, часто отстают и обычно недоступны для недавно выпущенных стабильных версий Python.
BeeWare требует Python 3.10+. Вам также
понадобится метод для управления виртуальными средами (например, venv).
Вы можете проверить версию Python, которую вы установили, запустив:
$ python3 --version
Если у вас установлено более одной версии Python, вам может потребоваться
заменить python3 конкретным номером версии (например, python3.13)
Мы рекомендуем избегать недавно выпущенных версий Python (т. е. версий с микроверсией «.0» или «.1», например 3.14.0). Это связано с тем, что инструменты, необходимые для поддержки Python в Linux, часто отстают и обычно недоступны для недавно выпущенных стабильных версий Python.
BeeWare требует Python 3.10+. Вам также
понадобится метод для управления виртуальными средами (например, venv).
Вы можете проверить версию Python, которую вы установили, запустив:
C:\...>py -3 --version
Если у вас установлено несколько версий Python, возможно, вам потребуется
заменить -3 конкретным номером версии (например, -python3.13)
Мы рекомендуем избегать недавно выпущенных версий Python (т. е. версий с микроверсией «.0» или «.1», например 3.14.0). Это связано с тем, что инструменты, необходимые для поддержки Python в Windows, часто отстают и обычно недоступны для недавно выпущенных стабильных версий Python.
Настройте свою среду разработки¶
Рекомендуемый способ настройки среды разработки для BeeWare — использовать виртуальную среду, а затем установить версию BeeWare для разработчиков и ее зависимости.
Склонируйте репозиторий BeeWare¶
Затем перейдите на страницу BeeWare на GitHub, и, если вы еще этого не сделали, создайте форк репозитория в своей учетной записи. Затем нажмите кнопку «<> Code» на вашем форке. Если на вашем компьютере установлено приложение GitHub Desktop, вы можете выбрать «Open with GitHub Desktop»; в противном случае скопируйте предоставленный URL-адрес HTTPS и используйте его для клонирования репозитория на свой компьютер с помощью командной строки:
Сделайте форк репозитория BeeWare, а затем:
$ git clone https://github.com/<your username>/beeware.git
(замените на свое имя пользователя GitHub)
Сделайте форк репозитория BeeWare, а затем:
$ git clone https://github.com/<your username>/beeware.git
(замените на свое имя пользователя GitHub)
Сделайте форк репозитория BeeWare, а затем:
C:\...>git clone https://github.com/<your username>/beeware.git
(замените на свое имя пользователя GitHub)
Создать виртуальную среду¶
Чтобы настроить виртуальную среду и обновить pip, выполните:
$ 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
Теперь перед вашим запросом должен стоять префикс (.venv).
Установить BeeWare¶
Теперь, когда у вас есть исходный код, вы можете выполнить редактируемую установку BeeWare в вашей среде разработки. Выполните следующую команду:
(.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
Включить предварительную фиксацию¶
BeeWare использует инструмент под названием pre-commit, чтобы выявлять простые проблемы и стандартизировать форматирование кода. Для этого он устанавливает git-хук, который автоматически запускает серию линтеров кода перед финализацией любого git-коммита. Чтобы включить pre-commit, выполните:
(.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
Теперь вы готовы приступить к взлому BeeWare!