Last updated
Last updated
Kivy 2.1.0 正式支持 Python 3.7-3.10版本。
安装 Kivy 的最简单方法是使用pip，它使用 （如果可用）安装 Kivy，否则使用源代码（见下文）。
Kivy为 Windows、macOS、Linux 和 RPi 上支持的 Python 版本提供了或者， 对于上面未列出的较新的 Python 版本，或者如果轮子不工作或无法正常运行，则需要
在安装 Kivy 之前，需要Python 和 pip 。然后，启动一个有 。在终端中，更新和其他安装依赖项，以便您拥有最新版本，如下所示（对于 linux 用户，您可能必须替换而不是并在虚拟环境之外的后续命令中添加标志）：pippython3python--user
为您的 Kivy 项目创建一个新的 。虚拟环境将防止可能与其他 Python 版本和包发生安装冲突。它是可选的，但强烈推荐：
kivy_venv创建在当前目录中命名的虚拟环境：
激活虚拟环境。每次启动新终端时，您都必须从当前目录执行此步骤 。这会设置环境，以便kivy_venv 使用新的 Python。
对于Windows 默认 CMD，在命令行中执行：
如果您在Windows上的 bash 终端中，请执行以下操作：
如果您使用的是linux或macOS，请执行以下操作：
您的终端现在应该在路径前加上类似 的内容(kivy_venv)，表示kivy_venv环境处于活动状态。如果它不这样说，则虚拟环境不活动，以下将不起作用。
最后，使用以下选项之一安装 Kivy：
预编译的轮子
最简单的是安装当前稳定版本的 PyPi wheels kivy，也可以选择kivy_examples 从 kivy-team 提供的 PyPi wheels 安装。简单地做：
这也会安装 Kivy 的最小依赖项。要额外安装 支持音频/视频的 Kivy ，请安装kivy[base,media]或kivy[full]. 请参阅Kivy 的依赖项以获取选择器列表。
来自源头
如果轮子不可用或不工作，可以通过一些额外的步骤从源代码安装 Kivy。从源代码安装意味着 Kivy 将从源代码安装并直接在您的系统上编译。
安装依赖项后，您现在可以将 Kivy 安装到虚拟环境中。
要安装稳定版的 Kivy，从终端执行：
要从master安装最新的尖端 Kivy ，请执行以下操作：
如果你想从不同的分支安装 Kivy，从你的分支存储库，或者从一个特定的提交（例如测试来自用户的 PR 的修复）替换 url 的相应组件。
例如从stable分支安装，url 变为 https://github.com/kivy/kivy/archive/stable.zip. 或者尝试特定的提交哈希，使用例如 https://github.com/kivy/kivy/archive/3d3e45dda146fef3f4758aea548da199e10eb382.zip
预发布、预编译的轮子
要安装 Kivy 的最后一个预发布版本的预编译轮，而不是当前的稳定版本，请将--pre标志添加到 pip：
它分两步完成，否则pip可能会忽略服务器上的轮子并从 PyPi 安装较旧的预发布版本。
开发安装
如果你想在安装 Kivy 之前编辑它，或者如果你想尝试修复一些 Kivy 问题并提交包含修复的拉取请求，你需要先下载 Kivy 源代码。以下步骤假定 git 已预安装并在终端中可用。
典型的过程是在本地克隆 Kivy：
现在，您可以使用 git 更改分支、编辑代码并提交 PR。每次更改 cython 文件时，请记住编译 Kivy，如下所示：
或者，如果使用 bash 或在 Linux 上，只需执行以下操作：
重新编译。
要运行测试套件，只需运行：
或者在 bash 或 Linux 中：
现在应该安装 Kivy。您应该能够在 Python 中运行，或者，如果您安装了 Kivy 示例，则可以运行演示。import kivy
在 Windows 上：
或者在 bash、Linux 和 macOS 中：
Kivy 示例目录的确切路径也存储在kivy.kivy_examples_dir.
下面的3d猴子演示kivy-examples/3Drendering/main.py也很好看。
pip如果您使用的是 Anaconda，请不要使用它来安装 kivy，除非您是从源代码安装的。
Kivy 为其核心提供者支持一个或多个后端。例如，它支持 Windows 图形后端的 glew、angle 和 sdl2。对于每个类别（窗口、图形、视频、音频等），必须至少安装一个后端才能使用该类别。
我们提供以下选择器：
base：Kivy 运行所需的最小典型依赖项，
不包括视频/音频。
media：仅 Kivy 所需的视频/音频依赖项
能够播放媒体。
full：Kivy 运行所需的所有典型依赖项，包括视频/音频和
大多数可选的依赖项。
dev：在开发模式下运行 Kivy 所需的所有附加依赖项
（即它不包括 base/media/full 依赖项）。例如，编译所需的任何标头，以及运行测试和创建文档所需的所有依赖项。
tuio：使 TUIO 工作所需的依赖项（主要是 oscpy）。
以下选择器在Kivy_deps命名空间下安装由 kivy 打包为 wheels 的后端。它们通常会发布和版本化以匹配特定的 Kivy 版本，因此我们提供选择器以方便安装（即，您现在可以为 Kivy 版本自动安装正确的 sdl2 而不是必须执行）。pip install kivy kivy_deps.sdl2==x.y.zpip install "kivy[sdl2]"
gstreamer：gstreamer 视频/音频后端（如果可用）
（目前仅适用于 Windows）
angle：备用 OpenGL 后端（如果可用）
（目前仅适用于 Windows）
sdl2：窗口/图像/音频后端，如果可用（目前仅在 Windows 上，
在 macOS 和 Linux 上，它已经包含在主 Kivy 轮中）。
glew：备用 OpenGL 后端，如果可用（目前仅在 Windows 上）
以下是kivy_deps依赖轮：
可以使用环境变量选择其中哪一个用于 OpenGL KIVY_GL_BACKEND：通过将其设置为glew （默认值）、angle_sdl2或sdl2。在这里，angle_sdl2是一个替代品 glew，但kivy_deps.sdl2也需要安装。
kivy_deps.sdl2适用于窗口/图像/音频和可选的 OpenGL。它仅在 Windows 上可用，并包含在其他平台的主要 Kivy wheel 中。
在这里我们解释如何安装 Python 包，如何使用命令行以及什么是轮子。
请注意，即使安装了 bash 终端，仍然可以使用默认的 Windows 命令行。
要临时将 Python 安装添加到 PATH，只需打开命令行，然后使用命令cd将当前目录更改为安装 python 的位置，例如.cd C:\Python37
如果您使用默认选项安装了 Python，则 Python 的路径将永久存在于您的 PATH 变量中。安装程序中有一个选项可让您执行此操作，默认情况下已启用。
但是，如果 Python 不在您的 PATH 中，请按照以下说明添加它：
从源代码安装时，某些软件包（例如 Kivy）需要额外的步骤，例如编译。
相反，wheels（带.whl扩展名的文件）是已经编译过的包的预构建分发版。这些轮子在安装时不需要额外的步骤。
直接下载安装wheel时，使用命令 ，例如：python -m pip install <wheel_file_name>
警告
使用最新的开发版本可能存在风险，您可能会在开发过程中遇到问题。如果您遇到任何错误，请报告它们。
对于树莓派， 在安装上面的 Kivy 之前，你必须额外安装
首先安装为每个平台列出的附加系统依赖项： 、、 、。
，这将只安装开发版本 。相反，您还可以通过以下方式从 Kivy 服务器安装最新的尖端 Nightly wheels ：
对于树莓派，记得 在安装上面的 Kivy 之前额外安装
这会在您当前的路径中创建一个名为 kivy 的文件夹。接下来，安装为每个操作系统列出的附加系统依赖项：、 、、 。
然后切换到 kivy 目录并将 Kivy 安装为 ：
如果你使用，你可以使用它的包管理器安装 Kivy ：
为了便于安装，我们提供了将安装选定后端的extras_require ，以确保 Kivy 安装正常工作。因此，可以更简单地安装 Kivy，例如``pip install “kivy[base,media,tuio]”` 。选择器的完整列表和它们安装的包列在 中。每个选择器中的确切包在未来可能会发生变化，但每个选择器的总体目标将保持如下所述。
（可选）
kivy_deps.gstreamer是一个可选的依赖项，只需要音频/视频支持。我们只在 Windows 上提供，其他平台需要单独安装。或者，改用 。
和/或
kivy_deps.glew并且kivy_deps.angle适用于。两者都可以安装，没问题。它仅适用于 Windows。在其他平台上，外部不需要它。
Kivy 是用 编写 的，因此，要使用 Kivy，您需要现有的安装。多个版本的 Python 可以并排安装，但 Kivy 需要作为包安装在每个要使用 Kivy 的 Python 版本下。
要安装 Python，请参阅每个平台的说明： 、、 、。
安装 Python 后，打开并通过键入确保 Python 可用。python --version
要执行此处给出的任何pip或wheel命令，您需要一个命令行（此处也称为console、terminal、或，其中最后两个指的是 Linux 风格的命令行）并且 Python 必须在 PATH。
Windows 上的默认命令行是 ，简称cmd。打开它的最快方法是按键盘上的Win+R 。在打开的窗口中，键入cmd然后按回车键。
我们推荐的 Windows 上的替代 Linux 样式命令行是 或。
使用说明
说明
（“python 安装包”）的python 包管理器安装 Kivy 等包。
（“Python 包索引”）上有轮子可用时，可以使用pip. 例如，当您在命令行中执行时，这将自动在 PyPI 上找到合适的轮子。python -m pip install kivy
每天我们都会创建 Kivy 当前开发版本的快照轮（'nightly wheel'）。的 master 分支中找到开发版本 。
与上一个稳定版本（我们在上一节中讨论过）相反，nightly wheels 包含对 Kivy 的所有最新更改，包括实验性修复。有关安装说明，请参阅。
Platform
Installation
Packaging
Windows
pip
PyInstaller
macOS
pip, Kivy.app
Kivy.app, PyInstaller
Linux
pip, PPA
—
RPi
pip
—
Android
python-for-android
python-for-android
iOS
kivy-ios
kivy-ios
Anaconda
conda
—
.svg)
