KernLab.Loom.Tools 1.0.0-rc.12

This is a prerelease version of KernLab.Loom.Tools.
dotnet tool install --global KernLab.Loom.Tools --version 1.0.0-rc.12
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local KernLab.Loom.Tools --version 1.0.0-rc.12
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=KernLab.Loom.Tools&version=1.0.0-rc.12&prerelease
                    
nuke :add-package KernLab.Loom.Tools --version 1.0.0-rc.12
                    

KernLab.Loom.Tools

KernLab.Loom 工具面——loom dotnet 工具:loom ef optimize 逐上下文转调 dotnet ef dbcontext optimize 产出 EF CompiledModel 冻结模型,并完成 Loom 后处理(产物校验 → 选项+provider 指纹 → 接线文件发射 → 报告)。 冻结模型让 loom.CompiledModel = true 的上下文跳过运行期模型构建——启动加速与 NativeAOT 发布的配套件。

与 KernLab.Loom.Ef.Runtime(运行时)配套消费; 宿主工程需引用 Microsoft.EntityFrameworkCore.Design(dotnet ef 前置)。

安装

dotnet tool install --global KernLab.Loom.Tools

用法

# 全部上下文冻结到 ./CompiledModels(provider 按工程引用面自动推断)
loom ef optimize --project src/OrderService

# 常用参数
loom ef optimize --project src/OrderService \
                 --startup-project src/OrderService \
                 --context AppDbContext \
                 --output-dir CompiledModels \
                 --namespace CompiledModels \
                 --provider Sqlite \
                 --fingerprint 0x0123456789abcdef
参数 缺省 说明
--project 必填 optimize 宿主工程(含 [EfEntity] 语料与 Design 包引用)
--startup-project 同 --project 设计期启动工程
--context 全部上下文 只冻结指定上下文
--output-dir CompiledModels 产物目录(相对工程目录)
--namespace CompiledModels 产物命名空间
--provider 引用面推断 Sqlite/SqlServer/Npgsql
--fingerprint 缺省选项自算 运行时模型型选项非缺省时,用 LoomCompiledModelFingerprint.Compute 自算后回填
--precompile-queries 关 EF10+ PCQ 旗标骨架(#148)。当前上游 CS9270 未解除——解析后显式失败(退出码 3),不转调、不产出;net8 腿为非法组合(退出码 2)
--nativeaot 关 同上(PCQ AOT 通道;单独出现也按上游阻塞处理)。仅需纯 AOT 冻结模型时直接对设计期工厂运行 dotnet ef dbcontext optimize --nativeaot

指纹按缺省 LoomEfOptions + provider 计算(与生成设计期工厂同源);运行时选项偏离缺省时, 启动指纹卡点 fail-fast——用同源静态方法 LoomCompiledModelFingerprint.Compute 自算后 --fingerprint 透传。

文档

docs.kernlab.dev/loom —— 快速开始与各面使用指南(冻结模型节)

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.

Version Downloads Last Updated
1.0.0-rc.12 59 11/3/2026
1.0.0-rc.11 68 11/2/2026
1.0.0-rc.10 68 11/1/2026
1.0.0-rc.9 70 10/30/2026
1.0.0-rc.6 76 10/30/2026
1.0.0-rc.5 79 10/24/2026
1.0.0-rc.4 68 10/23/2026
1.0.0-rc.3 70 10/23/2026
1.0.0-rc.2 70 10/21/2026
1.0.0-rc.1 68 10/20/2026
1.0.0-alpha.15 101 10/12/2026