教程 0 - 准备就绪!

在构建第一个 BeeWare 应用程序之前,我们必须确保已具备运行 BeeWare 的所有先决条件。

安装 Python

首先,我们需要一个正常工作的 Python 解释器。

如果您使用的是 macOS,Xcode 或命令行开发工具中会包含最新版本的 Python。要检查是否已安装,请运行以下命令:

$ python3 --version

如果已安装 Python,则会看到其版本号。否则,系统会提示您安装命令行开发工具。

如果您使用的是 Windows 系统,可以从 Python 网站 <https://www.python.org/downloads>`_ 获取官方安装程序。您可以使用 Python 3.8 及以后的任何稳定版本。我们建议您不要使用 alphas、beta 和候选发布版,除非您**了解自己在做什么。

其他 Python 发行版

安装 Python 有很多不同的方法。可以通过 homebrew 安装 Python。您可以使用 pyenv 来管理同一台机器上的多个 Python 安装。Windows 用户可以从 Windows 应用商店安装 Python。数据科学背景的用户可能想使用 AnacondaMiniconda

如果您使用的是 macOS 或 Windows 操作系统,如何安装 Python 并不重要,重要的是您能从操作系统的命令提示符/终端应用程序中运行 python3,并获得一个正常工作的 Python 解释器。

如果您使用的是 Linux,则应使用操作系统提供的系统 Python。您可以使用非系统 Python 完成本教程的*大部分内容,但无法将应用程序打包发布给他人。

安装依赖项

接下来,安装操作系统所需的其他依赖项:

在 macOS 上构建 BeeWare 应用程序需要:

  • 版本控制系统 *Git*。它包含在您安装的 Xcode 或命令行开发工具中。

建立虚拟环境

我们现在要创建一个虚拟环境–一个 “沙箱”,用来将本教程的工作与我们的主 Python 安装隔离开来。如果我们将软件包安装到虚拟环境中,我们的主 Python 安装(以及计算机上的任何其他 Python 项目)将不会受到影响。如果我们把虚拟环境弄得一团糟,我们可以简单地删除它,然后重新开始,不会影响计算机上的任何其他 Python 项目,也不需要重新安装 Python。

$ mkdir beeware-tutorial
$ cd beeware-tutorial
$ python3 -m venv beeware-venv
$ source beeware-venv/bin/activate

如果这样做成功了,您的提示符现在应该有所改变–它应该带有 (beeware-venv) 前缀。这样,您就可以知道当前正处于 BeeWare 虚拟环境中。无论何时运行本教程,都应确保虚拟环境已激活。如果没有激活,请重新执行最后一条命令(activate 命令)以重新激活虚拟环境。

替代虚拟环境

如果您使用的是 Anaconda 或 miniconda,那么您可能对使用 conda 环境更为熟悉。您可能还听说过 virtualenv,它是 Python 内置的 venv 模块的前身。就像 Python 的安装一样,如果你使用的是 macOS 或 Windows,那么如何创建虚拟环境并不重要,只要有一个就够了。如果在 Linux 上,则应坚持使用 venv 和系统 Python。

下一步

现在我们已经设置好了环境。我们准备 创建第一个 BeeWare 应用程序