在Flet的 Android构建中，自定义的启动画面和图标未显示

人工智能 2026-07-09

我正在用Python的 Flet 框架开发一个Android应用。
我想自定义启动屏的logo和应用图标，但打包成APK后，启动屏和图标仍然显示默认的Flet标志。

我试过让AI辅助调试这个问题，但到目前为止给出的建议都没起作用。
我担心在 .png 的格式上是否有特定要求，或者在Flet构建过程中对资源的支持是否存在某些限制。

我的环境：

框架： Flet (Python)
目标： Android (APK)
构建工具： flet build apk

我尝试过：

将标志放在assets文件夹中。
检查我的代码/配置中的文件路径是否正确。
验证 .png 文件是否未损坏。

我的问题：在为Android构建Flet应用时，指定自定义启动屏标志和应用图标的正确方式是什么？是否有需要遵循的特定文件命名约定或目录结构？

解决方案

我今天正好遇到同样的问题，研究后做了不少修复。你的pyproject.toml应该包含以下内容：
此外，图片需要按相应的命名。对于启动屏和图标，存在隐藏的Flet默认设置，请在出现时把它们删除。所有图片的命名应与下方完全一致。

希望对你有帮助！

[tool.flet.icons]
android = "assets/icon.png" #should be structured exactly like these
splash_android = "assets/splash_android.png" #rename your splash image accordingly
splash_android_dark = "assets/splash_android_dark.png"

[tool.flet.splash]
color = "#ffffff"           # change to match your app background color
dark_color = "#ffffff"      # change to match your dark mode background color
android_gravity = "fill"  # position of splash image: center, fill, etc.
hide_animation = true       # hides the Flet spinner/logo during Python startup

Android