第一部分用户指引

文档的这一部分解释了Kyy设计背后的基本思想以及为什么要使用它。接着继续讨论架构，并展示如何在短时间内使用这个框架创建惊人的应用程序。

第一章安装

我们尽量不重蹈覆辙，而是把创新的东西推向市场。因此，我们专注于自己的代码，并在可能的情况下使用预先存在的、高质量的第三方库。

为了支持Kivy提供的完整、丰富的特征集，需要其他几个库。如果你不使用特定的功能（例如视频播放），不需要其他相应的依赖库。

但是Kivy还是需要一种依赖库，那就是Cython。

此外，还需要Python 2 .x（2.7＜x＜3）或3 .x（3.3 <＝x）解释器。如果你想启用
诸如窗口（即打开窗口）、音频/视频播放或拼写校正等特性，附加功能的依赖关系必须可用。对于这些，我们分别推荐SDL2、Gstreamer 1.x 和 PyEnchant。

其他可选库（相互独立）是：

OpenCV 2.0 用于摄像机输入

Pillow 用于图片和文本渲染

PyEnchant 用于拼写校正

但是，不要对这些依赖感到惊慌！
我们不希望你自己安装所有这些东西。相反，我们创造了漂亮的便携式可以直接使用的包，它们已经包含了平台的必要包。我们只想让您知道，默认值还有其他选择，并给您一个Kivy内部使用内容的概述。

1.1 依赖

以下是Kivy需要运行的列出的依赖项，并且在特定版本中有问题，导致影响了我们的核心功能，Kivy要么不编译，要么会抛出异常错误。

1.1.1 Cython

Kivy1.10.1.Dev0 至少需要 Cython版本0.23，并已通过0.27.3测试。往后的版本可能可以工作，但因为它们没有被测试，所以无法保证。目前 0.27，0.27.2版本Cython有已知的问题，不能用于Kivy。

已知问题：

Kivy依赖的Cython 0.27 版本声明错误导致 1.10.0的Kivy会发生编译错误。

不支持：

Kivy依赖的Cython 0.27 ~ 0.27.2版本不能用于Python 3.4（带有MinGWPy）编译，因为使用了未导出的编译期间的符号。有关更多细节，请参见此问题

1.1.2 稳定版本

最新的稳定版本可以在Kivy官方网站上找到下载下载。请参考特定平台的安装说明。

1.1.2.1 在Window平台安装

从1.91开始，在现有的Python安装中，我们为Kivy 提供二进制wheel及其所有依赖项。
我们也提供了每夜由Kivy 主干构建的版本。具体内容可以查看每夜Wheel版本的安装相关内容。也可以查看从以前Kivy分发包中升级相关文档。如果将Kivy安装到修改过的位置，也可以的查看文档安装Kivy到修改的位置相关文档。

注意：对于Python 版本号小于 3.5，我们使用MinGW编译器。但是，对于Windows上的Python 3.5 以后的版本，目前只支持MSVC编译器，因为Python关于MinGW的问题4709。一般来说，这和使用预编译的Wheel时，这不会有什么区别。

使用Kivy需要Python。Python的多个版本可以共存，但Kivy需要在你想使用它的每个python版本中安装好Kivy。

安装
安装了Python以后，打开命令行窗口，通过输入python --verison 确保python可以使用。接着做以下操作：

确保你有最新的 pip 和 wheel：

python -m pip install --upgrade pip wheel setuptools

安装依赖，（跳过 gstreamer (120MB)安装步骤）如果你不需要的话。查看Kivy的依赖

python -m pip install docutils pygments pypiwin32 kivy.deps.sdl2 kivy.deps.glew
python -m pip install kivy.deps.gstreamer

注意：如果在安装过程中遇到内存错误，请在pip install 后添加一个选项 -no-cache-dir。

对于Python 3.5，我们提供额外的angle，可以用来代替glew，安装：

python -m pip install kivy.deps.angle

安装Kivy

python -m pip install kivy

（可选）安装Kivy案例

python -m pip install kivy_examples

这些示例安装在Python安装的根目录下的share目录中。
这样就是全部的内容了，你可以在python中 import kivy 跑起来已经安装过的基础案例程序。

python share\kivy-examples\demo\showcase\main.py

注意：如果遇到任何权限被拒绝的错误，请尝试以管理员的身份打开命令行提示符，然后再试一次。

什么是wheels、pip 和 wheel 呢？
在python中，可以使用Python的包管理器 Pip 安装一些类似Kivy的包。有些包例如Kivy如果采用源代码安装的方式还需要额外的操作步骤，例如编译。wheels（扩展名是.whl）是一种已经预编译好的发布包，它需要额外的步骤安装。

当在PyPI上托管时，使用PIP安装一个wheels，例如：

Python -m pip install Kiy

当下载好wheels文件，想直接安装的时候，使用方式 python -m pip install wheel_file_name ，例如：

python -m pip install C:\Kivy-1.9.1.dev-cp27-none-win_amd64.whl

每夜wheels安装

警告：警告：在开发过程中使用最新开发版本可能有风险，你可能会遇到问题。如果您遇到任何错误，请向我们反馈。

kivy 的wheels文件在每次Kivy主分支代码仓库的提交都会进行版本的构建，可以从这里获取。要是他们，而不是采用 python -m pip install kivy，我们反而会采用安装以下内容中的某一个：

Python 2.7, 32bit
Python 3.4, 32bit
Python 3.5, 32bit
Python 3.6, 32bit
Python 2.7, 64bit
Python 3.4, 64bit
Python 3.5, 64bit
Python 3.6, 64bit

执行上述安装部分的步骤1和2。
为你的系统安装正确的wheels文件
用Python -m pip wheel_name，其中wheel_name为重命名文件，然后添加DEP到PATH变量。

Kivy的案例已经从它内核程序进行了分离。这些案例程序在一个单独的wheel里面（适用于Python 2.x 和Python 3.x ）：

Kivy examples

Kivy的依赖
我们分别为Kivy及其依赖提供wheels，所以需要的依赖才被安装。依赖项被提供为Kivy.deps的可选子包，例如kivy.deps.sdl2。
当前在Windws平台，我们提供了以下以来包：

gstream 用于音频和视频的播放
glew 和/或者 angle (仅限于3.5版本) 用于OpenGL 渲染
sdl2 用于控制和/或者用于 OpenGL

您可以使用KIVY_GL_BACKEND环境变量，通过设置为gl.（默认值）、angle或sdl2来选择这些变量中的哪些用于OpenGL。angle 目前处于实验阶段，只代替Python 3.5上的glw。

gstream 是一个可选的依赖。当只有播放音频和视频的功能需要的时候，它才需要被安装。当然ffpyplayer 也是一种可选的替代方案。

命令行
熟悉你的命令行工具。执行 pip工具或者wheel工具的时候，需要python在你的系统的环境变量中。在windows系统中，命令行工具详细内容可以查看这里内容，快捷启动方式是键盘上Win+R，在弹出的窗口中输入cmd,按下Enter，接着就会出现窗口。另外一个Linux风格的命令Shell是Git for Windows。注意，如果安装了Bash Shell ，系统自带的CMD仍然可以使用的。
尝试用这种方式吧！将Python加入系统路径中，只需要打开命令行程序，使用 cd 的命令切换到Python安装所在文件夹(例如 C:\Python27)《另外如果你只有一个版本的Python话，直接在CMD或者Bash使用这个就好了。

使用开发版本的Kivy

警告：在开发的过程中，使用最近的开发版本的Kivy会有比较大的风险，你可能会遇到一些错误。如果你遇到BUG，请及时反馈。

与其使用wheels包安装kivy，倒不如通过Git 使用kivy源代码编译和安装，这样还有其他一些步骤：

Python和Python\Script目录必须在系统路径上。每次你重新编译Kiy时，才能正确工作。
确认你有最新版本的pip工具和wheels工具：

python -m pip install --upgrade pip wheel setuptools

获取编译器。对于低于3.5版本的Python，我们按照如下步骤使用mingwpy:
(a) 新建文件 python\Lib\distutils\distutils.cfg ，然后增加两行的内容

[build]
compiler = mingw32

(b) 安装MinGW:

python -m pip install -i https://pypi.anaconda.org/carlkl/simple mingwpy

对于Python 3.5，我们使用MSVC编译器。对于3.5，Visual Studio 2015是必需的，它是免费的。只要下载并安装它，你就可以很快熟悉了。
VisualStudio非常大，因此你也可以使用较小的VisualC构建工具来代替。

这是环境变量。在Window平台：

set USE_SDL2=1 
set USE_GSTREAMER=1

在Bash中：

export USE_SDL2=1 export USE_GSTREAMER=1

这些变量在你每次重新编译Kivy的时候需要重新设置。
5.安装其他的依赖（如果不需要视频和音频播放，可以不用安装gstream）

python -m pip install cython 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到另一个位置，不想将它安装到site-packages位置，请阅读下一节。
最后，使用pip install 文件名编译和安装kivy，其中文件名可以是url，例如用于kivy 主分支的https://github.com/kivy/kivy/archive/master.zip，或者kivy的本地副本的完整路径。

编译Kivy

从Github上clone克隆代码：

python -m pip install kivy\.

如果编译成功没有任何错误，Kivy应该是可以使用的。你可以通过运行一个基本的例子来测试它：

python share\kivy-examples\demo\showcase\main.py

安装Kivy到其他位置
在开发中，Kivy通常安装到其他备用位置，然后安装：

python -m pip install -e location

这允许Kivy在供python使用的同时保持其原始位置，这对于直接使用Git去跟踪Kivy中的更改非常有用。
为了在不同的位置使用Kivy，需要额外的调整。由于这个问题，wheels和PIP将依赖wheel安装到 python\Lib\site-packages\kivy。所以它们需要从这个位置中移到你的Kivy安装的位置。
在安装Kivy依赖项并下载或克隆Kivy到您最喜欢的位置之后，请执行以下操作：

移动内容 python\Lib\site-packages\kivy\deps to your-path\kivy\deps 到你的Kivy所在位置
移除文件夹 python\Lib\site-packages\kivy
从 python\Lib\site-packages 移动 kivy.deps.*.dist-info 目录到Kivy旁边的路径。

现在您可以用以下命令中的其中一个，安全地编译Kivy在其当前位置：

> make 
> mingw32-make 
> python -m pip install -e . 
> python setup.py build_ext --inplace

如果kivy import 失败，可能是因为你没有从site-package中删除所有的 .dist-info 文件夹或者 kivy or kivy.deps相关信息

让Python随时随地可用
在Python上启动Python文件有两种方法。

双击的方法
如果只安装了一个Python，那么可以将所有*.py 文件与您的python关联（如果还没有），然后通过双击运行它。

右键单击要启动的Python应用程序的（.py文件扩展名）。
从弹出的菜单中选择，选择打开方式
浏览你的硬盘，找到你想要使用的\Python.exe。选择它
如果每次双击Python文件时不想重复这个过程，请选择“始终打开……”。
完成，打开文件。

Send-To的方法
你可以执行Python文件通过“发送到”菜单启动。

浏览到要使用的Python.exe文件。右击它并复制。
打开Windows资源管理器（Windows 8中的文件资源管理器），并转到地址“shell：sendTo”。你应该得到特殊的Windows目录
粘贴之前复制到的python.exe到该地方
重命名python.exe为其他名字。例如：python27-x64
你现在可以通过右键python文件发送到 “python27-x64” 去执行python文件。
要将新wheels安装到以前的Kivy发行版中，除了python文件夹之外，所有文件和文件夹都应该从发行版中删除。然后，这个python文件夹将被视为正常安装的系统python，然后可以继续前文安装中描述的所有步骤。

1.2.2 在Mac OS中进行安装

注意：本指南描述了建立KiVy的多种方法。建议使用自制Homebrew和PIP安装。
使用homebrew和pip

使用homebrew安装所需内容：

$ brew install pkg-config sdl2 sdl2_image sdl2_ttf sdl2_mixer gstreamer

使用pip安装Cython和Kivy：

$ pip install Cython==0.26.1 
$ pip install kivy

安装开发版本，在第2步骤使用以下指令：

$ pip install https://github.com/kivy/kivy/archive/master.zip

使用MacPorts和pip安装

注意：如果你想在你的Kivy App中播放音频，你就必须需要手动安装Gstreamer。最近的port文档可以从以下的获取py-gst-python port。

你可以使用以下步骤安装Kivy:

安装 Macports
安装和设置Python3.4为默认的python解释器：

$ port install python34 $ port select --set python python34

3.安装和设置pip为默认的包管理器：

$ port install pip-34 
$ port select --set pip pip-34

4.使用Macports 安装必要的内容：

$ port install libsdl2 libsdl2_image libsdl2_ttf libsdl2_mixer

5.使用PIP安装Cython和Kivy:

$ pip install Cython==0.26.1 
$ pip install kivy

如果安装开发版本，你可以在第二步骤中使用以下指令：

$ pip install https://github.com/kivy/kivy/archive/master.zip

使用Kivy App

注意：Kivy.app在下载的时候不可以使用。对于更多内容，你可以查看这些[内容]（https://github.com/kivy/kivy/issues/5211）。

注意：目前这个方法是在OS X 1.7中测试。对于10.7或者10.7 32位的版本。你不需要自己安装Components。我们建议使用Homebrew这个软件。

对于OS X 10.7以及更高版本，我们提供了绑定在虚拟环境中的所有依赖项的包，包括用于Kivy3.app的Python 3的解释器。这些包是用于快速原型开发的，目前是用Buildzoer包装KiVy应用程序的容器。

安装Kivy，你必须：

在这个网址中浏览最近版本的Kivy。然后下载 Kivy-osx-python.7z.
使用解压软件 Keka解压它
拷贝Kivy2.app 或者 Kivy3.app 作为 Kivy.app 到/Application这个位置。然后在终端执行以下命令行：

$ sudo mv Kivy2.app /Applications/Kivy.app

创建命名为kivy的链接，以便能够使用kivy venv快速启动应用程序：

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

所有的案例或者kivy的工具都已经包含在 Kivy.app/Contents/Resources/Kivy 的目录结构

你现在有一个Kivy的脚本可以在命令行中快速启动你的kivy应用程序。你只需要拖拽你的main.py到命令行即可。

安装模块
OS X上的Kivy SDK使用自己的虚拟环境，当使用Kiy命令运行应用程序时，该虚拟环境被激活。如果你需要安装需要你想要的模块，你可以这样：

$ kivy -m pip install

到底模块/文件到底安装在哪个位置呢？
在应用程序内的便携式虚拟环境里面：

Kivy.app/Contents/Resources/venv/

如果你安装一个模块(安装二进制文件，例如 kivy-garden)。这个二进制文件只有在上文提到的虚拟环境中有效。就和你执行以下命令是同样的效果：

kivy -m pip install kivy-garden

garden库只有当你激活这个环境的时候，才会变得有效：

source /Applications/Kivy.app/Contents/Resources/venv/bin/activate garden install mapview deactivate

安装二进制文件
只需要拷贝二进制文件到 ** /Applications/Kivy.app/Contents/Resources/venv/bin/ **位置

包含其他的框架
Kivy.app 发布的时候带有SDL2和Gstreamer。要包含除所提供的以外的框架，请执行以下操作:

git clone http://github.com/tito/osxrelocator export PYTHONPATH=~/path/to/osxrelocator cd /Applications/Kivy.app python -m osxrelocator -r . /Library/Frameworks/.framework/ \ @executable_path/../Frameworks/.framework/

不要忘记替代的内容。工具osxrelocator 改变了框架中库的路径，使它们的路径是相对于.app文件的，使得Framework可以与app一起移植。

*启动任何的Kivy应用程序
你可以通过拖拽应用程序的main文件到Kivy.app
图标，以运行任何的Kivy应用程序。你可以尝试用这种方法去运行Kivy的案例程序。

从命令行启动应用程序
如果你想从命令行启动Kivy程序，在你已经拖拽Kivy.app到应用程序的文件夹厘米厚，双击 Make Symlinks 脚本。可以通过以下步骤测试是否可行：

打开命令行，然后输入：

$ kivy

2.然后输入：

import kivy

如果没有任何错误，那表示执行成功。

接着执行Kivy程序

$ kivy yourapplication.py

1.2.3 在Linux中安装

针对不同的Linux发行版要使用对应的软件包
.deb / .rpm
Ubuntu / Kubuntu / Xubuntu / Lubuntu (Saucy and above)

添加一个你想要的PPAs
稳定构建

$ sudo add-apt-repository ppa:kivy-team/kivy

每日构建
···
$ sudo add-apt-repository ppa:kivy-team/kivy-daily
···

使用包管理器更新包列表

 $ sudo apt-get update

3.安装Kivy:
Python2-python-kivy

 $ sudo apt-get install python-kivy

Python3-python3-kivy

$ sudo apt-get install python3-kivy

安装案例（可选）

$ sudo apt-get install python-kivyexamples

Debian (Jessie 或者更新的版本)

在APT中手动添加一个PPA到列表中

稳定版本
每日构建
注意：Wheezy是没有被支持的。你至少需要升级到Jessie

通过执行将GPG密钥添加到APT密钥环：
如果是用户：

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys A863D2D6

如果是Root：

apt-key adv --keyserver keyserver.ubuntu.com --recv-keys A863D2D6

刷新你的包列表，然后安装python-kivy 和/或者 python3-kivy，以及安装kivy案例（可选）。

Linux Mint

了解Ubuntu发布的安装是基于什么，可以使用这个概述。
取决于你的安装基于哪个版本，继续以上Ubuntu的安装描述。

Bodhi Linux

确认你现在运行的是哪个版本的发行版。使用以下列表中的去找出Ubuntu LTS是基于哪一个。

Bodhi 1 Ubuntu 10.04 LTS aka Lucid (No packages, just manual install)
Bodhi 2 Ubuntu 12.04 LTS aka Precise
Bodhi 3 Ubuntu 14.04 LTS aka Trusty
Bodhi 4 Ubuntu 16.04 LTS aka Xenial

取决于你的安装基于哪个版本，继续以上Ubuntu的安装描述。

OpenSuSE

到网址安装kivy。为openSuSe的发行版使用 "1 Click Install"安装。你可能想通过点击显示不稳定版本去查阅最近的Kivy的版本。我们更喜欢通过 "devel:languages:python"去决定如何使用安装包
如果想访问kivy这些示例，请在即将安装的向导中选择Python Kivy示例。

Gentoo

有一个Kivy的稳定版
emerge Kivy
有效的USE-FLag是：
cairo：标准的flag，可以让kivy使用 cairo图形库
camera：安装该库，可以让kivy支持摄像机相关内容
doc：标准的flag，可以让你本地构建文档
examples: 标准的flag，可以让你获得kivy案例
garden：安装garden工具，可以管理用户维护的控件
gstreamer：标准的flag，kivy能够支持音频和视频的播放
spell：标准的flag，可以在kivy支持拼写校正

其他
对于其他Linux发行版，我们建议通过PIP进行安装，如下所示。

1.2.4 安装一个虚拟环境

通用的依赖
Cython
Kivy的不同版本只对某个Cython版本进行了测试。

QQ图片20181029095725.png

与SDL2的依赖关系
Ubuntu 案例
在下面的命令中，在Python 2中使用“Python”和“Python-dev”，或者在Python 3中使用“Python 3”和“Python 3-dev”。

# Install necessary system packages 
sudo apt-get install -y \ 
python-pip \ 
build-essential \ 
git \ 
python \ 
python-dev \ 
ffmpeg \ 
libsdl2-dev \ 
libsdl2-image-dev \ 
libsdl2-mixer-dev \ 
libsdl2-ttf-dev \ 
libportmidi-dev \ 
libswscale-dev \ 
libavformat-dev \ 
libavcodec-dev \ 
zlib1g-dev

# Install gstreamer for audio, video (optional) 
sudo apt-get install -y \ 
libgstreamer1.0 \ 
gstreamer1.0-plugins-base \ 
gstreamer1.0-plugins-good

注意：依赖于您的Linux版本，您可能会收到与“ffmpeg”包相关的错误信息。在这种情况下，使用“libav-tools”代替“ffmpeg”，或者使用PPA（如下所示）：

- sudo add-apt-repository ppa:mc3man/trusty-media 
- sudo apt-get update 
- sudo apt-get install ffmpeg

安装

#确认Pip, Virtualenv and Setuptools 已经被更新了
sudo pip install --upgrade pip virtualenv setuptools

# 然后创建一个命名为 "kivyinstall" 的 virtualenv(虚拟环境):
# 1. 使用默认的解释器
virtualenv --no-site-packages kivyinstall

# 或者 2. 使用指定的解释器
# (这样将使用位置在/usr/bin/python2.7的python解释器) 
virtualenv --no-site-packages -p /usr/bin/python2.7 kivyinstall

# 输入 virtualenv
. kivyinstall/bin/activate

# 这里使用正确的Cython
pip install Cython==0.27.3

# 安装稳定的Kivy版本到virtualenv里面
pip install kivy 
# 对于开发版本的Kivy, 使用以下命令替代
# pip install git+https://github.com/kivy/kivy.git@master

与传统PyGame的依赖关系
Ubuntu 案例

# 安装系统必要的包
sudo apt-get install -y \ 
python-pip \ 
build-essential \ 
mercurial \ 
git \ 
python \ 
python-dev \ 
ffmpeg \ 
libsdl-image1.2-dev \ 
libsdl-mixer1.2-dev \ 
libsdl-ttf2.0-dev \ 
libsmpeg-dev \ 
libsdl1.2-dev \ 
libportmidi-dev \ 
libswscale-dev \ 
libavformat-dev \ 
libavcodec-dev \ 
zlib1g-dev

Fedora

$ sudo yum install \ 
make \ 
mercurial \ 
automake \ 
gcc \ 
gcc-c++ \ 
SDL_ttf-devel \ 
SDL_mixer-devel \ 
khrplatform-devel \ 
mesa-libGLES \ 
mesa-libGLES-devel \ 
gstreamer-plugins-good \ 
gstreamer \ 
gstreamer-python \ 
mtdev-devel \ 
python-devel \ 
python-pip

Fedora

$ sudo yum install \ 
make \ 
mercurial \ 
automake \ 
gcc \ 
gcc-c++ \ 
SDL_ttf-devel \ 
SDL_mixer-devel \ 
khrplatform-devel \ 
mesa-libGLES \ 
mesa-libGLES-devel \ 
gstreamer-plugins-good \ 
gstreamer \ 
gstreamer-python \ 
mtdev-devel \ 
python-devel \ 
python-pip

OpenSuse

$ sudo zypper install \ 
python-distutils-extra \ 
python-gstreamer-0_10 \ 
python-enchant \ 
gstreamer-0_10-plugins-good \ 
python-devel \ 
Mesa-devel \ 
python-pip 
$ sudo zypper install -t pattern devel_C_C++

安装

# 确认Pip, Virtualenv and Setuptools 已经更新了
sudo pip install --upgrade pip virtualenv setuptools
# 接着创建命名为“kivyinstall”的virtualenv：
# 1. 使用默认的python解释器 
virtualenv --no-site-packages kivyinstall

# 或者 2. 使用指定的解释器# (使用 /usr/bin/python2.7) 
virtualenv --no-site-packages -p /usr/bin/python2.7 kivyinstall

# 进入 virtualenv 
. kivyinstall/bin/activate
pip install numpy
pip install Cython==0.27.3
# 如果你想使用pygame 后端代替 sdl2
# 你可以使用命令行export USE_SDL2=0. 安装pygame 
#  如果Kivy安装的时候找不到sdl2 库它就会自动设置该值为0，然后尝试使用pygame
pip install hg+http://bitbucket.org/pygame/pygame
#在virtualenv中安装稳定版本的kivy
pip install kivy
#对于开发版本，你可以使用以下命令代替：
pip install git+https://github.com/kivy/kivy.git@master

安装额外的Virtualenv的包

# 在 virtualenv中安装开发版本的buildozer
pip install git+https://github.com/kivy/buildozer.git@master
# 在 virtualenv中安装开发版本的plyer
pip install git+https://github.com/kivy/plyer.git@master
# 为KivyCatalog 安装依赖
pip install -U pygments docutils

从命令行启动
我们准备了运行例子。然而，这些示例被封装在包内。这意味着您必须首先知道easy_install已经安装了当前的Kivy包中，然后转到示例目录：

$ python -c "import pkg_resources; print(pkg_resources.resource_filename('kivy', '../share/kivy-examples'))"

你应该有一个路径的值：

/usr/local/lib/python2.6/dist-packages/Kivy-1.0.4_beta-py2.6-linux-x86_64.egg/share/kivy-examples/

然后你可以切换到案例文件夹中，运行：

# 执行 touchtracer 
$ cd  
$ cd demo/touchtracer 
$ python main.py
# 执行 pictures 
$ cd  
$ cd demo/pictures 
$ python main.py

如果您熟悉UNIX和符号链接，您可以在主页目录中直接创建一个链接，以便于访问。例如:

从上面的命令行获取示例路径
粘贴到命令行

$ ln -s  ~/

然后你在你的home文件夹目录访问kivy的案例程序

$ cd ~/kivy-examples

如果你想通过脚本(./main.py)或者双击它们可以启动你的Kivy程序，你需要通过链接定义正确的python版本。例如：

$ sudo ln -s /usr/bin/python2.7 /usr/bin/kivy

或者如果你想在virtualenv中运行Kivy程序，链接到Python解释器，你可以这样：
$ sudo ln -s /home/your_username/Envs/kivy/bin/python2.7 /usr/bin/kivy
然后每一行的python文件，输入：

#!/usr/bin/kivy

注意：谨防Python文件存储的时候以windows风格的行末(CR-LF)结束。Linux是不会忽略字符的，它会尝试使用它作为文件名的一部分。这样会产生混乱的信息。所以建议要以Unix行风格结束文件行内容。

设备权限
当你的APP启动的时候，Kivy使用 Mtdev 扫描可用的多点触控设备作为输入。对这些设备的访问通常限于具有适当权限的用户或组。
如果您无法访问这些设备，KiVy将指定这些设备记录错误或警告，，通常类似于：

Permission denied:'/dev/input/eventX'

为了使用这些设备，需要授予用户或组权限。这可以通过：

$ sudo adduser $USER input

注意，您需要退出，然后再次返回，以应用这些权限。

1.2.5 在安卓中安装

Kivy是一个Python框架，它安装在Android设备上，就像在桌面桌面机器上一样简单。然而，你可以编译Kivy应用为标准的安卓APK应用程序，运行起来和正常的Java 应用程序差不多。
我们提供了多种不同的工具帮助你在安卓的设备中运行，具体内容在安卓打包的章节中。这些包含了创建一个发布在安卓市场上的完整标准APK程序。也包含了不需要经过编译步骤，直接使用预先准备好的Kivy执行器执行Kivy apps。

1.2.6 在树莓派中安装

你可以手动安装Kivy。或者你可以下载和启动KivyPie在树莓派系统中。这些都在以下的内容中说明：

手动安装(在 Raspbian Jessie/Stretch)

sudo apt-get update 
sudo apt-get install libsdl2-dev libsdl2-image-dev libsdl2-mixer-dev libsdl2-ttf-dev \ 
pkg-config libgl1-mesa-dev libgles2-mesa-dev \ 
python-setuptools libgstreamer1.0-dev git-core \ 
gstreamer1.0-plugins-{bad,base,good,ugly} \ 
gstreamer1.0-{omx,alsa} python-dev libmtdev-dev \ 
xclip xsel

安装足够新版本的Cython

sudo pip install -U Cython==0.27.3

在你的系统中进行全局安装。

sudo pip install git+https://github.com/kivy/kivy.git@master

或者自己构建kivy（最好用于开发）：

git clone https://github.com/kivy/kivy 
cd kivy
make echo "export PYTHONPATH=$(pwd):\$PYTHONPATH" >> ~/.profile 
source ~/.profile

注意：在1.10.1之前的kivy版本中，Mesa库命名更改可能导致“Unable to ﬁnd any valuable Window provider”错误。如果你遇到此问题，请升级或查询问题5360。

手动安装(在Raspbian Wheezy)

为GStreamer增加APT源：

deb http://vontaene.de/raspbian-updates/ . main

为vontaene.de 增加APT key

gpg --recv-keys 0C667A3E 
gpg -a --export 0C667A3E | sudo apt-key add

安装依赖：

sudo apt-get update 
sudo apt-get install libsdl2-dev libsdl2-image-dev libsdl2-mixer-dev libsdl2-ttf-dev \ 
pkg-config libgl1-mesa-dev libgles2-mesa-dev \ 
python-setuptools libgstreamer1.0-dev git-core \ 
gstreamer1.0-plugins-{bad,base,good,ugly} \ 
gstreamer1.0-{omx,alsa} python-dev

从源代码中安装pip

wget https://raw.github.com/pypa/pip/master/contrib/get-pip.py 
sudo python get-pip.py

从源代码中安装Cython

sudo pip install Cython==0.26.1

在你的系统中全局安装Kivy：

sudo pip install git+https://github.com/kivy/kivy.git@master

或者自己构建Kivy(最好用于开发)：

git clone https://github.com/kivy/kivy 
cd kivy
make echo "export PYTHONPATH=$(pwd):\$PYTHONPATH" >> ~/.profile 
source ~/.profile

KivyPie 发行版
KiVyPie是一种紧凑且轻量级的基于Raspbian的发行版，它配备了Kivy并准备运行。这是应用上面描述的手动安装步骤的结果，还有一些额外的工具。你可以从http://kivypie.mitako.eu/kivy-download.html下载图像并在树莓派上引导它。

运行案例
切换到你的 kivy/examples文件夹，你可以有大量的案例进行测试：
你可以开始展示：

cd kivy/examples/demo/showcase 
python main.py

3d 猴子演示也是挺有趣的：

cd kivy/examples/3Drendering 
python main.p

更改默认屏幕以使用
运行Kivy的时候，你可以设置环境变量 KIVY_BCM_DISPMANX_ID 修改显示。例如，强制显示HDMI的时候，可以这样：

KIVY_BCM_DISPMANX_ID=2 python main.py

使用官方的树莓派触摸显示
如果你正在使用官方的树莓派触摸显示，你需要配置Kivy以它作为输入源。可以编辑文件 ~/.kivy/config.ini中的[input]字段。增加：

mouse = mouse 
mtdev_%(name)s = probesysfs,provider=mtdev 
hid_%(name)s = probesysfs,provider=hidinput

对于更多配置Kivy的内容，可以参考配置Kivy的章节。
我们使用GPIO/物理输入在PyCON2013期间制作了些游戏：一个按钮和一个斜坡。从HTTPS://GITHUBCOM/KIVY/PIKI获取。你将需要在代码中修改GPIO引脚。还可以通过视频，看看我们正在做什么：http://www.youtube.com/watch?v=NVM09gaX6pQ

1.3 开发版本

开发版本是用于开发者和测试者的。注意，运行开发版本的Kivy，你可能冒着一定的风险运行着潜在错误的代码。要使用开发版本，你首先需要安装依赖。此后，您需要以方便开发的方式在计算机上设置Kivy。更多内容，可以查看*贡献章节

1.3.1 安装依赖

要安装Kivy的依赖项，请为你的平台按照下面的指南。你可能还需要RST和lexing组件的这些包：

$ sudo pip install pygments docutils

Ubuntu
对于Ubuntu 12.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

对于Ubuntu 15.04或者比12.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

对于Ubutn16.04
···
$ sudo apt-get install python-setuptools python-pygame python-opengl \
python-gst0.10 python-enchant gstreamer0.10-plugins-good python-dev \
build-essential python-pip libgl1-mesa-dev libgles2-mesa-dev zlib1g-dev
···
对于Ubuntu 17.10

$ sudo apt-get install python-setuptools python-pygame python-opengl \ 
python-enchant python-dev build-essential python-pip libgl1-mesa-dev \ 
libgles2-mesa-dev zlib1g-dev

Kivy要求最新版本的Cython，最好使用最新支持的pypi

$ sudo pip install --upgrade Cython==0.27.3

OS X
在不使用brew的情况下，可以通过在终端中手动粘贴以下命令来安装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 Motorola 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)]

OSX HomeBrew
如果你更喜欢使用homebrew，可以这样安装依赖：

$ brew install sdl2 sdl2_image sdl2_ttf sdl2_mixer gstreamer

1.3.2 安装Kivy以便开发

现在你已经所有需要的依赖，是应该下载和编译开发版本的Kivy了:
···
cd kivy
···
编译：

$ python setup.py build_ext --inplace -f

如果你有make工具，你也可以这样，作用和上文提到的一样：

make

警告：默认情况下，Python 2.7到2.7.2版本使用的是GCC编译器，它是和更早XCode一起发布的。到了4.2版本XCode，XCode默认情况下只有CLang编译器。这样意味着，使用XCode4.2版本或者以上的版本的，你需要确认至少安装了Python2.7.3版本，更好的是使用最新版本（截止撰稿的的时候，最新版本是2.7.5）。

如果你想修改Kivy 代码本身，建立 PYTHONPATH 环境变量去指向你的克隆代码。这样的话，你就不用在每次很小的修改都要使用setup.py install进行安装。Python将会自动将你克隆的代码Import kivy。

或者，如果您不想对Kivy本身做任何更改，你也可以运行（如Admin，例如SUDO）：
···
$ python setup.py install
···
如果你想为Kivy的代码做一份贡献的话，可以参考贡献章节。

1.3.3 运行测试套件

为了帮助检测Kivy中的问题和行为变化，提供了一组unittests。一个好的做法是在你的Kyvy安装之后和每次你想修改kivy的时候运行它们。如果你认为在Kivy遇到了一些问题，也许测试会显示相关的内容。（如果不是，那也许是好的开始。）

Kivy测试是基于nosetest的。你可以从你的包管理器中安装它

$ pip install nose

运行测试套件：

$ make test

1.3.4 卸载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安装的，使用以下方法：

$ sudo apt-get remove --purge python-kivy

第一部分 用户指引

第一章 安装