跳到主要内容

入门

在创建你的第一个 Flet 应用程序之前，你需要设置开发环境，这需要 Python 3.9 或更高版本以及“flet”包。

我们建议在虚拟环境中安装 Flet，这可以通过多种不同的方式完成。

先决条件​

macOS​

Flet 支持 macOS 11（Big Sur）或更高版本。

Windows​

Flet 支持 64 位版本的 Microsoft Windows 10 或更高版本。

Linux​

Flet 支持 Debian Linux 11 或更高版本以及 Ubuntu Linux 20.04 LTS 或更高版本。

在 Linux 上开发和运行 Flet 应用程序时，还有其他先决条件。

适用于 Linux 的 Windows 子系统 (WSL)

Flet 应用程序可以在 WSL 2（适用于 Linux 的 Windows 子系统 2）上运行。如果你遇到“无法打开显示”错误，请按照本指南进行故障排除。

音频支持​

如果你收到“在加载共享库时出错：libgstapp-1.0.so.0”，则表示你的 WSL 环境中未安装 GStreamer。

要安装 GStreamer，请运行以下命令：

apt install -y libgstreamer1.0-0 gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-libav gstreamer1.0-tools

视频支持​

Flet 在 WSL 上的视频支持需要“libmpv”库。

如果你收到“在加载共享库时出错：libmpv.so.1：无法打开共享对象文件：没有这样的文件或目录”，则表示该库未安装。

要安装“libmpv”，请运行以下命令：

sudo apt update
sudo apt install libmpv-dev libmpv2
sudo ln -s /usr/lib/x86_64-linux-gnu/libmpv.so /usr/lib/libmpv.so.1

虚拟环境​

你可以通过在终端中运行以下命令来创建虚拟环境：

mkdir first-flet-app
cd first-flet-app
python3 -m venv.venv
source.venv/bin/activate

一旦你激活了虚拟环境，你会看到你的命令提示符现在显示“(.venv)”前缀。

现在你可以在“.venv”虚拟环境中安装最新版本的 Flet：

pip install 'flet[all]'

要检查安装的 Flet 版本：

flet --version

你可以在这里阅读更多关于 Python“venv”模块的信息。

现在你可以准备创建你的第一个 Flet 应用程序。

Poetry​

为你的 Flet 项目设置虚拟环境的另一种方法是使用Poetry。

Poetry 2.0

Flet 文档中的所有 Poetry 示例都是针对 Poetry 2.0 的，因为它在“pyproject.toml”中支持标准的“[project]”部分。

一旦你安装了 Poetry（请参考安装说明），在终端中运行以下命令：

mkdir my-app
cd my-app
poetry init --dev-dependency='flet[all]' --python='>=3.9' --no-interaction

此命令将在“my-app”目录中创建“pyproject.toml”。

运行以下命令安装 Flet 和其他依赖项：

poetry install --no-root

确保 Flet CLI 已安装并且可以运行：

poetry run flet --version

现在你可以准备创建你的第一个 Flet 应用程序。

备注

当使用 Poetry创建和运行Flet 应用程序时，你需要在每个命令前使用“poetry run”！

uv​

“uv”是“一个用 Rust 编写的极其快速的 Python 包和项目管理器”。

安装“uv”，并在终端中运行以下命令：

mkdir my-app
cd my-app
uv init

此命令将在“my-app”目录中创建“pyproject.toml”。

运行以下命令添加 Flet 作为依赖项：

uv add 'flet[all]' --dev

确保 Flet CLI 已安装并且可以运行：

uv run flet --version

现在你可以准备创建你的第一个 Flet 应用程序。

备注

当使用 uv创建和运行Flet 应用程序时，你需要在每个命令前使用“uv run”！