教學 0 - 讓我們開始設定吧!¶
在建立第一個 BeeWare 應用程式之前,我們必須確保具備運行 BeeWare 的所有先決條件。
安裝Python¶
我們首先需要的是一個可用的 Python 直譯器。
如果您使用的是 macOS,則 Xcode 或命令列開發人員工具中包含最新版本的 Python。要檢查您是否已經擁有它,請執行以下命令:
$ python3 --version
如果安裝了 Python,您將看到其版本號。否則,系統將提示您安裝命令列開發人員工具。
如果您使用的是 Windows,則可以從 Python 網站 取得官方安裝程式。您可以使用 3.8 及以上的任何穩定版本的 Python。我們建議避免 alpha、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 網站 取得官方安裝程式。您可以使用 3.8 及以上的任何穩定版本的 Python。我們建議避免 alpha、beta 和候選版本,除非您 真的 知道自己在做什麼。
替代的 Python 發行版
安裝 Python 有很多不同的方法。您可以透過 homebrew 安裝 Python。您可以使用 pyenv 來管理同一台電腦上的多個 Python 安裝。 Windows 使用者可以從 Windows App Store 安裝 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
Fedora
$ 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 應用程式。