为了做出贡献,你需要建立一个 开发环境 - 一个你可以在其中编写代码的地方。 的地方。
BeeWare 的许多部分都使用相同的工具:特定版本的 Python、 和虚拟环境控件。
Python
Python 是一种脚本语言,可用于多种 不同的操作系统上使用。不过,根据您使用的系统 不同,Python 的版本也会不同。因此 因此,我们要明确说明代码将在哪个版本的 Python 上运行。 工作。
在下面的说明中,我们假设您知道
您需要安装的 Python 版本。通常
文件或教程信息中列出。我们的
CI 系统必须被告知
需要的 Python 版本。所以如果您真的
卡住了,请尝试查看 .github/workflows/ci.yml
文件,查找您需要的特定版本。
文件中查找您需要的特定版本。
要为 BeeWare 做出贡献,您需要在机器上安装 Python 解释器。在 macOS 和 Windows 上,我们 建议使用 Python.org 官方 安装程序;在 Linux 上,我们建议使用 版本的 Python。 版本。
虚拟环境
安装 Python 时,它会提供一个单一的全局环境。默认情况下 默认情况下,如果安装软件包,它将被安装到这个全局 环境中。
但是,如果您正在开发一个以上的 Python 项目,那么 这些项目很可能会有不同的 - 有时甚至是冲突的 - 要求。 在某些情况下,还会有冲突。您需要一种方法来 隔离每个项目,这样为一个项目安装软件包就不会 强制为第二个项目安装相同的软件包。
这是通过虚拟环境来实现的。虚拟环境,或 venv",是一个隔离的环境,可以很容易地创建、销毁 或重新创建。安装在虚拟环境中的任何软件包都只能 内访问。虚拟环境 虚拟环境有时被称为 "沙盒"--一个安全的游戏场所,在这里 在这里,如果你犯了错误,你可以推倒你建立的一切,然后重新开始。 重新开始。
Python 提供了用于创建新虚拟环境的 venv
模块。
每个虚拟环境都有一个名称,用来标识该
环境。要创建一个名为 "my-venv "的新虚拟环境,请运行
$ python -m venv my-venv
用于创建虚拟环境的 Python 版本
将是虚拟环境*内默认使用的版本。
内默认使用的版本。如果您安装了多个 Python 版本,或者正在使用
pyenv "之类的工具来管理 Python 版本,请确保
当前激活的 Python 版本(或在调用
调用 -m venv
命令时引用的版本)是您想要的版本。一旦创建了
虚拟环境创建后,就不能更改其使用的 Python
版本。要更改 Python 版本,需要
创建一个新的虚拟环境。
调用 -m venv
将创建虚拟环境,但该环境尚未激活。
环境尚未激活。虚拟环境是
虚拟环境是磁盘上的一组文件,存储在与环境名称相匹配的目录中。
的目录中。要激活虚拟环境,需要运行作为环境一部分生成的
文件:
$ source my-venv/bin/activate
这将在命令行提示符中添加一个前缀 让你知道自己处于虚拟环境中:
(my-venv) $
当虚拟环境处于活动状态时,任何 pip install
命令将
*只会影响虚拟环境。改变
如果提示符有前缀,则该虚拟环境处于活动状态。
处于活动状态。
如果打开第二个终端窗口,环境将不处于活动状态。 激活--您需要在每次要使用环境的终端会话中重新激活环境。 会话中重新激活环境。如果出现以下错误 您确定已安装的库不可用 - 检查虚拟环境是否处于活动状态。 检查虚拟环境是否处于活动状态。
要停用虚拟环境,请运行
(my-venv) $ 停用
一旦停用,该前缀将从提示符中删除。