跳到主要内容

Flet为FastAPI提供支持

· 阅读需 3 分钟
Feodor Fitsner
Flet 创始人和开发者

我们刚刚发布了支持 FastAPI 的 Flet 0.10.0!

FastAPI 配合 Uvicorn、Hypercorn、Gunicorn 或其他网络服务器,可以取代内置的 Flet 网络服务器(Fletd),以可靠地运行生产环境中的 Flet 工作负载。

另一方面,经验丰富的 FastAPI 开发者可以使用 Flet,轻松地为现有或新的 FastAPI 服务添加互动的实时仪表盘和管理 UI。

一个简单的应用示例

import flet as ft
import flet_fastapi

async def main(page: ft.Page):
await page.add_async(
ft.Text("Hello, Flet!")
)

app = flet_fastapi.app(main)

这是一个简单的应用程序,只是在网页上输出“Hello, Flet!”。

要运行该应用程序,请安装 Flet for FastAPI 和 Uvicorn:

pip install flet-fastapi
pip install uvicorn

将上述代码保存为 hello.py,然后启动 Uvicorn:

uvicorn hello:app

打开浏览器并导航到 http://127.0.0.1:8000 查看运行中的应用程序。

警告

Flet 应用程序必须是 异步的 才能与 FastAPI WebSocket 处理程序一起工作。

特性和优势

  • 单域名下的多个 Flet 应用程序 - 映射到根路径和/或子路径。
  • 简单的单行映射单个端点配置
  • 围绕 FastAPI WebSocket 连接的轻量级异步包装器,以提高并发性。
  • 提供包含用户资源和应用程序元信息自定义的 Flet 静态文件。
  • FilePicker 控件的上传处理程序。
  • 处理 OAuth 回调进行身份验证流程。

查看 指南 以获取有关 Flet 与 FastAPI 的完整信息。

通过加入 Flet Discord 服务器 或在 Flet GitHub 讨论 创建新主题,让我们知道您的想法。

用于 Android 的 Flet

· 阅读需 3 分钟
Feodor Fitsner
Flet创始人兼开发者

🤖 现已支持Android平台!

通过 Flet Android 应用,你可以在 Android 设备上查看 Flet Python 应用的外观和行为,而应用本身仍在你的电脑上运行。

与 iOS 类似,Flet for Android 是一个完全用 Python 编写的 Flutter 应用,使用了两个开源软件包:serious_pythonflet。生成的应用包技术上符合 Google Play 的要求,因此你可以用纯 Python 发布优秀的 Android 应用。

按照本指南 开始在 Android 上测试你的 Flet 应用。探索应用、浏览画廊、尝试示例项目和应用设置。

常见问题

如何将我的 Flet 应用打包到 Google Play?

我们将提供一个启动 Flutter 应用的项目模板和指南,介绍如何将 Flutter、serious_python 软件包和你的 Python 应用结合在一起,创建一个独立的 Android 应用并发布到 Google Play。

查看 serious_python 的自述文件,了解如何创建一个 Flutter 启动并将你的 Python 应用打包在其中。使用 flet_example 项目作为起点。

你们会提供 Windows、macOS 和 Linux 的打包吗?

会的!目前,Flet 桌面应用使用 flet pack 命令和 PyInstaller 打包。生成的应用包增加了性能和大小的开销,并且难以定制,因此我们将用原生的 Flutter 打包替代它。

Flet v0.9.0 发行说明

要在 Android 上进行测试,你需要将 Flet 安装升级到 v0.9.0。

为了支持 Android,Flet CLI 进行了一些更改。如果你发现了什么异常情况,请告诉我们。

祝您使用愉快!

用于 iOS 的 Flet

· 阅读需 3 分钟
Feodor Fitsner
Flet 创始人和开发者

🎉 哇哦,Flet 应用现已上架 App Store!🎉

有了 Flet iOS 应用,您可以在 iPhone 或 iPad 上查看 Flet Python 应用的外观和行为,而应用程序本身正在您的计算机上运行。

但这不仅仅是测试手机上的 Flet 应用程序!Flet 移动应用程序本身是用 Python 编写的,其发布到 App Store 是整个 Flet 项目中的一个重要里程碑。这是一个成功的证明,表明您可以仅使用 Python 创建出色的移动应用程序,并将其打包以便在 App Store 中被接受!

按照本指南 开始在 iPhone 或 iPad 上测试您的 Flet 应用程序。探索应用程序、浏览图库、尝试示例项目和应用程序设置。

我要感谢 Kivy 项目 制作了一个 iOS 工具链,我们使用它来编译适用于 iOS 设备的 Python 解释器和依赖项。我们发布了 serious_python 包,用于将 Python 运行时添加到任何 Flutter 应用程序中。

常见问题解答

何时支持 Android?

很快。它现在是我们的首要任务,我们已经开始研究它。

如何将我的 Flet 应用程序打包到 App Store?

我们将提供一个项目模板,用于引导 Flutter 应用程序,并提供指南,说明如何将 Flutter、serious_python 包和您的 Python 应用程序结合在一起,创建一个独立的 iOS 应用程序并将其发布到 App Store。

今年晚些时候,我们将创建一个 CI 管道以完全自动化该过程。

请查看 serious_python 的自述文件,了解如何创建 Flutter 引导程序并打包您的 Python 应用程序以在其中运行。使用 flet_example 项目作为起点。

Flet v0.8.0 发行说明

要在 iOS 上进行测试,您需要将 Flet 安装升级到 v0.8.0。

在 v0.8.0 中 进行了很多更改,并且有一些重大更改。在您升级到 0.8.0 时请耐心等待,并让我们知道您是否遇到任何问题。

尽情享受吧!

滚动控件和主题化

· 阅读需 7 分钟
Feodor Fitsner
Flet创始人兼开发者

Flet 0.7.1 允许开发人员从 PageViewColumnRowListViewGridView 控件中更改滚动位置接收滚动通知

本次发布还引入了主题改进:

控制滚动位置

可滚动控件 (Page, View, Column, Row, ListViewGridView) 引入了 scroll_to() 方法,以将其滚动位置更改为绝对 offset,相对 delta 或跳转到指定 key 的控件。

通过移动到 key 指定的控件,可以模拟页面书签之间的导航,类似于使用 # 的 HTML href链接:

查看上述示例的源代码

有关控制滚动位置的更多详细信息,请参见 Column.scroll_to

接收滚动通知

所有可滚动的控件现在都提供了 on_scroll 事件处理程序,该处理程序在滚动位置发生变化时触发。通过事件对象的属性,您可以确定滚动操作是否已开始、已结束、改变了方向或滚动位置是否超出了滚动范围(滚动超出)。您还可以获取当前滚动位置的更新以及滚动区域的尺寸,例如:

import flet as ft

def main(page: ft.Page):
def on_column_scroll(e: ft.OnScrollEvent):
print(
f"Type: {e.event_type}, pixels: {e.pixels}, min_scroll_extent: {e.min_scroll_extent}, max_scroll_extent: {e.max_scroll_extent}"
)

cl = ft.Column(
spacing=10,
height=200,
width=200,
scroll=ft.ScrollMode.ALWAYS,
on_scroll=on_column_scroll,
)
for i in range(0, 50):
cl.controls.append(ft.Text(f"Text line {i}", key=str(i)))

page.add(
ft.Container(cl, border=ft.border.all(1)),
)

ft.app(main)

有关滚动通知的更多详细信息,请参见 Column.on_scroll

查看无限滚动示例

颜色方案定制

在此之前,控制应用程序的颜色方案的唯一方法是在创建新的 ft.Theme 对象时指定 color_scheme_seed

本版本允许您根据 Material 设计规范 和 Flet 的各种控件使用的 30 种颜色进行精细调整。

您甚至可以使用 Material Theme Builder 并将导出的颜色调色板应用到您的应用程序,例如:

page.theme = ft.Theme(
color_scheme=ft.ColorScheme(
primary=ft.colors.GREEN,
primary_container=ft.colors.GREEN_200
# ...
),
)

有关更多详细信息,请参见 ColorScheme

嵌套主题

此版本的另一个很棒的功能是嵌套主题!

您可以让应用程序的某个部分使用不同的主题,或者为特定控件覆盖一些主题样式。

还记得 page 对象有 themetheme_mode 属性吗?现在 Container 也有 themetheme_mode 属性!

Container.theme 接受与页面相同的 ft.Theme 对象。在容器中指定 theme_mode 意味着您不想继承父主题,而是希望为容器内的所有控件提供一个全新的、独特的方案。但是,如果容器没有设置 theme_mode 属性,那么其 theme 属性中的样式将覆盖父级继承主题中的样式:

import flet as ft

def main(page: ft.Page):
# 系统(默认)模式的黄色页面主题
page.theme = ft.Theme(
color_scheme_seed=ft.colors.YELLOW,
)

page.add(
# 页面主题
ft.Container(
content=ft.ElevatedButton("Page theme button"),
bgcolor=ft.colors.SURFACE_VARIANT,
padding=20,
width=300,
),

# 继承的主题,覆盖了主要颜色
ft.Container(
theme=ft.Theme(color_scheme=ft.ColorScheme(primary=ft.colors.PINK)),
content=ft.ElevatedButton("Inherited theme button"),
bgcolor=ft.colors.SURFACE_VARIANT,
padding=20,
width=300,
),

# 独特的总是深色主题
ft.Container(
theme=ft.Theme(color_scheme_seed=ft.colors.INDIGO),
theme_mode=ft.ThemeMode.DARK,
content=ft.ElevatedButton("Unique theme button"),
bgcolor=ft.colors.SURFACE_VARIANT,
padding=20,
width=300,
),
)

ft.app(main)

滚动条主题

现在您可以自定义应用程序中滚动条的外观和填充(或使用嵌套主题的特定滚动条)。

可以通过 page.theme.scrollbar_theme 属性来完成,例如:

page.theme = ft.Theme(
scrollbar_theme=ft.ScrollbarTheme(
track_color={
ft.MaterialState.HOVERED: ft.colors.AMBER,
ft.MaterialState.DEFAULT: ft.colors.TRANSPARENT,
},
track_visibility=True,
track_border_color=ft.colors.BLUE,
thumb_visibility=True,
thumb_color={
ft.MaterialState.HOVERED: ft.colors.RED,
ft.MaterialState.DEFAULT: ft.colors.GREY_300,
},
thickness=30,
radius=15,
main_axis_margin=5,
cross_axis_margin=10,
)
)

文本主题

Material 3 设计定义了5 组文本样式,每组有 3 种大小:"Display"、"Headline"、"Title"、"Label" 和 "Body",这些样式用于 Flet 控件。现在您可以使用 page.theme.text_theme 自定义每种样式,例如:

import flet as ft

def main(page: ft.Page):
page.theme = ft.Theme(
text_theme=ft.TextTheme(body_medium=ft.TextStyle(color=ft.colors.GREEN))
)

page.add(ft.Text("Hello, green world!"))

ft.app(main)

显然,Body MediumText 控件使用的默认样式。

有关更多详细信息,请参见 TextTheme

标签主题

现在,您可以控制 Tabs 控件的外观和感觉。在此版本中,Tabs 增加了许多新属性,并且有一个新的 page.theme.tabs_theme 属性来设置应用程序中所有标签的样式:

page.theme = ft.Theme(
tabs_theme=ft.TabsTheme(
divider_color=ft.colors.BLUE,
indicator_color=ft.colors.RED,
indicator_tab_size=True,
label_color=ft.colors.GREEN,
unselected_label_color=ft.colors.AMBER,
overlay_color={
ft.MaterialState.FOCUSED: ft.colors.with_opacity(0.2, ft.colors.GREEN),
ft.MaterialState.DEFAULT: ft.colors.with_opacity(0.2, ft.colors.PINK),
},
)
)

有关更多详细信息,请参见 TabsTheme

其他变化

Flutter 3.10

此 Flet 版本基于 Flutter 3.10,带来了新功能、性能和大小优化。因此,大多数 Flet 依赖项也提升了它们的版本,因此如果您发现任何问题,请告诉我们。

Web 应用中的彩色表情符号

Web 应用中的彩色表情符号支持回来了!在 Flutter 3.7 中,由于其字体大小(8 MB!),"CanvasKit" 渲染器(Flet 中的默认渲染器)中禁用了彩色表情符号,并在 Flutter 3.10 中以可选方式返回。您可以在 server-driven 应用程序中通过 use_color_emoji 参数启用彩色表情符号:

ft.app(main, use_color_emoji=True)

并且在将应用程序发布为静态网站时使用 --use-color-emoji 开关

今天就这些!

升级到最新版本的 Flet 模块(pip install flet --upgrade)并告诉我们您的想法!

画布

· 阅读需 4 分钟
Feodor Fitsner
Flet 创始人兼开发者

释放你的内心艺术家 🧑‍🎨,通过刚刚在 Flet 0.6.0 中发布的全新 Canvas 控件来提升你的 Flet 创意!

Canvas 允许你使用一组基本几何图形("形状")(如线条、圆、弧线、路径和文本)绘制任意图形。我敢打赌,你甚至可以使用 Canvas 控件实现你自己的图表

将 Canvas 与 GestureDetector 结合,你可以获得一个自由绘画应用 - Flet Brush 😀!

示例源码

Canvas 控件位于 flet.canvas 包中。你需要另一个导入才能使用它:

import flet.canvas as cv

以下是一个使用填充和描边 Paint 绘制笑脸的简单程序,使用了 CircleArc 形状:

import math
import flet as ft
import flet.canvas as cv

def main(page: ft.Page):
stroke_paint = paint = ft.Paint(stroke_width=2, style=ft.PaintingStyle.STROKE)
fill_paint = paint = ft.Paint(style=ft.PaintingStyle.FILL)
cp = cv.Canvas(
[
cv.Circle(100, 100, 50, stroke_paint),
cv.Circle(80, 90, 10, stroke_paint),
cv.Circle(84, 87, 5, fill_paint),
cv.Circle(120, 90, 10, stroke_paint),
cv.Circle(124, 87, 5, fill_paint),
cv.Arc(70, 95, 60, 40, 0, math.pi, paint=stroke_paint),
],
width=float("inf"),
expand=True,
)

page.add(cp)

ft.app(main)

文档中了解更多关于 Canvas 的信息,并探索 Canvas 示例

其他更改

富文本支持

Canvas 上绘制文本的工作中,作为对该版本的奖励,我们实现了一个新的 TextSpan 控件,现在可以与 Text.spans 一起使用以输出富文本。

查看富文本示例:

按钮的 url 属性

如果你需要通过点击按钮或任何其他带有 on_click 事件的控件打开一个 URL,你可以直接在 url 中提供该 URL,而无需在代码中使用 page.launch_url() 方法。

不再需要这样:

ft.ElevatedButton("Go to Google", on_click=lambda e: e.page.launch_url("https://google.com"))

只需要这样:

ft.ElevatedButton("前往谷歌", url="https://www.google.com")

新的 url 属性还解决了 Safari 上阻止弹窗的问题

Markdown 中的自动跟随链接

作为 url 属性的延续,Markdown 控件现在可以启用文档中的 URL 自动跟随:

import flet as ft

md = """
[Go to Google](https://www.google.com)
"""

def main(page: ft.Page):
page.add(
ft.Markdown(
md,
extension_set=ft.MarkdownExtensionSet.GITHUB_WEB,
auto_follow_links=True,
)
)

ft.app(main)

更好的 Web 支持

在这个版本中,我们还对Web支持进行了一些改进,例如在page.client_idpage.client_user_agent中捕获用户信息,同时修复了与路由相关的严重的#1333#1289错误。

今天就介绍到这里!

将Flet模块升级到最新版本(pip install flet --upgrade),试用一下画布和富文本,并让我们知道你的想法!