我們不要總是重新制造各種輪子,但我們要試著做一些創(chuàng)新的東西愕把;因此拣凹,我們要盡可能的使用現(xiàn)存的森爽、高質量的第三方庫。為了支持全部的嚣镜、豐富的Kivy的特色功能爬迟,其它幾個庫是需要首先進行安裝的。如果你不需要一些特殊的功能(例如視頻回放等)菊匿,那么你可以不安裝相應的依賴付呕。但是有一個依賴庫是必須安裝的:Cython。
當前版本至少需要Cython v0.20,并且已經(jīng)在v0.23下測試通過跌捆。較新的版本可能能夠運行徽职,但是由于沒有進行測試,因此不能保證流暢運行疹蛉。
另外活箕,你需要Python(2.7 <= x < 3.0)或者(3.3 <= x),如果你想使用窗口相關(比如打開一個窗口)可款,音頻/視頻回放或者拼寫檢查等功能育韩,額外的依賴必須安裝。對于這些闺鲸,我們推薦SDSL2,Gstreamer 1.x和PyEnchant,respectively筋讨。
其它一些庫有:
* OpenCV 2.0:攝像頭輸入
* Pillow:圖像和文本顯示
* PyEnchant:拼寫檢查
不要恐慌
我們不希望你自己安裝這些庫。我們已經(jīng)創(chuàng)建好了你可以直接使用的包庫摸恍,并且它們包含了目標平臺的所需的依賴庫悉罕。我們僅僅想讓你知道它們是可選擇的,同時為你作了一個關于Kivy內部使用的包庫的大致預覽立镶。
一壁袄、穩(wěn)定版本
Kivy的最新穩(wěn)定版本可以在http://kivy.org/#download找到,請針對你的系統(tǒng)平臺參閱相關的安裝說明媚媒。
二嗜逻、開發(fā)版本
開發(fā)版本適合開發(fā)者和測試者使用。注意當運行開發(fā)版本時缭召,在你的任務里栈顷,你正在運行潛在的錯誤代碼。為了使用開發(fā)版本嵌巷,你首先需要安裝依賴萄凤;而后,你需要在你的計算機中設置Kivy以便更容易開發(fā)搪哪,請查看我們的貢獻(Contributing)文檔靡努。
(一)安裝依賴
為了安裝Kivy的依賴,請依據(jù)你的系統(tǒng)平臺遵循下面的向導。
1. 烏班圖(Ubuntu)
對于烏班圖V12.04或更高(測試到V14.04)颤难,僅僅需要輸入下面的命令來安裝所需的包:
$ sudo apt-get install python-setuptools python-pygame python-opengl \
python-gst0.10 python-enchant gstreamer0.10-plugins-good python-dev \
build-essential libgl1-mesa-dev-lts-quantal libgles2-mesa-dev-lts-quantal\
python-pip
對于烏班圖V15.04和老于V12.04的版本神年,下面的方法應該可以工作:
$ sudo apt-get install python-setuptools python-pygame python-opengl \
python-gst0.10 python-enchant gstreamer0.10-plugins-good python-dev \
build-essential libgl1-mesa-dev libgles2-mesa-dev zlib1g-dev python-pip
Kivy需要一個較新版本的Cpython已维,因此行嗤,從pypi獲取最新的版本是較好的辦法:
$ sudo pip install --upgrade Cython==0.23
2. OS X
你可以在終端控制臺輸入以下命令來配置Kivy的依賴:
curl -O -L https://www.libsdl.org/release/SDL2-2.0.4.dmg
curl -O -L https://www.libsdl.org/projects/SDL_image/release/SDL2_image-2.0.1.dmg
curl -O -L https://www.libsdl.org/projects/SDL_mixer/release/SDL2_mixer-2.0.1.dmg
curl -O -L https://www.libsdl.org/projects/SDL_ttf/release/SDL2_ttf-2.0.13.dmg
curl -O -L http://gstreamer.freedesktop.org/data/pkg/osx/1.7.1/gstreamer-1.0-1.7.1-x86_64.pkg
curl -O -L http://gstreamer.freedesktop.org/data/pkg/osx/1.7.1/gstreamer-1.0-devel-1.7.1-x86_64.pkg
hdiutil attach SDL2-2.0.4.dmg
sudo cp -a /Volumes/SDL2/SDL2.framework /Library/Frameworks/
這可能會向你請求根訪問密碼,提供給它而后在你的終端控制臺粘貼以下命令:
hdiutil attach SDL2_image-2.0.1.dmg
sudo cp -a /Volumes/SDL2_image/SDL2_image.framework /Library/Frameworks/
hdiutil attach SDL2_ttf-2.0.13.dmg
sudo cp -a /Volumes/SDL2_ttf/SDL2_ttf.framework /Library/Frameworks/
hdiutil attach SDL2_mixer-2.0.1.dmg
sudo cp -a /Volumes/SDL2_mixer/SDL2_mixer.framework /Library/Frameworks/
sudo installer -package gstreamer-1.0-1.7.1-x86_64.pkg -target /
sudo installer -package gstreamer-1.0-devel-1.7.1-x86_64.pkg -target /
pip install --upgrade --user cython pillow
現(xiàn)在你已經(jīng)獲取了所有的Kivy依賴垛耳,你需要使用下面的命令來安裝它:
xcode-select --install
轉到一個合適的路徑栅屏,如:
mkdir ~/code
cd ~/code
你現(xiàn)在可以安裝Kivy:
git clone http://github.com/kivy/kivy
cd kivy
make
這將會編譯Kivy,為了在你的Python環(huán)境中可以訪問它堂鲜,你需要將PYTHONPATH指向這個路徑:
export PYTHONPATH=~/code/kivy:$PYTHONPATH
為了測試Kivy是否安裝成功栈雳,在你的終端窗口輸入:
python -c "import kivy"
它可能給你一個類似如下的輸出:
$ python -c "import kivy"
[INFO ] [Logger ] Record log in /Users/quanon/.kivy/logs/kivy_15-12-31_21.txt
[INFO ] [Screen ] Apply screen settings for Motolora Droid 2
[INFO ] [Screen ] size=480x854 dpi=240 density=1.5 orientation=portrait
[INFO ] [Kivy ] v1.9.1-stable
[INFO ] [Python ] v2.7.10 (default, Oct 23 2015, 18:05:06)
[GCC 4.2.1 Compatible Apple LLVM 7.0.0 (clang-700.0.59.5)]
如果使用brew方法來安裝Kivy,需要使用homebrew來安裝依賴:
$ brew install sdl2 sdl2_image sdl2_ttf sdl2_mixer gstreamer
3. Windows
(二)安裝Kivy
現(xiàn)在你已經(jīng)安裝了所有的依賴缔莲,是時候下載和編譯一個開發(fā)版本的Kivy了:
從GitHub下載Kivy:
$ git clone git://github.com/kivy/kivy.git
$ cd kivy
編譯:
$ python setup.py build_ext --inplace -f
如果你可以使用make命令哥纫,你也可以使用下面的簡短的命令進行編譯(和上面的命令相同):
$ make
警告,默認情況下痴奏,Python V2.7~V2.7.2版本使用gcc編譯器蛀骇,這個編譯器搭配早期版本的XCode。對于V4.2版本读拆,僅僅clang編譯器默認搭配了XCode擅憔。這意味著,如果你使用XCode4.2及更高版本檐晕,你需要確保你至少安裝了Python 2.7.3暑诸,最好是使用最新的版本。
如果你想更新Kivy代碼辟灰,設置PYTHONPATH環(huán)境變量指向你的鏡象个榕。這種情況下,在每一個小的更新后芥喇,你不需要使用安裝(setup.pyinstall)西采。Python將會從你的鏡象中導入Kivy。
相應地乃坤,如果你不想改變Kivy苛让,你也可以運行:
$ python setup.py install
如果你想提交代碼(補丁,新特性)到Kivy的代碼庫湿诊,請參閱提交代碼
(三)運行測試套件
為了幫助在Kivy中測試問題和行為變動狱杰,Kivy提供了一組單元測試。當你安裝Kivy后或你想做一個改動時厅须,就可以運行它仿畸。如果在Kivy中發(fā)生錯誤,也許測試將會顯示它們。
Kivy基于nosetest測試错沽,你可以使用包管理或pip進行安裝:
$ pip install nose
為了運行測試套件簿晓,可以執(zhí)行:
$ make test
(四)卸載Kivy
如果你安裝了多個版本的Kivy,你也許會迷惑于調用了哪個版本的Kivy千埃。如果你已經(jīng)在Python庫路徑下安裝了多個Kivy版本憔儿,請注意你需要多次執(zhí)行下面的步驟:
$ python -c 'import kivy; print(kivy.__path__)'
接下來,遞歸移除這個路徑放可。
如果你在Linux上使用easy_install安裝了Kivy谒臼,路徑可能包含一個'egg'的路徑,使用下面的方法來移除它:
$ python -c 'import kivy; print(kivy.__path__)'
['/usr/local/lib/python2.7/dist-packages/Kivy-1.0.7-py2.7-linux-x86_64.egg/kivy']
$ sudo rm -rf /usr/local/lib/python2.7/dist-packages/Kivy-1.0.7-py2.7-linux-x86_64.egg
如果你使用apt-get的方式安裝了Kivy耀里,則使用下面的命令:
$ sudo apt-get remove --purge python-kivy