Sevencat.Avalonia.SimdAIO 12.1.6.2

dotnet add package Sevencat.Avalonia.SimdAIO --version 12.1.6.2
                    
NuGet\Install-Package Sevencat.Avalonia.SimdAIO -Version 12.1.6.2
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Sevencat.Avalonia.SimdAIO" Version="12.1.6.2" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Sevencat.Avalonia.SimdAIO" Version="12.1.6.2" />
                    
Directory.Packages.props
<PackageReference Include="Sevencat.Avalonia.SimdAIO" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Sevencat.Avalonia.SimdAIO --version 12.1.6.2
                    
#r "nuget: Sevencat.Avalonia.SimdAIO, 12.1.6.2"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Sevencat.Avalonia.SimdAIO@12.1.6.2
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Sevencat.Avalonia.SimdAIO&version=12.1.6.2
                    
Install as a Cake Addin
#tool nuget:?package=Sevencat.Avalonia.SimdAIO&version=12.1.6.2
                    
Install as a Cake Tool

Sevencat.Avalonia.SimdAIO

Avalonia 12 的 Windows x64、纯托管渲染 合并包:用 SimdSkia 取代 SkiaSharp / HarfBuzzSharp,把 Windows 平台链与 SimdSkia 全家桶 ilrepack 合并成 一个 Avalonia.SimdAio.dll,不带任何原生库,包本身没有任何 NuGet 依赖。 版本 12.1.6.2:前三段跟随 Avalonia(12.1.6),第四段是本包自己的修订号。

12.1.6.2 起,SkiaSharp 兼容门面(原 SimdSkia.Compatibility)也合并进同一个 Avalonia.SimdAio.dll: 使用方可以直接 using SkiaSharp; 用 SKBitmap / SKCanvas / SKCodec / SKFont 这套托管实现, 不需要再引 SimdSkia.Compatibility,也不需要(更不能)再引真 SkiaSharp 包。

想直接上手:安装步骤、最小可运行工程、发布参数、常见问题都写在同包的 USAGE.zh-CN.md(使用说明) 里。下文是包内布局与合并原理。

里面是什么

内容 说明
lib/net10.0/Avalonia.SimdAio.dll SimdSkia 版 Avalonia.Win32 + Avalonia.Win32.Automation,加 Avalonia.OpenGL + Avalonia.Metal + Avalonia.Vulkan + Avalonia.MicroCom,加 SimdSkia.Avalonia + SimdSkia.Avalonia.Gpu + SimdSkia.Core + SimdSkia.Cpu + SimdSkia.Gpu + SimdSkia.Gpu.Direct2D + SimdSkia.Imaging + SimdSkia.Text + SimdSkia.Compatibility(SkiaSharp 命名空间门面),加 Clipper2Lib、Sdcb.SimdCodecs*
lib/net10.0/Avalonia.Themes.Fluent.dll 原样附带,保持原程序集身份(见下文“为什么不合并它”)
原生库 没有。不需要 libSkiaSharp.dll、libHarfBuzzSharp.dll、av_libglesv2.dll

对外只需要两个引用:

<PackageReference Include="Avalonia" Version="12.1.6" />                    
<PackageReference Include="Sevencat.Avalonia.SimdAIO" Version="12.1.6.2" /> 

Avalonia 12.x 自身依赖的 Avalonia.BuildServices、Avalonia.Remote.Protocol、MicroCom.Runtime 会由它正常带进来,不需要额外声明。

只支持 net10.0 / win-x64:SimdSkia 0.1.10 本身只有 net10.0 目标。

用法

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>WinExe</OutputType>
    <TargetFramework>net10.0</TargetFramework>
    <RuntimeIdentifier>win-x64</RuntimeIdentifier>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Avalonia" Version="12.1.6" />
    <PackageReference Include="Sevencat.Avalonia.SimdAIO" Version="12.1.6.2" />
  </ItemGroup>
</Project>

启动用 Windows 专用链路(不要用 UsePlatformDetect(),它属于 Avalonia.Desktop, 会带回 X11/macOS 程序集并接到官方 Skia;也不要用 UseSimdSkiaDesktop(),它是 SimdSkia.Avalonia.Desktop 里的多平台入口,会连带 X11/macOS 宿主类型):

using Avalonia;
using SimdSkia.Avalonia;

public static AppBuilder BuildAvaloniaApp()
    => AppBuilder.Configure<App>()
        .UseStandardRuntimePlatformSubsystem()
        .UseWin32()
        // Win32 默认 [AngleEgl, Software];SimdSkia 走软件 framebuffer,必须只保留 Software
        .With(new Win32PlatformOptions { RenderingMode = new[] { Win32RenderingMode.Software } })
        .UseSimdSkia(static options => SimdSkiaGpuOptions.UseGpuPreferred(options))  // 优先 Direct2D,失败回退 CPU
        .LogToTrace();

这就是 SimdSkia.Avalonia.Desktop 里 UseSimdSkiaDesktop() 的 Windows 分支:先装标准运行时平台服务, 再用 UseWin32() 且渲染模式限定为 Software,最后注册 SimdSkia 的 IPlatformRenderInterface / IFontManagerImpl / ITextShaperImpl。

不需要 WithInterFont()(SimdSkia 用系统字体栈),也不要再引 Avalonia.Fonts.Inter。

XAML 里继续用 Fluent 主题(主题包需你自己引用,见下文):

<Application.Styles>
  <FluentTheme />
</Application.Styles>

发布

dotnet publish -c Release -r win-x64
# 产物:bin\Release\net10.0\win-x64\publish\YourApp.exe(单文件,约 10 MB,无原生库)
属性 默认 说明
AvaloniaSimdAioSingleFile true 指定 RID 时 publish 默认单文件;设为 false 关闭
AvaloniaSimdAioTrimMergedBackends true 从使用方输出目录剔除已并入的 Avalonia.OpenGL/Metal/Vulkan/MicroCom.dll;设为 false 保留
RuntimeIdentifier 空 本包不替你设默认值(见下方说明),需要单文件/发布时请自行指定

关于 RuntimeIdentifier:NuGet 包里的 props/targets 无法影响首次 restore 的还原图 (还原阶段会设置 ExcludeRestorePackageImports),强行默认会得到 NETSDK1047。 未指定 RID 时包也能正常工作。

合并说明(重要)

为什么是 SimdSkia 版 Avalonia.Win32

SimdSkia 不实现 Avalonia.Skia 那套 IPlatformRenderInterface 的替换点,而是提供 改过的宿主程序集:SimdSkia.Avalonia.Desktop 包内 hosts/<Avalonia 版本>/Avalonia.Win32.dll 等文件,把窗口层直接接到 SimdSkia。所以你不能同时引用官方 Avalonia.Win32 包—— 两者同名同版本,会冲突。

UseSimdSkiaDesktop() 的方法体里按平台分支同时引用了四个宿主类型 (Avalonia.Win32 / Avalonia.X11 / Avalonia.Native / Avalonia.FreeDesktop), JIT 编译它之前必须能解析全部这些程序集,所以本包不合并也不打包 SimdSkia.Avalonia.Desktop, 而是直接用它的 Windows 分支(见上文启动代码)。这样 Avalonia.Native / Avalonia.X11 / Avalonia.FreeDesktop 这三个非 win 宿主也一并不需要了,包更小、依赖更干净。

为什么 Themes.Fluent 不合并、只原样附带

Avalonia.Themes.Fluent 内部硬编码了按程序集名解析的资源 URI:

avares://Avalonia.Themes.Fluent/Controls/FluentControls.xaml
avares://Avalonia.Themes.Fluent/Accents/BaseColorsPalette.xaml

改名合并后这些 URI 必然解析失败,所以它不能并进 Avalonia.SimdAio.dll; 但它原样留在 lib/net10.0/ 里(程序集身份、资源索引都不变),加了本包就有 Fluent 主题可用。 Avalonia.Fonts.Inter 不提供:SimdSkia 走系统字体栈,也不需要 WithInterFont()。

为什么 OpenGL / Metal / Vulkan / MicroCom 可以合并

这 4 个来自 Avalonia 核心包,是平台宿主的引用目标,内部没有 avares:// 资源, 因此可以随平台链一起并进 Avalonia.SimdAio.dll。合并后包里还会用一个 buildTransitive 目标 把它们从使用方的输出目录里去掉(AvaloniaSimdAioTrimMergedBackends=false 可关闭)。

合并后这 4 个名字在磁盘上不再存在,程序集身份统一变成 Avalonia.SimdAio。 业务代码里 using Avalonia.OpenGL; 仍可正常编译(编译期引用不受影响), 但运行时不能按 Assembly.Load("Avalonia.OpenGL") / Type.GetType("... , Avalonia.OpenGL") 的方式加载。

合并后怎么还能访问 Avalonia 内部类型

Avalonia.Win32 原本依赖强名称 + InternalsVisibleTo 访问 Avalonia.Base 等程序集的内部类型 (例如实现内部的 INonPumpingWaitHelper)。合并后程序集身份变了、也没有原始私钥, 运行时会拒绝(attempting to implement an inaccessible interface)。 Avalonia.SimdAio.dll 里因此注入了

[assembly: IgnoresAccessChecksTo("Avalonia.Base")]
[assembly: IgnoresAccessChecksTo("Avalonia.Controls")]
...

CoreCLR 认可这个同名特性,用它替代 InternalsVisibleTo 关闭可见性检查。

与第三方库共存

引用 Avalonia.Base / Avalonia.Controls 等核心程序集身份的库(CommunityToolkit.Mvvm、 Avalonia.Controls.DataGrid 等)可以照常加,本包没有改动这些身份。 注意所有 Avalonia.* 包必须同版本(本包声明的是 [12.1.6, 13.0.0))。

两类库需要注意:

  • 依赖 Avalonia.Desktop / Avalonia.Skia / Avalonia.Win32 官方包的库——会带回官方宿主, 与合并包同名冲突,不能用;
  • 依赖真 SkiaSharp 包(想直接画 Skia 图形的库)——SimdSkia 只提供 SkiaSharp 命名空间的 兼容 API,程序集标识不同。对方硬引用 SkiaSharp.dll 时会把原版也拉进来,等于两套实现并存, 不建议这样混用。

构建(维护者)

dotnet tool install -g dotnet-ilrepack   # 打包机需要 ilrepack 在 PATH 上
.\build.ps1                              # 打包 + 构建冒烟 + 自检 + 单文件发布自检

合并发生在 Avalonia.SimdAio.csproj 的 AvaloniaSimdAioMergeAssemblies 目标里(Build 之后跑一次 ilrepack,输出 obj/<cfg>/<tfm>/merged/Avalonia.SimdAio.dll), 打包布局由 AvaloniaSimdAioIncludeLibContent 决定。

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
12.1.6.2 0 11/21/2026
12.1.6.1 0 11/21/2026

12.1.6.2:把 SimdSkia.Compatibility(SkiaSharp 兼容门面)合并进 Avalonia.SimdAio.dll,使用方可以直接用 SkiaSharp 命名空间而不必再引 SimdSkia.Compatibility 包(注意不要同时引真正的 SkiaSharp 包,否则同名类型冲突);Avalonia 12.1.6 + SimdSkia 0.1.10,win-x64 only;启动方式为 UseWin32 + Win32RenderingMode.Software + UseSimdSkia。