三、用户向导(3.1安装)

我们不要总是重新制造各种轮子，但我们要试着做一些创新的东西；因此，我们要尽可能的使用现存的、高质量的第三方库。为了支持全部的、丰富的Kivy的特色功能，其它几个库是需要首先进行安装的。如果你不需要一些特殊的功能（例如视频回放等），那么你可以不安装相应的依赖。但是有一个依赖库是必须安装的：Cython。

当前版本至少需要Cython v0.20,并且已经在v0.23下测试通过。较新的版本可能能够运行，但是由于没有进行测试，因此不能保证流畅运行。

另外，你需要Python(2.7 <= x < 3.0)或者(3.3 <= x)，如果你想使用窗口相关(比如打开一个窗口)，音频/视频回放或者拼写检查等功能，额外的依赖必须安装。对于这些，我们推荐SDSL2,Gstreamer 1.x和PyEnchant,respectively。

其它一些库有：
* OpenCV 2.0:摄像头输入
* Pillow：图像和文本显示
* PyEnchant：拼写检查

不要恐慌

我们不希望你自己安装这些库。我们已经创建好了你可以直接使用的包库，并且它们包含了目标平台的所需的依赖库。我们仅仅想让你知道它们是可选择的，同时为你作了一个关于Kivy内部使用的包库的大致预览。

一、稳定版本

Kivy的最新稳定版本可以在http://kivy.org/#download找到，请针对你的系统平台参阅相关的安装说明。

• 在Windows平台上安装Kivy

  • 安装
  • 安装最新的轮子
  • Kivy的依赖
  • 什么是wheels,pip和wheel
  • 命令行
  • 使用开发站版Kivy
  • 安装Kivy到一个变动的位置
  • 使Python任何地方都可以使用
  • 从早期的Kivy进行更新

• 在 OS X平台上安装Kivy

  • 使用 Kivy.app
  • 使用 pip

• 在Linux平台上安装Kivy

  • 使用 software packages

• 在虚拟环境上安装Kivy

  • 共同的依赖
  • 对SDL2的依赖
  • 对legacy PyGame的依赖
  • 从命令行开始

• 在Android平台上安装Kivy

• 在Raspberry Pi上安装Kivy

  • 安装手册 (On Raspbian Jessie)
  • 安装手册 (On Raspbian Wheezy)
  • KivyPie 分发
  • 运行演示
  • 改变默认到当前使用的屏幕
  • 使用官方的RPI触摸显示
  • 继续到哪里学习

• 在OS X平台上解决问题

  • “不能找到任何可用的窗口提供者”错误(“Unable to find any valuable Window provider” Error)
  • 检测你的Pygame安装问题(Check for Problems with Your PyGame Installation)

二、开发版本

开发版本适合开发者和测试者使用。注意当运行开发版本时，在你的任务里，你正在运行潜在的错误代码。为了使用开发版本，你首先需要安装依赖；而后，你需要在你的计算机中设置Kivy以便更容易开发，请查看我们的贡献(Contributing)文档。

（一）安装依赖

为了安装Kivy的依赖，请依据你的系统平台遵循下面的向导。

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

现在你已经获取了所有的Kivy依赖，你需要使用下面的命令来安装它：

xcode-select --install

转到一个合适的路径，如：

mkdir ~/code
cd ~/code

你现在可以安装Kivy：

git clone http://github.com/kivy/kivy
cd kivy
make

这将会编译Kivy，为了在你的Python环境中可以访问它，你需要将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

（二）安装Kivy

现在你已经安装了所有的依赖，是时候下载和编译一个开发版本的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环境变量指向你的镜象。这种情况下，在每一个小的更新后，你不需要使用安装(setup.pyinstall)。Python将会从你的镜象中导入Kivy。

相应地，如果你不想改变Kivy，你也可以运行：

$ python setup.py install

如果你想提交代码（补丁，新特性）到Kivy的代码库，请参阅提交代码

（三）运行测试套件

为了帮助在Kivy中测试问题和行为变动，Kivy提供了一组单元测试。当你安装Kivy后或你想做一个改动时，就可以运行它。如果在Kivy中发生错误，也许测试将会显示它们。

Kivy基于nosetest测试，你可以使用包管理或pip进行安装：

$ pip install nose

为了运行测试套件，可以执行：

$ make test

（四）卸载Kivy

如果你安装了多个版本的Kivy，你也许会迷惑于调用了哪个版本的Kivy。如果你已经在Python库路径下安装了多个Kivy版本，请注意你需要多次执行下面的步骤：

$ 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

下节预告：3.1.2在Windows平台上安装Kivy