Windows上安装-kivy

原文：https://kivy.org/doc/stable/installation/installation-windows.html#install-win-dist

如果您使用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并在适当位置进行编辑。

注意

对于Python <3.5，我们使用MinGW编译器。但是，对于Windows上的Python 3.5+，我们目前仅支持MSVC编译器，因为以下有关MinGW的Python 发行号4709。通常，在使用预编译车轮时，这应该没有区别。

从以前的版本更新Kivy ¶

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

警告

从Kivy 1.10.1或更低版本升级到1.11.0或更高版本时，必须在升级之前手动卸载所有kivy依赖项，因为它们无法正确更新。这是通过以下方式完成的：

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

假设以前已经安装了所有依赖项。有关更多详细信息，请参见Kivy的依赖项。

卸载后，继续下面的安装。

安装kivy稳定版¶

警告

Kivy 1.11.1是支持Python 2的最新版本。

现在已经安装了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。

注意

在Kivy 1.11.0我们转变了kivy从Windows的依赖 kivy.deps.xxx命名空间下存储kivy / DEPS / XXX至 kivy_deps.xxx命名空间下存储kivy_deps / XXX。Pip有时无法区分这两种格式，因此在从较旧的Kivy升级时，请遵循从以前的版本更新Kivy中的说明。有关 更多详细信息，请参见此处。

当前在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

编译Kivy ¶

1. 开始安装从GitHub复制或下载并提取的Kivy。您应该位于提取kivy的根目录中，其中包含 setup.py文件：

   python -m pip install .
   

如果编译成功而没有任何错误，那么Kivy应该很好。您可以通过运行一个基本示例进行测试：

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，则可以将所有*.py文件与python 关联（如果尚未关联），然后双击运行它。或者，如果您希望每次都可以选择，则只能执行一次：

1. 右键单击要启动的应用程序的Python文件（.py文件扩展名）
2. 在出现的上下文菜单中，选择“ 打开方式”
3. 浏览您的硬盘驱动器，找到python.exe您要使用的文件。选择它。
4. 如果不想每次双击.py文件时都重复此过程，请选择“始终使用...打开文件”。
5. 大功告成 打开文件。

发送方法¶

您可以使用“发送至”菜单使用我们的Python启动.py文件：

1. 浏览到python.exe要使用的文件。右键单击并复制它。
2. 打开Windows资源管理器（Windows 8中为文件资源管理器），然后转到地址“ shell：sendto”。您应该获得特殊的Windows目录SendTo
3. 将先前复制的python.exe文件粘贴为快捷方式。
4. 将其重命名为python <python-version>。例如python27-x64

现在，您可以通过右键单击.py文件->“发送到”->“ python <python-version>” 来执行您的应用程序。

卸载Kivy ¶

要卸载Kivy，请使用pip删除已安装的软件包。例如，如果您按照上面的说明进行了设置，请执行以下操作：

python -m pip uninstall kivy_deps.sdl2 kivy_deps.glew kivy_deps.gstreamer
python -m pip uninstall kivy