原文:https://kivy.org/doc/stable/installation/installation-windows.html#install-win-dist
如果您使用Anaconda,則可以使用以下命令安裝kivy:
$ conda install kivy -c conda-forge
否則,請繼續下面的步驟以在本機Python安裝中安裝Kivy。
前提條件¶
Kivy用Python編寫, 因此,要使用Kivy,您需要現有的Python安裝。可以並行安裝多個版本的Python,但是需要在要使用Kivy的每個Python版本中安裝Kivy。
從1.9.1開始,我們 為Kivy及其所有依賴項提供了二進制 輪子,可與現有的Python安裝一起使用。請參閱安裝kivy穩定版。
我們還提供使用Kivy master生成的每晚車輪 。請參閱每晚安裝車輪。如果將kivy安裝到其他位置而不是站點軟件包,請參閱安裝Kivy並在適當位置進行編輯。
注意
對於Python <3.5,我們使用MinGW編譯器。但是,對於Windows上的Python 3.5+,我們目前僅支持MSVC編譯器,因為以下有關MinGW的Python 發行號4709。通常,在使用預編譯車輪時,這應該沒有區別。
從以前的版本更新Kivy ¶
從以前的Kivy版本進行更新時,必須首先更新所有Kivy依賴項。通常,只需在下面的pip install…命令中添加–upgrade就足以更新pip。
警告
從Kivy 1.10.1或更低版本升級到1.11.0或更高版本時,必須在升級之前手動卸載所有kivy依賴項,因為它們無法正確更新。這是通過以下方式完成的:
python -m pip uninstall -y kivy.deps.glew kivy.deps.gstreamer kivy.deps.sdl2 kivy.deps.angle
假設以前已經安裝了所有依賴項。有關更多詳細信息,請參見Kivy的依賴項。
卸載后,繼續下面的安裝。
安裝kivy穩定版¶
警告
Kivy 1.11.1是支持Python 2的最新版本。
現在已經安裝了python,打開命令行並通過鍵入來確保python可用。然后,執行以下操作 (可選)創建一個新的虛擬環境,並安裝最新的穩定kivy版本(1.11.1)及其依賴項。python --version
-
確保您擁有最新的pip,wheel和virtualenv:
python -m pip install --upgrade pip wheel setuptools virtualenv
(可選) 為您的Kivy項目創建一個新的虛擬環境。強烈推薦:
-
首先在當前目錄中創建名為kivy_venv的環境:
python -m virtualenv kivy_venv
-
激活虛擬環境。每次啟動新終端時,都必須從當前目錄執行此步驟 。在Windows CMD上執行以下操作:
kivy_venv\Scripts\activate
如果您在bash終端中,請執行以下操作:
source kivy_venv/Scripts/activate
您的終端現在應該在路徑的開頭加上(kivy_venv)之類的內容,表明kivy_venv環境處於活動狀態。如果沒有說明,則說明虛擬環境未處於活動狀態。
-
-
安裝依賴項(如果不需要,請跳過gstreamer(〜120MB),請參閱 Kivy的依賴項)。如果要升級Kivy,請參閱從先前版本更新Kivy:
python -m pip install docutils pygments pypiwin32 kivy_deps.sdl2==0.1.* kivy_deps.glew==0.1.* python -m pip install kivy_deps.gstreamer==0.1.*
注意
如果你遇到的MemoryError在安裝,添加后 PIP安裝了-no-緩存目錄選項。
對於Python 3.5+,您還可以使用斜角后端而不是傾斜。可以通過以下方式安裝:
python -m pip install kivy_deps.angle==0.1.*
警告
安裝時,將kivy的依賴項固定到kivy版本發布時在pypi上發布的特定版本,如上。否則,將來更新時可能會得到不兼容的依賴關系。
-
安裝kivy:
python -m pip install kivy==1.11.1
-
(可選)安裝kivy示例:
python -m pip install kivy_examples==1.11.1
這些示例安裝在安裝python的根目錄下的share目錄中。
而已。如果您安裝了kivy示例,現在應該可以在python中運行或運行一個基本示例:import kivy
python kivy_venv\share\kivy-examples\demo\showcase\main.py
如果您不使用virtualenv,請用安裝python的路徑替換kivy_venv。
什么是輪子,點子和輪子¶
在Python中,可以使用python軟件包管理器pip來安裝Kivy之類的軟件包。在使用帶有pip的Kivy源代碼進行安裝時,某些軟件包(例如Kivy)需要其他步驟,例如編譯。Wheels(帶有.whl
擴展名)是已編譯的軟件包的預構建發行版,不需要安裝其他步驟。
當托管的PyPI一個安裝使用滾輪pip
,例如。直接下載並安裝車輪時,使用例如:python -m pip install kivy
python -m pip install wheel_file_name
python -m pip install C:\Kivy-1.9.1.dev-cp27-none-win_amd64.whl
每晚安裝車輪¶
警告
使用最新的開發版本可能會冒險,並且在開發過程中可能會遇到問題。如果您遇到任何錯誤,請報告它們。
當前在Kivy 存儲庫的master分支上創建當前Kivy master的快照輪 。他們可以在這里找到 。要使用它們,而不是這樣做,我們將如下安裝這些輪子之一。python -m pip install kivy
- 執行上述“安裝”部分的步驟1和2。
- 下載適合您系統的輪子。
- 使用 文件名where進行安裝。
python -m pip install wheel-name
wheel-name
Kivy示例由於其大小而與核心分開。可以使用以下單個輪子將示例分別安裝在Python 2和3上:
Kivy的依賴¶
我們分別為Kivy及其依賴項提供輪子,因此僅需要安裝所需的依賴項。依賴項作為kivy_deps的可選子包提供,例如kivy_deps.sdl2
。
注意
在Kivy 1.11.0我們轉變了kivy從Windows的依賴 kivy.deps.xxx命名空間下存儲kivy / DEPS / XXX至 kivy_deps.xxx命名空間下存儲kivy_deps / XXX。Pip有時無法區分這兩種格式,因此在從較舊的Kivy升級時,請遵循從以前的版本更新Kivy中的說明。有關 更多詳細信息,請參見此處。
當前在Windows上,我們提供以下依賴項輪:
通過將KIVY_GL_BACKEND envrionment變量設置為glew (默認值),angle或sdl2,可以選擇將其中哪些用於OpenGL 。angle目前正處於實驗階段,只能替代Python 3.5+上的glew。
gstreamer是一個可選的依賴項,僅在需要視頻顯示或音頻時才需要安裝。ffpyplayer 是音頻或視頻的替代依賴項。
命令行¶
了解您的命令行。要執行pip
或wheel
命令中的任何一個,需要一個命令行工具,其路徑上帶有python。Windows上的默認命令行是 Command Prompt,打開它的最快方法是在鍵盤上按Win + R,cmd
在打開的窗口中鍵入,然后按Enter。
替代Linux的風格命令外殼,我們推薦的是 混帳的Windows它提供了一個bash命令行以及為 git的。注意,即使安裝了bash,CMD仍然可以使用。
走這條路!要將python添加到路徑,只需打開命令行,然后使用cd
命令將當前目錄更改為python的安裝目錄,例如。或者,如果您僅安裝了一個python版本,則將python目錄永久添加到cmd或 bash的路徑中 。cd C:\Python37
使用的開發Kivy ¶
警告
使用最新的開發版本可能會冒險,並且在開發過程中可能會遇到問題。如果您遇到任何錯誤,請報告它們。
要使用kivy 源代碼編譯和安裝kivy 或將kivy與git而不是wheel一起使用,還有一些其他步驟:
-
無論是
python
與Python\Scripts
目錄必須是在路徑上。每次重新編譯Kivy時,它們必須在路徑上。 -
確保您擁有最新的點子和輪子:
python -m pip install --upgrade pip wheel setuptools
-
獲取編譯器。對於Python <3.5,我們使用mingwpy如下。
-
創建
python\Lib\distutils\distutils.cfg
文件並添加兩行:[build] compiler = mingw32
-
使用以下方法安裝MinGW:
python -m pip install -i https://pypi.anaconda.org/carlkl/simple mingwpy
對於Python 3.5,我們使用MSVC編譯器。對於3.5,需要 Visual Studio 2015,該軟件是免費提供的。只需下載並安裝它,您就可以輕松進行了。
Visual Studio很大,因此您也可以使用較小的 Visual C Build Tools。
-
-
設置環境變量。在Windows上執行以下操作:
set USE_SDL2=1 set USE_GSTREAMER=1
在bash中執行:
export USE_SDL2=1 export USE_GSTREAMER=1
每次重新編譯kivy時都必須設置這些變量。
-
安裝其他依賴項及其開發版本(如果您不打算使用視頻/音頻,則可以跳過gstreamer和gstreamer_dev)。我們不像穩定的kivy那樣固定依賴項的版本,因為我們需要最新的:
python -m pip install Cython == 0.29.10 docutils pygments pypiwin32 kivy_deps.sdl2 kivy_deps.glew kivy_deps.gstreamer kivy_deps.glew_dev kivy_deps.sdl2_dev kivy_deps.gstreamer_dev
-
如果您將kivy下載或克隆到其他位置,並且不想將其安裝到站點程序包中,請閱讀下一節。
-
最后使用編譯並安裝kivy ,其中 可以是url(例如 kivy master)或kivy本地副本的完整路徑。
pip install filename
filename
https://github.com/kivy/kivy/archive/master.zip
編譯Kivy ¶
-
開始安裝從GitHub復制或下載並提取的Kivy。您應該位於提取kivy的根目錄中,其中包含 setup.py文件:
python -m pip install .
如果編譯成功而沒有任何錯誤,那么Kivy應該很好。您可以通過運行一個基本示例進行測試:
python share\kivy-examples\demo\showcase\main.py
安裝Kivy並在適當位置進行編輯¶
在開發中,通常會克隆Kivy或將其下載到某個位置,然后通過以下方式安裝:
python -m pip install -e kivy_path
現在,您可以使用以下命令之一在其當前位置安全地編譯kivy:
make
python setup.py build_ext --inplace
但是kivy將被完全安裝並可以從Python獲得。請記住,無論何時更改任何cython文件(例如,如果您是從GitHub提取的),都要重新運行上述命令以進行重新編譯。
使Python隨處可用¶
在*.py
文件上啟動python的方法有兩種。
雙擊方法¶
如果您僅安裝了一個Python,則可以將所有*.py
文件與python 關聯(如果尚未關聯),然后雙擊運行它。或者,如果您希望每次都可以選擇,則只能執行一次:
- 右鍵單擊要啟動的應用程序的Python文件(.py文件擴展名)
- 在出現的上下文菜單中,選擇“ 打開方式”
- 瀏覽您的硬盤驅動器,找到
python.exe
您要使用的文件。選擇它。 - 如果不想每次雙擊.py文件時都重復此過程,請選擇“始終使用...打開文件”。
- 大功告成 打開文件。
發送方法¶
您可以使用“發送至”菜單使用我們的Python啟動.py文件:
- 瀏覽到
python.exe
要使用的文件。右鍵單擊並復制它。 - 打開Windows資源管理器(Windows 8中為文件資源管理器),然后轉到地址“ shell:sendto”。您應該獲得特殊的Windows目錄SendTo
- 將先前復制的
python.exe
文件粘貼為快捷方式。 - 將其重命名為python <python-version>。例如
python27-x64
現在,您可以通過右鍵單擊.py文件->“發送到”->“ python <python-version>” 來執行您的應用程序。
卸載Kivy ¶
要卸載Kivy,請使用pip刪除已安裝的軟件包。例如,如果您按照上面的說明進行了設置,請執行以下操作:
python -m pip uninstall kivy_deps.sdl2 kivy_deps.glew kivy_deps.gstreamer python -m pip uninstall kivy