ChsBuffer.Avalonia.AppHost:

本项目聚焦一种不依赖 NativeAOT 的“真单文件”发布方案。
当应用包含本机库依赖时，通过重链接 AppHost / SingleFileHost，将静态库直接并入宿主，避免 IncludeNativeLibrariesForSelfExtract 的解包模式。

项目同时覆盖两条落地路径：

• 面向通用 .NET 应用的 StaticAppHost 构建集成。
• 面向 Avalonia 11 的 Avalonia AppHost（预链接 SkiaSharp 2.88.9 的宿主模板）。

当前重点是 win-x64，并配套可验证的构建、打包与测试流水线。

flowchart LR
    subgraph W["Windows lane"]
        direction LR
        WH["windows-hostlibs<br/>matrix: default/no-pgo x win-x64/win-arm64"]
        WS["windows-skia<br/>matrix: 11.0/12.0 x win-x64/win-arm64"]
        WLA["windows-link-avalonia<br/>matrix: 11.0, 12.0<br/>link-avalonia + avalonia-test"]
        WM["windows-matrix-test<br/>pipeline.py matrix"]
        WPS["pack-static-apphost<br/>win-x64"]
        WPKS["pack-skia-static<br/>matrix: 11.0, 12.0<br/>win-x64"]

        WH --> WLA
        WS --> WLA
        WH --> WM
        WM --> WPS
        WS --> WPKS
    end

    subgraph L["Linux lane"]
        direction LR
        LSY["linux-sysroot<br/>cache sysroot tar"]
        LH["linux-hostlibs<br/>matrix: default x linux-x64"]
        LS["linux-skia<br/>matrix: 11.0, 12.0"]
        LLA["linux-link-avalonia<br/>matrix: 11.0, 12.0<br/>link-avalonia + avalonia-test"]
        LM["linux-matrix-test<br/>pipeline.py matrix"]

        LSY --> LH
        LSY --> LS
        LSY --> LLA
        LSY --> LM
        LH --> LLA
        LS --> LLA
        LH --> LM
    end

    PA["pack-avalonia<br/>matrix: 11.0, 12.0<br/>mode=all"]

    WLA --> PA
    LLA --> PA

Job summary:

• 基于 runtime 源码产出可复用的 Host 静态库（apphost/singlefilehost）。
• 提供 StaticAppHost.targets 源码级集成，在常规 .NET 构建/发布流程中自动重链接 Host。
• 提供 Avalonia AppHost NuGet 包，面向 Avalonia 11 提供可直接消费的宿主模板与初始化逻辑。
• 支持增量缓存验证（首次触发链接、二次命中缓存）。

• docs/roadmap/2026-03-06-ProjectLaunch.md：项目启动的设计说明。
• repo/runtime-<version>：dotnet/runtime 源码（上游源码输入）。
• repo/skia-<version>：mono/skia 源码（用于构建静态 Skia/HarfBuzz 库）。
• repo/deps-mirror：依赖仓库的本地裸仓库缓存（仅非 CI）。
• repo/patch：本仓库对上游工程使用的补丁与参数文件。
• scripts/pipeline.py：构建/测试子命令入口。
• scripts/build-hostlibs.py：构建 Host 静态库到 artifacts/hostlibs/<version>/<flavor>/<rid>。
• scripts/build-skia-harfbuzz.py：构建并收集 mono/skia + HarfBuzz 静态库到 artifacts/skiasharp/<version>/<rid>。
• scripts/init-vs-env.cmd：初始化 Visual Studio/MSVC 构建环境。
• scripts/set-cmake-path.ps1：设置 CMake 相关路径辅助脚本。
• src/StaticAppHost.targets、src/StaticAppHost.Windows.targets、src/findvcvarsall.bat：StaticAppHost 源码级 MSBuild 集成。
• src/package-apphost-static：ChsBuffer.AppHost.Static.win-x64 包工程。
• src/package-skiasharp-static：ChsBuffer.SkiaSharp.Static.win-x64 包工程。
• src/package-avalonia-apphost：ChsBuffer.Avalonia.AppHost 包工程。
• samples/simple-pinvoke：消费端示例工程（dllexport/pinvoke 最小验证）。
• samples/avalonia-sample：Avalonia 消费端示例工程（用于验证 Avalonia AppHost 包）。
• tests/HostForge.TestInfra：测试共享基础设施（命令执行、工作区构建、断言工具）。
• tests/HostForge.AvaloniaAppHost.Tests：Avalonia AppHost 构建/发布行为的 TUnit 集成测试。
• tests/HostForge.StaticAppHost.Tests：Static AppHost 增量链接矩阵的 TUnit 集成测试。
• artifacts/hostlibs/<version>/<flavor>/<rid>：Host 静态库输出目录。
• artifacts/skiasharp/<version>/<rid>：SkiaSharp/HarfBuzz 静态库输出目录。

• Windows 11
• MSVC Build Tools 14.50 (VS 2026) x64,arm64
• Windows SDK 10.0.26100
• Python 3.12+
• Ninja build
• CMake on Windows
• LLVM (C:\Program Files\LLVM)

• 检出外部依赖

python .\scripts\checkout-deps.py runtime 10.0
python .\scripts\checkout-deps.py skiasharp 2.88.9

• 构建 HostLib：

python .\scripts\pipeline.py hostlibs -v

Windows 下会同时生成 default 和 no-pgo 两套 hostlibs；Linux 只生成 default。 本地如果要在同一份 repo\runtime-10.0 工作树里切换 default 和 no-pgo，需要先手动执行 build.cmd -clean 清理对应 subset 的中间产物；CI 的 default / no-pgo 在不同 runner 实例上执行，不受这个问题影响。

例如 Windows x64 本地切换 flavor 前可先执行：

.\repo\runtime-10.0\build.cmd -clean -subset host.native -c Release -a x64
.\repo\runtime-10.0\build.cmd -clean -subset clr.runtime -c Release -a x64

或

python .\scripts\build-hostlibs.py all -v --arch x64
python .\scripts\build-hostlibs.py all -v --arch arm64
python .\scripts\build-hostlibs.py all -v --arch x64 --no-pgo
python .\scripts\build-hostlibs.py all -v --arch arm64 --no-pgo

• 运行构建集成矩阵测试：

python .\scripts\pipeline.py matrix

• 构建 SkiaSharp：

python .\scripts\pipeline.py skia -v

或

python .\scripts\build-skia-harfbuzz.py -v -a x64
python .\scripts\build-skia-harfbuzz.py -v -a arm64

• 打包 Avalonia Host 包：

python .\scripts\pipeline.py pack-avalonia -v --target 11.0 --mode windows

• 打包 StaticAppHost 包：

python .\scripts\pipeline.py pack-static-apphost -v --rid win-x64

• 打包 SkiaSharp.Static 包：

python .\scripts\pipeline.py pack-skia-static -v --target 11.0 --rid win-x64

• 运行 Avalonia AppHost 集成测试：

python .\scripts\pipeline.py avalonia-test -v --target 11.0

• 检出外部依赖

python .\scripts\checkout-deps.py runtime 10.0
python .\scripts\checkout-deps.py skiasharp 3.119.2

• 构建 HostLib：

同上

• 构建 SkiaSharp：

python .\scripts\build-skia-harfbuzz.py -v -a x64 --version 3.119.2
python .\scripts\build-skia-harfbuzz.py -v -a arm64 --version 3.119.2

• 打包 Avalonia Host 包：

python .\scripts\pipeline.py link-avalonia -v --target 12.0 --os windows
python .\scripts\pipeline.py pack-avalonia -v --target 12.0 --mode windows

• 运行 Avalonia AppHost 集成测试：

python .\scripts\pipeline.py avalonia-test -v --target 12.0

• 运行 Avalonia 12 示例项目

dotnet run --project .\samples\avalonia-sample\AvaloniaSample.csproj -c Release -p:TargetAvaloniaVersion=12.0

• 构建 HostLib：

ROOTFS_DIR=repo/rootfs/x64 python scripts/build-hostlibs.py -v --os linux --arch x64

• 构建 SkiaSharp / HarfBuzz：

CC=clang CXX=clang++ ROOTFS_DIR=repo/rootfs/x64 python scripts/build-skia-harfbuzz.py -v --os linux --arch x64

• 生成 Linux Avalonia AppHost 模板：

python scripts/pipeline.py link-avalonia -v --target 12.0 --os linux --sysroot repo/rootfs/x64

• 运行构建集成矩阵测试：

dotnet run --project samples/simple-pinvoke/SimplePInvoke.csproj
dotnet publish samples/simple-pinvoke/SimplePInvoke.csproj -p:"PublishTrimmed=true"

Useful Code Is Ugly | Tsoding