MAUI怎么修改应用图标和启动页 MAUI AppIcon设置方法

在 .NET MAUI 中修改应用图标和启动页只需在 .csproj 文件中配置 和 ,仅识别第一个匹配项,支持 SVG/PNG,需遵守命名规范并执行 Clean + Rebuild。

maui怎么修改应用图标和启动页 maui appicon设置方法

在 .NET MAUI 中修改应用图标(AppIcon)和启动页(Splash Screen),核心操作都在项目文件(.csproj)里完成,不需要为每个平台单独准备多套图片——MAUI 会自动缩放适配。关键点是:只认第一个 ,SVG 推荐但 PNG 也完全可用,命名要合规,启动页用 单独配置。

修改应用图标(AppIcon)

MAUI 应用图标由项目文件中的 项控制,系统只处理第一个定义,其余会被忽略。你只需替换文件并更新路径即可:

  • 把新图标(推荐 PNG,也可用 SVG)放进 Resources/AppIcon/ 文件夹,文件名必须全小写、只含字母/数字/下划线,比如 myappicon.png
  • 右键项目 → “编辑项目文件”,找到或添加 节点,填入路径:
  • 如需前景+背景分层(例如浅色图标配深色底),可加 ForegroundFileColor
  • 若想按平台差异化设置(比如 Windows 用另一张图),可用条件判断,但注意仍只取第一个匹配项:

修改启动页(Splash Screen)

启动页是 App 启动瞬间显示的静态画面,由 控制,同样支持 SVG 或 PNG,MAUI 会自动生成各平台所需尺寸:

  • 把启动图放进 Resources/Splash/,比如 splash.png
  • 在 .csproj 中添加或修改节点:
  • BaseSize 是原始画布尺寸(单位 px),用于缩放计算;Color 是背景色,当图片透明时可见
  • 不支持动画或 HTML 内容,纯静态图像;如需更定制化加载界面(比如带文字或进度条),得在 Blazor 或 Shell 初始化阶段手动实现

顺便改掉应用名称(Display Name)

应用在手机桌面显示的名字,不是项目名,而是用户看到的“App 名称”,修改位置有两个:

可赞AI

可赞AI

文字一秒可视化,免费AI办公神器

下载

  • 主项目文件中设置 ,影响所有平台:
    我的阅读器
  • Android 平台还可额外在 Platforms/Android/AndroidManifest.xml 中确认 android:label 是否同步(一般会自动继承,除非手动覆盖)
  • iOS 和 Windows 需分别检查 Platforms/iOS/Info.plistPlatforms/Windows/Package.appxmanifest 中对应字段

常见问题提醒

这些细节容易踩坑,改完记得 Clean + Rebuild:

  • 图标文件名不合法(含大写字母、短横线、中文)会导致构建失败或图标不显示
  • 没删旧的 行,新加的可能被跳过——务必确保只有一个生效项
  • SVG 图标若含外部引用、JS 或复杂滤镜,MAUI 转换时可能出错,建议用简化版 SVG 或直接上 PNG
  • 真机调试时图标未更新?先卸载旧 App,再部署,避免系统缓存旧图标资源

基本上就这些。改图标和启动页不复杂,但容易忽略命名规则和“只取第一个”的限制。

https://www.php.cn/faq/2034695.html

发表回复

Your email address will not be published. Required fields are marked *