Mac系統安裝Kivy指南

使用官方提供的Kivy.app

特別注意

官方提供的Kivy.app僅僅適用於OS X 10.7以及更新版本的系統（都是64位的）。對10.7之前的系統以及10.7的32位系統的用戶，你就只能自己手動安裝各種組件了。建議通過 homebrew 來安裝。

對OS X 10.7 64位版本以及更新版本系統，Kivy官方提供了一個Kivy.app的包，裡面集成好了所有需要的依賴包。可以從這個鏈接來下載壓縮包，解壓縮之後就能發現一個名為Kivy.app的應用文件。

要怎麼安裝呢？具體思路如下：

1 從官網的這個鏈接下載壓縮包，其中Kivy2.7z用的是Python 2，而Kivy3.7z用的是Python 3。

2 使用解壓縮工具把壓縮包進行解壓，可以試試Keka這個應用。

3 把解壓縮出來的Kivy2.app或者Kivy3.app這兩個文件當中選擇一個，重命名成Kivy.app，複製到應用程序目錄/Applications 下，這個過程可以在終端中通過下面的命令來實現

sudo mv Kivy2.app /Applications/Kivy.appn

4 然後是創建一個名為kivy的系統鏈接，以便於方便訪問kivy環境來啟動app：

ln -s /Applications/Kivy.app/Contents/Resources/script /usr/local/bin/kivyn

5 樣例代碼以及所有常規的Kivy工具都可以在/Applications/Kivy.app/Contents/Resources/kivy 這個目錄裡面找到了。

6 譯者註：你完全可以同時擁有Kivy2.app和Kivy3.app，可以不重命名他們，而直接把這兩個都複製到/Applications/下，然後用如下方式分別創建名為kivy2和kivy3的鏈接（這樣以後你就可以通過kivy2來使用Python2版本的Kivy，而用kivy3來使用Python3版本的Kivy了。）：

ln -s /Applications/Kivy2.app/Contents/Resources/script /usr/local/bin/kivy2nln -s /Applications/Kivy3.app/Contents/Resources/script /usr/local/bin/kivy3n

現在你就可以在終端中用Kivy腳本文件來啟動Kivy的app了，也可以把你的main.py直接拽到終端中就能運行了。

安裝模塊

OS X上的Kivy使用自己集成的一個python環境，只在你用kivy命令的時候才被激活。所以要在這裡安裝模塊，要在pip命令前面加上kivy -m的前綴，如下所示（記得把替換成你要安裝的模塊名）：

kivy -m pip install <modulename>n

這些模塊安裝到哪裡了呢？

安裝位置在Kivy.app目錄內的venv目錄下：

Kivy.app/Contents/Resources/venv/n

如果你安裝一個二進位的模塊，例如kivy-garden，這些二進位文件就只能在venv一級以上的目錄使用：

kivy -m pip install kivy-gardenn

上面這個命令安裝的garden的鏈接庫文件，只有通過如下命令激活這個虛擬環境了才能使用：

source /Applications/Kivy.app/Contents/Resources/venv/bin/activatengarden install mapviewndeactivaten

二進位文件安裝

直接複製到/Applications/Kivy.app/Contents/Resources/venv/bin/這個目錄就行了。

安裝其他框架

Kivy.app自帶了SDL2和Gstreamer這兩個框架。要增加其他的框架讓Kivy使用，可以按照如下思路實現：

git clone http://github.com/tito/osxrelocatornexport PYTHONPATH=~/path/to/osxrelocatorncd /Applications/Kivy.appnpython -m osxrelocator -r . /Library/Frameworks/<Framework_name>.framework/ n@executable_path/../Frameworks/<Framework_name>.framework/n

一定要記得把替換成你需要的框架名。osxrelocator這個工具是用來改變框架中的鏈接庫目錄，這樣就可以讓這些框架可以在Kivy.app中使用了。

啟動任意一個Kivy應用

要運行Kivy應用，只要把源碼拖拽到Kivy.app圖標上，就可以了。樣例代碼目錄中的任何Python文件都可以拿來試試。

從命令行啟動

如果要在命令行中運行Kivy，把Kivy.app複製到應用目錄後，雙擊Make Symlinks script 這個腳本文件，就可以了。要測試是否成功，可以按照如下方式：

1 打開終端，輸入：

kivyn

你就應該能得到一個Python解釋器環境了。

2 然後在這個Python解釋器內輸入如下代碼：

import kivyn

如果什麼反應都沒有，沒有出錯，那就說明搞定了。ut errors, it worked.

3 經過上面的驗證，說明配置成功了。這樣在命令行終端中運行Kivy應用就很簡單了，只是執行一下腳本就可以，如下所示：

kivy yourapplication.pyn

使用HomeBrew安裝Kivy

使用HomeBrew和Pip也可以安裝Kivy，具體步驟如下所示：

1 首先要先安裝homebrew，然後安裝必備組件：

brew install sdl2 sdl2_image sdl2_ttf sdl2_mixer gstreamern

2 然後是通過pip安裝cython 0.23和kivy（一定要注意，要確保設置環境變數USE_OSX_FRAMEWORKS=0）：

pip install -I Cython==0.23nUSE_OSX_FRAMEWORKS=0 pip install kivyn

3 如果不想安裝穩定版而想使用開發版，第二步就要改用如下命令了：

USE_OSX_FRAMEWORKS=0 pip install https://github.com/kivy/kivy/archive/master.zipn

使用MacPorts和Pip來進行安裝

特別注意

如果你希望自己的Kivy應用能夠支持視頻播放，就得手動安裝gstreamer。可以供過MacPorts來安裝py-gst-python port. 用MacPorts和Pip安裝Kivy的過程如下：

1 安裝Macports

2 安裝Python 3.4並且設定成默認的：

port install python34nport select --set python python34n

3 然後安裝Pip並設置為默認：

port install pip-34nport select --set pip pip-34n

4 使用Macports安裝必備組件：

port install libsdl2 libsdl2_image libsdl2_ttf libsdl2_mixern

5 使用Pip安裝cython 0.23和kivy（一定要注意，要確保設置環境變數USE_OSX_FRAMEWORKS=0）:

pip install -I Cython==0.23nUSE_OSX_FRAMEWORKS=0 pip install kivyn

6 如果不想安裝穩定版而想使用開發版，第二步就要改用如下命令了：

USE_OSX_FRAMEWORKS=0 pip install https://github.com/kivy/kivy/archive/master.zipn

特別注意

如果你在Mac系統下使用Kivy-Designer的時候遇到如下錯誤：

[WARNING ] stderr: from designer.app import DesignerAppn[WARNING ] stderr: File "/Users/cycleuser/kivy-designer/designer/app.py", line 27, in <module>n[WARNING ] stderr: from kivy.garden.filebrowser import FileBrowsern[WARNING ] stderr: ImportError: No module named filebrowsern

那麼不要猶豫，肯定是Garden的安裝位置你沒有調整，你需要參考我的這篇文章來解決這個問題。