ANcpLua.NET.Sdk

MSBuild SDK with Roslyn analyzers, polyfills, and sensible defaults for .NET 10.

Install

global.json

{
  "msbuild-sdks": {
    "ANcpLua.NET.Sdk": "1.6.7"
  }
}

YourProject.csproj

<Project Sdk="ANcpLua.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net10.0</TargetFramework>
  </PropertyGroup>
</Project>

SDK Variants

SDK	Use Case	Docs
ANcpLua.NET.Sdk	Libraries, Console, Workers	Overview
ANcpLua.NET.Sdk.Web	ASP.NET Core APIs	Web variant
ANcpLua.NET.Sdk.Test	xUnit v3 with Microsoft Testing Platform	Test variant

Included

All variants:

• Roslyn analyzers for code quality
• Banned APIs enforcement (legacy → modern)
• Throw.IfNull() guard clauses
• LangVersion latest, nullable enabled
• Polyfills for netstandard2.0 targets

Web variant adds:

• OpenTelemetry integration (logging, metrics, tracing)
• Health endpoints (/health, /alive)
• HTTP resilience via Polly

Test variant adds:

• xUnit v3 with Microsoft Testing Platform
• Code coverage collection

Requirements

Central Package Management required. Create this file if you don’t have it:

Directory.Packages.props

<Project>
  <PropertyGroup>
    <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
  </PropertyGroup>
</Project>

Get started

Step-by-step installation guide