Avalonia在macOS上无法显示正确应用图标问题求助

1. 确认图标格式与项目配置 #

macOS仅支持.icns格式的应用图标，先把你的图标转换成包含多尺寸（16x16到1024x1024）的标准.icns文件（可用IconSmith等免费工具生成）。然后在项目的.csproj文件中添加以下配置：

<!-- 配置图标为Avalonia资源 -->
<ItemGroup>
  <AvaloniaResource Include="Assets/AppIcon.icns" LogicalName="AppIcon.icns" />
</ItemGroup>

<!-- 指定macOS打包时的图标路径 -->
<PropertyGroup>
  <MacOSIcon>Assets/AppIcon.icns</MacOSIcon>
</PropertyGroup>

2. 清理构建缓存后重新构建 #

旧构建缓存会导致图标不更新，执行以下命令彻底清理并重新发布：

dotnet clean
dotnet publish -c Release -r osx-arm64  # 根据你的Mac架构调整，比如osx-x64

3. 检查并固化Info.plist配置 #

发布后若仍有问题，验证.app包内的配置：

• 右键应用→显示包内容→打开Contents/Info.plist
• 确认存在CFBundleIconFile字段，值为图标文件名（不带.icns后缀）：

<key>CFBundleIconFile</key>
<string>AppIcon</string>

把这段配置加到项目根目录的Info.plist模板中，后续构建会自动生成正确配置，无需手动修改。

4. 确认图标文件的生成操作 #

在IDE（Visual Studio/Rider）中右键图标文件→属性，将“生成操作”设置为AvaloniaResource，确保图标被正确嵌入到应用包内。

内容的提问来源于stack exchange，提问作者OstryJR