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

来源:这里教程网 时间:2026-02-21 17:39:49 作者:

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

<mauiicon></mauiicon>
,SVG 推荐但 PNG 也完全可用,命名要合规,启动页用
<mauisplashscreen></mauisplashscreen>
单独配置。

修改应用图标(AppIcon)

MAUI 应用图标由项目文件中的

<mauiicon></mauiicon>
项控制,系统只处理第一个定义,其余会被忽略。你只需替换文件并更新路径即可:

把新图标(推荐 PNG,也可用 SVG)放进
Resources\AppIcon\
文件夹,文件名必须全小写、只含字母/数字/下划线,比如
myappicon.png
右键项目 → “编辑项目文件”,找到或添加
<mauiicon></mauiicon>
节点,填入路径:
<mauiicon include="Resources\AppIcon\myappicon.png"></mauiicon>
如需前景+背景分层(例如浅色图标配深色底),可加
ForegroundFile
Color

<mauiicon include="Resources\AppIcon\bg.svg" foregroundfile="Resources\AppIcon\fg.svg" color="#2E5BFF"></mauiicon>
若想按平台差异化设置(比如 Windows 用另一张图),可用条件判断,但注意仍只取第一个匹配项:
<mauiicon condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'windows'" include="Resources\AppIcon\winicon.png"></mauiicon>

修改启动页(Splash Screen)

启动页是 App 启动瞬间显示的静态画面,由

<mauisplashscreen></mauisplashscreen>
控制,同样支持 SVG 或 PNG,MAUI 会自动生成各平台所需尺寸:

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

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

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

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

常见问题提醒

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

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

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

相关推荐