教程 0 - 准备就绪!¶
在构建第一个 BeeWare 应用程序之前,我们必须确保已具备运行 BeeWare 的所有先决条件。
安装 Python¶
首先,我们需要一个正常工作的 Python 解释器。
如果您使用的是 macOS,Xcode 或命令行开发工具中会包含最新版本的 Python。要检查是否已安装,请运行以下命令:
$ python3 --version
如果已安装 Python,则会看到其版本号。否则,系统会提示您安装命令行开发工具。
如果您使用的是 Windows 系统,可以从 Python 网站 <https://www.python.org/downloads>`_ 获取官方安装程序。您可以使用 Python 3.8 及以后的任何稳定版本。我们建议您不要使用 alphas、beta 和候选发布版,除非您**了解自己在做什么。
如果您使用的是 Linux,您将使用系统软件包管理器(Debian/Ubuntu/Mint 上的 apt
,Fedora 上的 dnf
,或 Arch 上的 pacman
)安装 Python。
您应该确保系统 Python 是 Python 3.8 或更新版本;如果不是(例如,Ubuntu 18.04 附带 Python 3.6),您需要将 Linux 发行版升级到更新版本。
目前对 Raspberry Pi 的支持有限。
如果您使用的是 Windows 系统,可以从 Python 网站 <https://www.python.org/downloads>`_ 获取官方安装程序。您可以使用 Python 3.8 及以后的任何稳定版本。我们建议您不要使用 alphas、beta 和候选发布版,除非您**了解自己在做什么。
其他 Python 发行版
安装 Python 有很多不同的方法。可以通过 homebrew 安装 Python。您可以使用 pyenv 来管理同一台机器上的多个 Python 安装。Windows 用户可以从 Windows 应用商店安装 Python。数据科学背景的用户可能想使用 Anaconda 或 Miniconda。
如果您使用的是 macOS 或 Windows 操作系统,如何安装 Python 并不重要,重要的是您能从操作系统的命令提示符/终端应用程序中运行 python3
,并获得一个正常工作的 Python 解释器。
如果您使用的是 Linux,则应使用操作系统提供的系统 Python。您可以使用非系统 Python 完成本教程的*大部分内容,但无法将应用程序打包发布给他人。
安装依赖项¶
接下来,安装操作系统所需的其他依赖项:
在 macOS 上构建 BeeWare 应用程序需要:
版本控制系统 *Git*。它包含在您安装的 Xcode 或命令行开发工具中。
为支持本地开发,您需要安装一些系统软件包。所需的软件包列表因发行版而异:
Ubuntu 20.04+ / Debian 10+
$ sudo apt update
$ sudo apt install git build-essential pkg-config python3-dev python3-venv libgirepository1.0-dev libcairo2-dev gir1.2-gtk-3.0 libcanberra-gtk3-module
费多拉
$ sudo dnf install git gcc make pkg-config rpm-build python3-devel gobject-introspection-devel cairo-gobject-devel gtk3 libcanberra-gtk3
Arch、Manjaro
$ sudo pacman -Syu git base-devel pkgconf python3 gobject-introspection cairo gtk3 libcanberra
OpenSUSE Tumbleweed
$ sudo zypper install git patterns-devel-base-devel_basis pkgconf-pkg-config python3-devel gobject-introspection-devel cairo-devel gtk3 'typelib(Gtk)=3.0' libcanberra-gtk3-module
在 Windows 上构建 BeeWare 应用程序需要:
Git,一个版本控制系统。你可以从 git-scm.org 下载 Git。
安装这些工具后,应确保重新启动任何终端会话。Windows 只在安装完成后才会显示新安装的工具终端。
建立虚拟环境¶
我们现在要创建一个虚拟环境–一个 “沙箱”,用来将本教程的工作与我们的主 Python 安装隔离开来。如果我们将软件包安装到虚拟环境中,我们的主 Python 安装(以及计算机上的任何其他 Python 项目)将不会受到影响。如果我们把虚拟环境弄得一团糟,我们可以简单地删除它,然后重新开始,不会影响计算机上的任何其他 Python 项目,也不需要重新安装 Python。
$ mkdir beeware-tutorial
$ cd beeware-tutorial
$ python3 -m venv beeware-venv
$ source beeware-venv/bin/activate
$ mkdir beeware-tutorial
$ cd beeware-tutorial
$ python3 -m venv beeware-venv
$ source beeware-venv/bin/activate
C:\...>md beeware-tutorial
C:\...>cd beeware-tutorial
C:\...>py -m venv beeware-venv
C:\...>beeware-venv\Scripts\activate
运行 PowerShell 脚本时出现的错误
如果使用 PowerShell 时收到错误信息::
File C:\...\beeware-tutorial\beeware-venv\Scripts\activate.ps1 cannot be loaded because running scripts is disabled on this system.
您的 Windows 账户没有运行脚本的权限。要解决这个问题:
以管理员身份运行 Windows PowerShell。
运行
set-executionpolicy RemoteSigned
选择
Y
更改执行策略。
完成后,您就可以在原始 PowerShell 会话(或同一目录下的新会话)中重新运行 beeware-venv\scripts\activate.ps1
。
如果这样做成功了,您的提示符现在应该有所改变–它应该带有 (beeware-venv)
前缀。这样,您就可以知道当前正处于 BeeWare 虚拟环境中。无论何时运行本教程,都应确保虚拟环境已激活。如果没有激活,请重新执行最后一条命令(activate
命令)以重新激活虚拟环境。
替代虚拟环境
如果您使用的是 Anaconda 或 miniconda,那么您可能对使用 conda 环境更为熟悉。您可能还听说过 virtualenv
,它是 Python 内置的 venv
模块的前身。就像 Python 的安装一样,如果你使用的是 macOS 或 Windows,那么如何创建虚拟环境并不重要,只要有一个就够了。如果在 Linux 上,则应坚持使用 venv
和系统 Python。
下一步¶
现在我们已经设置好了环境。我们准备 创建第一个 BeeWare 应用程序。