如果您使用Anaconda，则可以使用以下命令安装kivy：

$ conda install kivy -c conda-forge

否则，请继续下面的步骤以在本机Python安装中安装Kivy。

前提条件¶

Kivy用Python编写， 因此，要使用Kivy，您需要现有的Python安装。可以并行安装多个版本的Python，但是需要在要使用Kivy的每个Python版本中安装Kivy。

从1.9.1开始，我们 为Kivy及其所有依赖项提供了二进制 *，可与现有的Python安装一起使用。请参阅安装kivy稳定版。

我们还提供使用Kivy master生成的每晚车轮 。请参阅每晚安装车轮。如果将kivy安装到其他位置而不是站点软件包，请参阅安装Kivy并在适当位置进行编辑。

从以前的版本更新Kivy ¶

从以前的Kivy版本进行更新时，必须首先更新所有Kivy依赖项。通常，只需在下面的pip install…命令中添加–upgrade就足以更新pip。

python -m pip uninstall -y kivy.deps.glew kivy.deps.gstreamer kivy.deps.sdl2 kivy.deps.angle

安装kivy稳定版¶

现在已经安装了python，打开命令行并通过键入来确保python可用。然后，执行以下操作 （可选）创建一个新的虚拟环境，并安装最新的稳定kivy版本（1.11.1）及其依赖项。python --version

1. 确保您拥有最新的pip，wheel和virtualenv：

   python -m pip install --upgrade pip wheel setuptools virtualenv
   

   （可选） 为您的Kivy项目创建一个新的虚拟环境。强烈推荐：

   1. 首先在当前目录中创建名为kivy_venv的环境：

      python -m virtualenv kivy_venv
      

   2. 激活虚拟环境。每次启动新终端时，都必须从当前目录执行此步骤 。在Windows CMD上执行以下操作：

      kivy_venv\Scripts\activate
      

      如果您在bash终端中，请执行以下操作：

      source kivy_venv/Scripts/activate
      

   您的终端现在应该在路径的开头加上（kivy_venv）之类的内容，表明kivy_venv环境处于活动状态。如果没有说明，则说明虚拟环境未处于活动状态。

2. 安装依赖项（如果不需要，请跳过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上发布的特定版本，如上。否则，将来更新时可能会得到不兼容的依赖关系。

3. 安装kivy：

   python -m pip install kivy==1.11.1
   

4. （可选）安装kivy示例：

   python -m pip install kivy_examples==1.11.1
   

   这些示例安装在安装python的根目录下的share目录中。

而已。如果您安装了kivy示例，现在应该可以在python中运行或运行一个基本示例：import kivy

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 -m pip install kivypython -m pip install wheel_file_name

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

每晚安装车轮¶

当前在Kivy 存储库的master分支上创建当前Kivy master的快照轮 。他们可以在这里找到 。要使用它们，而不是这样做，我们将如下安装这些*之一。python -m pip install kivy

• Python 3.5、32位
• Python 3.6、32位
• Python 3.7、32位

• Python 3.5、64位
• Python 3.6、64位
• Python 3.7、64位

1. 执行上述“安装”部分的步骤1和2。
2. 下载适合您系统的*。
3. 使用 文件名where进行安装。python -m pip install wheel-namewheel-name

Kivy示例由于其大小而与核心分开。可以使用以下单个*将示例分别安装在Python 2和3上：

• 猕猴桃的例子

Kivy的依赖¶

我们分别为Kivy及其依赖项提供*，因此仅需要安装所需的依赖项。依赖项作为kivy_deps的可选子包提供，例如kivy_deps.sdl2。

当前在Windows上，我们提供以下依赖项轮：

• 音频和视频的gstreamer
• GLEW和/或 角度（3.5只）的OpenGL
• sdl2用于控制和/或OpenGL。

通过将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的路径中 。cd C:\Python37

使用的开发Kivy ¶

要使用kivy 源代码编译和安装kivy 或将kivy与git而不是wheel一起使用，还有一些其他步骤：

1. 无论是python与Python\Scripts目录必须是在路径上。每次重新编译Kivy时，它们必须在路径上。

2. 确保您拥有最新的点子和*：

   python -m pip install --upgrade pip wheel setuptools
   

3. 获取编译器。对于Python <3.5，我们使用mingwpy如下。

   1. 创建 python\Lib\distutils\distutils.cfg文件并添加两行：

      [build]
      compiler = mingw32
      

   2. 使用以下方法安装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。

4. 设置环境变量。在Windows上执行以下操作：

   set USE_SDL2=1
   set USE_GSTREAMER=1
   

   在bash中执行：

   export USE_SDL2=1
   export USE_GSTREAMER=1
   

   每次重新编译kivy时都必须设置这些变量。

5. 安装其他依赖项及其开发版本（如果您不打算使用视频/音频，则可以跳过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
   

6. 如果您将kivy下载或克隆到其他位置，并且不想将其安装到站点程序包中，请阅读下一节。

7. 最后使用编译并安装kivy ，其中 可以是url（例如 kivy master）或kivy本地副本的完整路径。pip install filenamefilenamehttps://github.com/kivy/kivy/archive/master.zip

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 -m pip uninstall kivy_deps.sdl2 kivy_deps.glew kivy_deps.gstreamer
python -m pip uninstall kivy