Maui Blazor(Windows)配置appxmanifest图标触发构建错误求助

问题原因 #

你遇到的错误确实是VS自动生成的图标文件名里的连字符“-”违反了UWP/MAUI的文件命名规范——要求文件名必须小写、以字母开头结尾、仅包含字母数字或下划线。

解决方案 #

方案1：手动指定符合规范的图标文件

• 用图像编辑工具（比如VS自带的“打开并编辑”功能、第三方图标生成器）生成所有需要的尺寸（16、24、32、48等）和无镀层（unplated）样式的图标
• 给图标命名时替换所有连字符为下划线，比如store_logo_unplated_targetsize_16.png，严格遵守命名规则
• 打开Package.appxmanifest的Visual Assets页面，逐个修改每个目标尺寸和样式的图标路径，指向你手动命名的文件，关闭VS的自动生成逻辑

方案2：修改项目配置让VS自动生成合规文件名

• 右键项目→编辑项目文件（打开.csproj）
• 在<PropertyGroup>节点中添加以下配置：

  <AppxAssetNamingScheme>Underscores</AppxAssetNamingScheme>
  

• 保存文件后，清理项目（右键项目→清理），再重新构建。此时VS会自动用下划线代替连字符生成图标文件名，比如store_logo.altform_unplated_targetsize_16.png，符合命名规范

方案3：清理残留的违规文件

如果之前已经生成过含“-”的图标文件，先执行以下操作：

• 删除项目obj目录下（比如obj\Debug\net8.0-windows10.0.19041.0\Assets）所有违规命名的图标文件
• 执行清理项目后再重新构建，避免旧文件残留触发错误

内容的提问来源于stack exchange，提问作者Samih EL SAKHAWI