Sevencat.Avalonia.Win64Aio
12.1.6
dotnet add package Sevencat.Avalonia.Win64Aio --version 12.1.6
NuGet\Install-Package Sevencat.Avalonia.Win64Aio -Version 12.1.6
<PackageReference Include="Sevencat.Avalonia.Win64Aio" Version="12.1.6" />
<PackageVersion Include="Sevencat.Avalonia.Win64Aio" Version="12.1.6" />
<PackageReference Include="Sevencat.Avalonia.Win64Aio" />
paket add Sevencat.Avalonia.Win64Aio --version 12.1.6
#r "nuget: Sevencat.Avalonia.Win64Aio, 12.1.6"
#:package Sevencat.Avalonia.Win64Aio@12.1.6
#addin nuget:?package=Sevencat.Avalonia.Win64Aio&version=12.1.6
#tool nuget:?package=Sevencat.Avalonia.Win64Aio&version=12.1.6
Sevencat.Avalonia.Win64Aio
Avalonia 12 的 Windows x64 合并包:把 Windows 平台链的所有程序集 ilrepack 合并成
一个 Avalonia.Win64Aio.dll,原生库只带 win-x64,包本身没有任何 NuGet 依赖。
想直接上手:安装步骤、最小可运行工程、发布参数、常见问题都写在同包的
USAGE.zh-CN.md(使用说明) 里。下文是包内布局与合并原理。
里面是什么
| 内容 | 说明 |
|---|---|
lib/net8.0 / lib/net10.0/Avalonia.Win64Aio.dll |
Avalonia.Win32 + Avalonia.Win32.Automation + Avalonia.Skia + Avalonia.HarfBuzz + Avalonia.OpenGL + Avalonia.Metal + Avalonia.Vulkan + Avalonia.MicroCom + SkiaSharp + HarfBuzzSharp 合并而成 |
lib/*/Avalonia.Themes.Fluent.dll |
保持原程序集身份(见下文“为什么不合并它”) |
lib/*/Avalonia.Fonts.Inter.dll |
同上 |
runtimes/win-x64/native/ |
libSkiaSharp.dll、libHarfBuzzSharp.dll、av_libglesv2.dll,只有 win-x64 |
对外只需要两个引用:
<PackageReference Include="Avalonia" Version="12.1.6" />
<PackageReference Include="Sevencat.Avalonia.Win64Aio" Version="12.1.6" />
Avalonia 12.x 自身只依赖 Avalonia.BuildServices、Avalonia.Remote.Protocol、MicroCom.Runtime,
这三个会由它正常带进来,不需要额外声明。
.NET 8+ 默认 ImplicitUsings 不需要额外设置;PlatformTarget=x64、BuiltInComInteropSupport=true
对可执行工程自动补上。
用法
<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.Win64Aio" Version="12.1.6" />
</ItemGroup>
</Project>
启动配置用 win64 平台链(不要用 UsePlatformDetect(),它属于 Avalonia.Desktop,会带回 X11/macOS):
public static AppBuilder BuildAvaloniaApp()
=> AppBuilder.Configure<App>()
.UseWin32()
.UseSkia()
.UseHarfBuzz()
.WithInterFont()
.LogToTrace();
UseWin32() / UseSkia() / UseHarfBuzz() 现在都来自合并后的 Avalonia.Win64Aio.dll,
WithInterFont() 仍在独立身份的 Avalonia.Fonts.Inter.dll 里。
XAML 里继续用 Fluent 主题:
<Application.Styles>
<FluentTheme />
</Application.Styles>
发布
dotnet publish -c Release -r win-x64
# 产物:bin\Release\net10.0\win-x64\publish\YourApp.exe(单文件,原生库一起打进去)
| 属性 | 默认 | 说明 |
|---|---|---|
AvaloniaWin64AioSingleFile |
true |
指定 RID 时 publish 默认单文件;设为 false 关闭 |
AvaloniaWin64AioTrimMergedBackends |
true |
从使用方输出目录剔除已并入的 Avalonia.OpenGL/Metal/Vulkan/MicroCom.dll;设为 false 保留 |
RuntimeIdentifier |
空 | 本包不替你设默认值(见下方说明),需要单文件/发布时请自行指定 |
关于
RuntimeIdentifier:NuGet 包里的 props/targets 无法影响首次 restore 的还原图 (还原阶段会设置ExcludeRestorePackageImports),强行默认会得到NETSDK1047。 未指定 RID 时包也能正常工作,原生库会落在runtimes/win-x64/native/下。
合并说明(重要)
为什么 Themes.Fluent / Fonts.Inter 不合并
这两个程序集内部硬编码了按程序集名解析的资源 URI:
avares://Avalonia.Themes.Fluent/Controls/FluentControls.xaml
avares://Avalonia.Themes.Fluent/Accents/BaseColorsPalette.xaml
avares://Avalonia.Fonts.Inter/Assets
改名合并后这些 URI 必然解析失败,所以它们原样保留(程序集身份、资源索引都不变)。
Avalonia.Dialogs(avares://Avalonia.Dialogs/AboutAvaloniaDialog.xaml)与
Avalonia.DesignerSupport 同理保留,后者还是 XAML 预览器(Rider/VS 的 Avalonia 插件)的必需程序集。
为什么 OpenGL / Metal / Vulkan / MicroCom 可以合并
这 4 个来自 Avalonia 核心包,是 Avalonia.Win32 / Avalonia.Skia 的后端依赖,
内部没有 avares:// 资源,因此可以随平台链一起并进 Avalonia.Win64Aio.dll。
合并后包里还会用一个 buildTransitive 目标把它们从使用方的输出目录里去掉
(AvaloniaWin64AioTrimMergedBackends=false 可关闭)。
合并后这 4 个名字在磁盘上不再存在,程序集身份统一变成 Avalonia.Win64Aio。
业务代码里 using Avalonia.OpenGL; 仍可正常编译(编译期引用不受影响),
但运行时不能按 Assembly.Load("Avalonia.OpenGL") / Type.GetType("... , Avalonia.OpenGL") 的方式加载。
合并后怎么还能访问 Avalonia 内部类型
Avalonia.Win32 / Avalonia.Skia / Avalonia.HarfBuzz / Avalonia.OpenGL / Avalonia.Vulkan
原本依赖强名称 + InternalsVisibleTo 访问 Avalonia.Base 等程序集的内部类型
(例如实现内部的 INonPumpingWaitHelper)。
合并后程序集身份变了、也没有原始私钥,运行时会拒绝(attempting to implement an inaccessible interface)。
Avalonia.Win64Aio.dll 里因此注入了
[assembly: IgnoresAccessChecksTo("Avalonia.Base")]
[assembly: IgnoresAccessChecksTo("Avalonia.Controls")]
...
CoreCLR 认可这个同名特性,用它替代 InternalsVisibleTo 关闭可见性检查。
与第三方 Avalonia 库共存
第三方库引用的是 Avalonia.Base / Avalonia.Controls 等核心程序集身份,这些没有被改名,
所以 Material.Avalonia、Avalonia.Controls.DataGrid、CommunityToolkit.Mvvm 都可以照常加。
注意所有 Avalonia.* 包必须同版本(本包声明的是 [12.1.6, 13.0.0))。
反过来,如果第三方库的 IL 直接引用了 SkiaSharp / HarfBuzzSharp / Avalonia.Skia /
Avalonia.OpenGL 等程序集身份(例如自己用 SkiaSharp 画图、或继承 OpenGlControlBase),
这些类型现在位于 Avalonia.Win64Aio.dll,那个库会在运行时加载失败。此时可以设
<AvaloniaWin64AioTrimMergedBackends>false</AvaloniaWin64AioTrimMergedBackends>
让输出目录重新带上那 4 个后端的原版 dll(SkiaSharp / HarfBuzzSharp 这类无论如何都不再单独存在)。
构建(维护者)
dotnet tool install -g dotnet-ilrepack # 打包机需要 ilrepack 在 PATH 上
.\build.ps1 # 打包 + 构建冒烟 + 自检 + 单文件发布自检
合并发生在 Avalonia.Win64Aio.csproj 的 AvaloniaWin64AioMergeAssemblies 目标里(Build 之后按 TFM 各跑一次
ilrepack,输出 obj/<cfg>/<tfm>/merged/Avalonia.Win64Aio.dll),
打包布局由 AvaloniaWin64AioIncludeLibContent 与几个原生库 None Pack 项决定。
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. 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 (1)
Showing the top 1 NuGet packages that depend on Sevencat.Avalonia.Win64Aio:
| Package | Downloads |
|---|---|
|
Sevencat.ImageFacade.Avalonia.Win64Aio
ImageFacade 的 Avalonia.Win64Aio 后端:Avalonia 宿主已经合并了真 SkiaSharp(含原生 libSkiaSharp),这里直接复用同一份 SkiaSharp 适配代码。与 ImageFacade.SkiaSharp 二选一。 |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 12.1.6 | 0 | 11/21/2026 |
包名改为 Sevencat.Avalonia.Win64Aio,合并后的程序集名为 Avalonia.Win64Aio.dll。