SDK Variants

Three SDK variants for different project types.

Choose the variant that matches your project type. See Quickstart for installation.

Variant	Use case
ANcpLua.NET.Sdk	Libraries, console apps, workers
ANcpLua.NET.Sdk.Web	ASP.NET Core APIs
ANcpLua.NET.Sdk.Test	xUnit v3 test projects

Base

All variants include:

• Roslyn analyzers
• Banned APIs enforcement
• Guard clauses (Throw.IfNull())
• Nullable enabled, LangVersion latest
• Deterministic builds, SourceLink

Web

Extends the base SDK with:

• OpenTelemetry (logging, metrics, tracing)
• Auto-instrumentation for GenAI and database calls
• Health endpoints (/health, /alive)
• HTTP resilience via Polly
• DevLogs (browser → server logging)

See Service Defaults for configuration.

Test

Extends the base SDK with:

• xUnit v3 with Microsoft Testing Platform
• AwesomeAssertions
• WebApplicationFactory base classes
• Analyzer testing packages

The SDK auto-detects xunit.v3.mtp-v2 and sets OutputType=Exe automatically. See Testing for MTP CLI syntax and troubleshooting.