0

0

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

星降

星降

发布时间:2026-01-27 02:51:19

|

350人浏览过

|

来源于php中文网

原创

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

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

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

修改应用图标(AppIcon)

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

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

修改启动页(Splash Screen)

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

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

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

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

CreateWise AI
CreateWise AI

为播客创作者设计的AI创作工具,AI自动去口癖、提交亮点和生成Show notes、标题等

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

常见问题提醒

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

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

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

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1949

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2119

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

1171

2024.11.28

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

531

2023.06.20

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

576

2023.07.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

761

2023.08.03

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

6258

2023.08.17

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

492

2023.09.01

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.6万人学习

AngularJS教程
AngularJS教程

共24课时 | 4.2万人学习

CSS教程
CSS教程

共754课时 | 43万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号