為了做出貢獻,您需要建立一個 開發環境 - 一個您可以在其中編寫程式碼的地方。 與其他人的環境一樣。
BeeWare 的許多部分使用相同的工具:特定版本的 Python、 和虛擬環境控制。
Python
Python 是一種腳本語言,適用於許多 不同的作業系統。但是,根據您使用的系統 您使用的 Python 版本會有所不同。由於這個 因此,我們要準確地指定我們希望代碼能在哪個版本的 Python 上運行。 工作。
在下面的說明中,我們假設您知道
您需要安裝的 Python 版本。通常
列在 README.md
檔案或教學資訊中。我們的
CI系統必須被告知
所需的 Python 版本。所以如果您真的
卡住了,請嘗試查看.github/workflows/ci.yml
檔案,找出您需要的特定版本。
特定版本。
為了對 BeeWare 做出貢獻,您需要在您的機器上安裝 Python 解釋器。在macOS和Windows上,我們 建議使用 官方 Python.org 安裝程式;在 Linux 上,我們建議使用 版本的 Python。 版本。
虛擬環境
安裝 Python 時,它會提供單一的全局環境。預設情況下 預設情況下,如果您安裝套件,它會被安裝到這個全局環境中。 環境中。
但是,如果您正在執行一個以上的 Python 專案,則 這些專案很有可能會有不同的 - 而且在某些情況下,是衝突的 - 需求。 在某些情況下,會有衝突的需求。您需要一種方法來 隔離每個專案,這樣為一個專案安裝套件就不會 強制為第二個專案安裝相同的套件。
這是使用虛擬環境來完成的。虛擬環境,或 虛擬環境是一個隔離的環境,可以輕鬆地建立、銷毀 或重新建立。任何安裝在虛擬環境中的套件只能 在該虛擬環境*內可以存取。虛擬環境 虛擬環境有時被稱為 「沙箱」 - 一個安全的遊戲場所。 如果您犯了一個錯誤,您可以推倒您所建立的一切,然後重新開始。 重新開始。
Python 提供了 venv
模組來建立新的虛擬環境。
每個虛擬環境都有一個可以用來識別
環境。要創建一個新的虛擬環境,命名為 "my-venv",請執行:
$ python -m venv my-venv
您用來建立虛擬環境的 Python 版本
將會是虛擬環境*內預設使用的版本。
版本。如果您已經安裝了多個 Python 版本,或者您正在使用像
工具 (如 pyenv
) 來管理 Python 版本,請確保
當前活動的 Python 版本 (或您在呼叫
版本)是您想要的版本。一旦
虛擬環境建立後,您就無法變更它所使用的 Python
版本。要更改 Python 版本,您需要
創建一個新的虛擬環境。
調用 -m venv
將會 創建 虛擬環境,但環境尚未 動態 。
環境尚未 動態 。虛擬環境是
磁碟上的檔案集合,儲存於與虛擬環境名稱相符的目錄中。
的目錄中。若要啟動虛擬環境,您必須執行其中一個
作為環境的一部分而產生的檔案:
$ source my-venv/bin/activate
這會在您的命令列提示中加入前綴 讓您知道您在虛擬環境中:
(my-venv) $
當虛擬環境處於活動狀態時,任何 pip install
指令將
*只會影響虛擬環境。如果您變更
目錄也沒關係 - 如果您的提示有一個前綴,則該虛擬環境是
活動。
如果您開啟第二個終端視窗,環境將不活動 - 您需要在每個終端重新啟動環境。 啟動 - 您需要在每次要使用環境的終端機會話中重新啟動環境。 會話中重新啟動環境。如果您收到關於 您確定已安裝的函式庫不可用的錯誤 - 請檢查您的虛擬環境是否啟動。 檢查您的虛擬環境是否已啟用。
若要停用虛擬環境,請執行:
(my-venv) $ 停用
一旦停用,該前綴將從提示中刪除。