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
<PackageReference Include="Sevencat.Avalonia.SimdAIO" Version="12.1.6.2" />
<PackageVersion Include="Sevencat.Avalonia.SimdAIO" Version="12.1.6.2" />
<PackageReference Include="Sevencat.Avalonia.SimdAIO" />
paket add Sevencat.Avalonia.SimdAIO --version 12.1.6.2
#r "nuget: Sevencat.Avalonia.SimdAIO, 12.1.6.2"
#:package Sevencat.Avalonia.SimdAIO@12.1.6.2
#addin nuget:?package=Sevencat.Avalonia.SimdAIO&version=12.1.6.2
#tool nuget:?package=Sevencat.Avalonia.SimdAIO&version=12.1.6.2
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 | Versions 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. |
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.
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。