

新闻资讯
技术学院Avalonia应用图标需分别设置:Windows可执行文件图标通过.csproj中ApplicationIcon指定.ico文件;窗口左上角图标通过Window.Icon配合avares://路径引用嵌入资源(PNG/ICO/SVG)。
在 Avalonia 中设置应用图标,主要分两部分:一是为 Windows 平台设置 .ico 文件作为可执行文件图标(即任务栏、桌面快捷方式显示的图标),二是为跨平台 UI 界面(如窗口左上角)设置 Window.Icon。两者独立生效,缺一不可。
这是用户最常想改却容易忽略的部分——Avalonia 默认生成的 .exe 使用的是 .NET SDK 内置图标。要替换它,需在项目文件(.csproj)中指定 ApplicationIcon 属性:
app.ico(建议包含 16×16、32×32、48×48、256×256 多尺寸,保存为 .ico 格式)Assets/ 子目录).csproj 的 中添加:app.ico
⚠️ 注意:仅对 Windows 目标(TargetFramework 含 win,如 net8.0-windows)生效;构建后图标会嵌入到生成的 .e 中,无需额外部署。
xe
这是运行时显示在主窗口左上角(标题栏)、任务栏预览缩略图中的图标,支持跨平台(Windows/macOS/Linux)。需在 XAML 或代码中设置:
icon.png 或 icon.ico)放在 Assets/ 目录下,并设其 Build Action 为 EmbeddedResource
MainWindow.xaml 中设置:或者在 C# 代码中(如 App.xaml.cs 的 OnFrameworkInitializationCompleted):
MainWindow.Icon = new WindowIcon("avares://YourApp/Assets/icon.png");
✅ 支持 PNG(推荐带透明通道)、ICO、SVG(需启用 Avalonia.Svg 包)。
macOS 不读取 Window.Icon,而是依赖打包时的 .icns 文件;Linux(如 GNOME)通常使用 Window.Icon 指定的 PNG。
iconutil)将 PNG 转为 AppIcon.icns,放入 Resources/,并在打包配置(如 Directory.Build.props)中引用基本上就这些。重点记牢:Windows .exe 图标靠 ApplicationIcon,界面窗口图标靠 Window.Icon + avares:// 路径,两者不互相替代。