Kivy 简明教程

Kivy - Installation

若要构建 Kivy 应用，您需要在电脑上安装 Python。Kivy 2.2.0（最新稳定版本）正式支持 Python 3.7 至 3.11。如果尚未安装 Python，请从 Python 官方网站下载最新 Python 版本的安装程序，以供您的操作系统和架构使用 - https://www.python.org/downloads/

Python Virtual Environment

Python 建议使用虚拟环境，以避免与其他 Python 版本和软件包发生冲突。

虚拟环境使我们能够为特定项目创建一个 Python 的隔离工作副本，而不会影响外部设置。我们将使用 Python 标准库中的“venv”模块来创建虚拟环境。默认情况下，PIP 包含在 Python 3.4 或更高版本中。

Creating a Virtual Environment

在 Windows 中使用以下命令创建虚拟环境 -

C:\users\user\>python -m venv c:\kivyenv

在 Ubuntu Linux 中，在创建虚拟环境之前，请根据需要更新 APT 存储库并安装“venv”。

mvl@GNVBGL3:~ $ sudo apt update && sudo apt upgrade -y
mvl@GNVBGL3:~ $ sudo apt install python3-venv

然后，使用以下命令创建虚拟环境 -

mvl@GNVBGL3:~ $ sudo python3 -m venv kivyenv

Activating a Virtual Environment

您需要激活虚拟环境。在 Windows 上，使用以下命令 -

C:\>cd kivyenv
C:\kivyenv>scripts\activate
(kivyenv) C:\kivyenv>

在 Ubuntu Linux 上，使用以下命令激活虚拟环境 -

mvl@GNVBGL3:~$ cd kivyenv
mvl@GNVBGL3:~/kivyenv$ source bin/activate
(myenv) mvl@GNVBGL3:~/kivyenv$

Installing Kivy Using the pip Utility

安装任何 Python 软件包的最简单方法是使用“pip”实用程序。Python 3 安装附带“pip”安装程序。激活虚拟环境后，从 Windows 中的 CMD 终端或 Linux 终端中使用以下命令 -

pip3 install "kivy[base]" kivy_examples

这将安装 Kivy 包，且依赖项最少。“kivy_examples”软件包是可选的。除了“base”之外，“full”选项启用音频/视频支持。

Installing the Dependency Libraries for Kivy

SDL2（Simple DirectMedia Layer）是 Kivy 的主要依赖项。在 Windows 操作系统上，当您使用“pip”实用程序时，SDL2 会自动安装。但是，对于 Linux 和 macOS，您需要单独安装 SDL2。

在 macOS 上，您可以通过在终端中运行以下命令，使用 Homebrew 安装 SDL2 -

brew install sdl2

如果在 Linux 操作系统上，请使用相应的软件包管理器安装 SDL2。例如，在 Ubuntu Linux 机器上使用以下命令即可完成此操作 -

sudo apt-get install libsdl2-dev

此外，您可能需要安装其他依赖项，如“gstreamer”和“Pillow”，以获得 Kivy 的某些特定功能。

Verifying the Kivy Installation

要验证 Kivy 是否已正确安装，请启动 Python 交互式 shell 并导入该软件包。控制台显示 Kivy 依赖项也已导入。

>>> import kivy
[INFO] [Logger] Record log in C:\Users\mlath\.kivy\logs\kivy_23-05-26_0.txt
[INFO] [deps] Successfully imported "kivy_deps.gstreamer" 0.3.3
[INFO] [deps] Successfully imported "kivy_deps.angle" 0.3.3
[INFO] [deps] Successfully imported "kivy_deps.glew" 0.3.1
[INFO] [deps] Successfully imported "kivy_deps.sdl2" 0.6.0
[INFO] [Kivy] v2.2.0
[INFO] [Kivy] Installed at "c:\kivyenv\Lib\site-packages\kivy\__init__.py"
[INFO] [Python] v3.11.2 (tags/v3.11.2:878ead1, Feb 7 2023, 16:38:35) [MSC v.1934 64 bit (AMD64)]
[INFO] [Python] Interpreter at "c:\kivyenv\Scripts\python.exe"
[INFO] [Logger] Purge log fired. Processing...
[INFO] [Logger] Purge finished!

您还可以使用“pip freeze”命令获取已安装的所有软件包的列表 -

(kivyenv) C:\kivyenv>pip3 freeze
certifi==2023.5.7
charset-normalizer==3.1.0
docutils==0.20.1
idna==3.4
Kivy==2.2.0
kivy-deps.angle==0.3.3
kivy-deps.glew==0.3.1
kivy-deps.gstreamer==0.3.3
kivy-deps.sdl2==0.6.0
Kivy-examples==2.2.0
Kivy-Garden==0.1.5
Pillow==9.5.0
Pygments==2.15.1
pypiwin32==223
pywin32==306
requests==2.31.0
urllib3==2.0.2