SDK Overview

ANcpLua.NET.Sdk features and configuration options.

The SDK configures sensible defaults and includes tooling for .NET 10 projects.

Variants

Choose the SDK variant that matches your project type:

SDK	Project Type
ANcpLua.NET.Sdk	Class libraries, Console apps, Workers
ANcpLua.NET.Sdk.Web	ASP.NET Core APIs
ANcpLua.NET.Sdk.Test	xUnit v3 test projects

See Variants for detailed configuration per variant.

Base Features

All variants include:

Feature	Description
Banned APIs	Prevents legacy API usage
Analyzers	Code quality rules
Guard clauses	Throw.IfNull() and similar
Polyfills	Modern syntax for netstandard2.0
Nullable	Enabled by default
LangVersion	latest

Web Variant Additions

Feature	Description
OpenTelemetry	Logging, metrics, tracing
Auto-instrumentation	GenAI (OpenAI, Anthropic) and database (ADO.NET) spans
Health endpoints	/health, /alive
HTTP resilience	Polly integration
DevLogs	Browser → server logging

Test Variant Additions

Feature	Description
xUnit v3	With Microsoft Testing Platform
Coverage	Built-in collection
FakeLogger	Opt-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.