Skip to content
chsbufferPublic

About

Static SkiaSharp, Angle and Avalonia.Native libraries for Avalonia. Also a .NET AppHost with those pre-linked.

Topics

Resources

Stars

11 stars

Watchers

0 watching

Forks

Repository files navigation

HostForge

NuGet

无需 NativeAOT,也能发布不解压本机库的 .NET 单文件应用。

HostForge 将本机静态库重新链接进 .NET AppHost / SingleFileHost,替换 SDK 默认宿主,从而避免 IncludeNativeLibrariesForSelfExtract 带来的运行时解包。

项目组件

组件 用途 当前支持
ChsBuffer.Avalonia.AppHost 已预链接 ANGLE / SkiaSharp / HarfBuzzSharp 的 Avalonia 宿主模板 Avalonia 12;.NET 10(10.0.15)、.NET 11(11.0.0);win-x64、win-arm64、linux-x64
ChsBuffer.AppHost.Static.win-x64 在普通 .NET 项目的构建/发布过程中重新链接宿主 .NET 10 / .NET 11(每个运行时一个包版本)、win-x64
ChsBuffer.SkiaSharp.Static NativeAOT 的 SkiaSharp / HarfBuzzSharp 静态库,包含 RID 包与元包 3.119.4 / 4.156.1:Windows、Linux glibc / musl、macOS 的 x64 / arm64
ChsBuffer.Avalonia.Native.Static NativeAOT 的 AvaloniaNative 静态链接输入 Avalonia 12.1.6;osx-x64、osx-arm64
ChsBuffer.Angle.Static 提供 ANGLE 静态链接输入 win-x64、win-arm64
静态图形元包 SkiaSharp、ANGLE、Avalonia.Native 统一的 NativeAOT 引用入口 SkiaSharp 覆盖 8 个 64 位 RID;ANGLE 覆盖 Windows;Avalonia.Native 覆盖 macOS

项目仍处于预览阶段,包版本和构建接口可能继续调整。

宿主静态库从 .NET 官方产品的源码(VMR 的发布标签)构建,与官方运行时包同源,包含先合入 VMR、尚未回流到 dotnet/runtime 的安全修复。

工作原理

flowchart LR
    H[.NET Host 静态库] --> L[HostForge 链接流程]
    N[本机静态库] --> L
    M[MSBuild 集成] --> L
    L --> A[自定义 AppHost]
    L --> S[自定义 SingleFileHost]
    A --> P[普通 .NET 单文件发布]
    S --> P
Loading

应用仍使用常规 .NET 构建和单文件发布流程;HostForge 只替换宿主生成方式,不要求启用 NativeAOT。

Avalonia 快速开始

在 Avalonia 项目中引用宿主包,并启用单文件发布:

<PropertyGroup>
  <PublishSingleFile>true</PublishSingleFile>
</PropertyGroup>

<ItemGroup>
  <PackageReference Include="ChsBuffer.Avalonia.AppHost" Version="12.0.2" />
</ItemGroup>

然后正常发布:

dotnet publish -c Release

当目标框架(net10.0 / net11.0,含 net11.0-windows 等平台后缀)和 RID 存在匹配模板时,包会自动替换 AppHost 与 SingleFileHost,注入本机库解析器,并从发布目录移除 ANGLE / SkiaSharp / HarfBuzzSharp 动态本机库。

完整行为和可选开关见 Avalonia AppHost 包文档。通用静态链接用法见 Static AppHost 包文档。

文档与示例

License

MIT

About

Static SkiaSharp, Angle and Avalonia.Native libraries for Avalonia. Also a .NET AppHost with those pre-linked.

Topics

Resources

Stars

11 stars

Watchers

0 watching

Forks

Contributors

Languages