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
                    
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.Win64Aio" Version="12.1.6" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Sevencat.Avalonia.Win64Aio" Version="12.1.6" />
                    
Directory.Packages.props
<PackageReference Include="Sevencat.Avalonia.Win64Aio" />
                    
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.Win64Aio --version 12.1.6
                    
#r "nuget: Sevencat.Avalonia.Win64Aio, 12.1.6"
                    
#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.Win64Aio@12.1.6
                    
#: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.Win64Aio&version=12.1.6
                    
Install as a Cake Addin
#tool nuget:?package=Sevencat.Avalonia.Win64Aio&version=12.1.6
                    
Install as a Cake Tool

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 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. 
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 (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。