Skip to main content
The SDK configures sensible defaults and includes tooling for .NET 10 projects.

Variants

Choose the SDK variant that matches your project type:
SDKProject Type
ANcpLua.NET.SdkClass libraries, Console apps, Workers
ANcpLua.NET.Sdk.WebASP.NET Core APIs
ANcpLua.NET.Sdk.TestxUnit v3 test projects
See Variants for detailed configuration per variant.

Base Features

All variants include:
FeatureDescription
Banned APIsPrevents legacy API usage
AnalyzersCode quality rules
Guard clausesThrow.IfNull() and similar
PolyfillsModern syntax for netstandard2.0
NullableEnabled by default
LangVersionlatest

Web Variant Additions

FeatureDescription
OpenTelemetryLogging, metrics, tracing
Health endpoints/health, /alive
HTTP resiliencePolly integration
DevLogsBrowser → server logging

Test Variant Additions

FeatureDescription
xUnit v3With Microsoft Testing Platform
CoverageBuilt-in collection
FakeLoggerOpt-in test logger

Opt-in Properties

Enable additional features:
<PropertyGroup>
  <InjectSourceGenHelpers>true</InjectSourceGenHelpers>
  <InjectFakeLogger>true</InjectFakeLogger>
  <InjectLockPolyfill>true</InjectLockPolyfill>
  <InjectTimeProviderPolyfill>true</InjectTimeProviderPolyfill>
</PropertyGroup>

Opt-out Properties

Disable defaults:
<PropertyGroup>
  <AutoRegisterServiceDefaults>false</AutoRegisterServiceDefaults>
  <GenerateClaudeMd>false</GenerateClaudeMd>
  <InjectSharedThrow>false</InjectSharedThrow>
  <IncludeDefaultBannedSymbols>false</IncludeDefaultBannedSymbols>
</PropertyGroup>
See MSBuild Properties for the complete list.