BeeWare 峰器 中文文档 - 教程 0 - 让我们开始

教程 0 - 让我们开始吧！
在我们构建我们的第一个 BeeWare 应用程序之前，我们必须确保我们已经具备运行 BeeWare 的所有先决条件。

安装 Python
我们首先需要的是一个运行 Python 3.7 或更新版本的 Python 解释器。

苹果系统
如果您使用的是 macOS，则可以从Python 网站获取官方安装程序。从 3.7 开始，您可以使用任何稳定版本的 Python。我们建议避免 alpha、beta 和候选发布，除非您真的知道自己在做什么。

Linux

如果您在 Linux 上，您将使用系统包管理器安装 Python（apt在 Debian/Ubuntu/Mint 上；dnf在 Fedora 上或pacmanArch 上）。

您应该确保系统 Python 是 Python 3.7 或更新版本；如果不是（例如，Ubuntu 18.04 附带 Python 3.6），您可能需要使用 Python 的替代源（例如，Ubuntu 上的deadsnakes PPA）。

我们目前不支持 Raspberry Pi。

Windows 视窗

如果您使用的是 Windows，则可以从Python 网站获取官方安装程序。从 3.7 开始，您可以使用任何稳定版本的 Python。我们建议避免使用 alpha、beta 和候选版本，除非你真的知道自己在做什么。

替代 Python 发行版

安装 Python 有很多不同的方法。您可以通过homebrew安装 Python 。您可以使用pyenv 在同一台机器上管理多个 Python 安装。Windows 用户可以从 Windows App Store 安装 Python。具有数据科学背景的用户可能想要使用Anaconda或Miniconda。

你如何安装 Python并不重要——重要的是你可以从操作系统的命令提示符/终端应用程序运行python3，并获得一个工作的 Python 解释器。

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

苹果系统

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

Git，一个版本控制系统。您可以从git-scm.org下载 Git 。

Xcode，Apple 的 IDE 工具。 Xcode 可从macOS App Store免费获得。

Linux

为了支持本地开发，您需要安装一些系统包。所需的软件包列表因您的发行版而异：

Ubuntu 16.04 / Debian 9

$ sudo apt-get update
$ sudo apt-get install git python3-dev python3-venv python3-gi python3-gi-cairo libgirepository1.0-dev libcairo2-dev libpango1.0-dev libwebkitgtk-3.0-0 gir1.2-webkit2-3.0
Ubuntu 18.04、20.04 / Debian 10、11

$ sudo apt-get update
$ sudo apt-get install git python3-dev python3-venv python3-gi python3-gi-cairo libgirepository1.0-dev libcairo2-dev libpango1.0-dev libwebkit2gtk-4.0-37 gir1.2-webkit2-4.0

软呢帽

$ sudo dnf install git pkg-config python3-devel gobject-introspection-devel cairo-devel cairo-gobject-devel pango-devel webkitgtk4

拱门，曼扎罗

$ sudo pacman -Syu git pkgconf cairo python-cairo pango gobject-introspection gobject-introspection-runtime python-gobject webkit2gtk

Briefcase 还使用一个名为 AppImage 的工具来构建可跨 Linux 发行版使用的二进制文件。但是，为 Linux 构建 AppImage 二进制文件很复杂，因为每个发行版上存在不一致的库版本。Briefcase 使用 Docker 为托管 AppImage 构建提供了一个控制良好的二进制环境。

Docker Engine的官方安装程序可用于一系列 Unix 发行版。按照适用于您平台的说明进行操作。安装 Docker 后，您应该能够启动 Ubuntu 18.04 容器：

$ docker run -it ubuntu:18.04

这应该会在 Docker 容器中显示一个 Unix 提示符（类似于root@84444e31cff9:/# ）。键入 Ctrl-D 退出 Docker 并返回到本地 shell。

Windows视窗

在 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

Linux

$ 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.bat

如果这有效，您的提示现在应该更改 - 它应该有一个 (beeware-venv)前缀。这让您知道您当前处于 BeeWare 虚拟环境中。每当您学习本教程时，都应确保您的虚拟环境已激活。如果不是，请重新运行最后一个命令（activate命令）以重新激活您的环境。

替代虚拟环境

如果您使用 Anaconda 或 miniconda，您可能更熟悉使用 conda 环境。您可能还听说过virtualenvPython 内置venv模块的前身。与 Python 安装一样——你如何创建你的虚拟环境并不重要，只要你有一个。

即便如此 - 严格来说，使用虚拟环境是可选的。您 可以将 BeeWare 的工具直接安装到您的主要 Python 环境中。但是，真的，真的，真的建议您使用虚拟环境。

下一步
我们现在已经建立了我们的环境。我们已经准备好创建我们的第一个 BeeWare 应用程序。