17370845950

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

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

修改应用图标（AppIcon）

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

• 把新图标（推荐 PNG，也可用

  

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

修改启动页（Splash Screen）

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

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

顺便改掉应用名称（Display Name）

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

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

常见问题提醒

这些细节容易踩坑，改完记得 Clean + Rebuild：

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

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