Windows上安裝-kivy
原文: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及其所有依賴項
我們還提供使用Kivymaster生成的每晚車輪。請參閱每晚安裝車輪。如果將kivy安裝到其他位置而不是站點軟體包,請參閱安裝Kivy並在適當位置進行編輯。
注意
對於Python <3.5,我們使用MinGW編譯器。但是,對於Windows上的Python 3.5+,我們目前僅支援MSVC編譯器,因為以下有關MinGW的Python發行號4709。通常,在使用預編譯車輪時,這應該沒有區別。
從以前的版本更新Kivy¶
從以前的Kivy版本進行更新時,必須首先更新所有Kivy依賴項。通常,只需
警告
從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中執行或執行一個基本示例:importkivy
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-mpipinstallkivy
python-mpipinstallwheel_file_name
python -m pip install C:\Kivy-1.9.1.dev-cp27-none-win_amd64.whl
每晚安裝車輪¶
警告
使用最新的開發版本可能會冒險,並且在開發過程中可能會遇到問題。如果您遇到任何錯誤,請報告它們。
當前在Kivy儲存庫的master分支上建立當前Kivy master的快照輪。他們可以在這裡找到。要使用它們,而不是這樣做,我們將如下安裝這些輪子之一。python-mpipinstallkivy
- 執行上述“安裝”部分的步驟1和2。
- 下載適合您系統的輪子。
- 使用檔名where進行安裝。
python-mpipinstallwheel-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的路徑中。cdC:\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本地副本的完整路徑。
pipinstallfilename
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