dotnet10-pack-tool

Guides you through creating hybrid .NET 10 tool packages that combine Native AOT for maximum performance on select platforms with CoreCLR fallback for universal compatibility.

I automatically load when you mention:

• "pack .NET tool" or "dotnet pack AOT"
• "Native AOT tool" or "hybrid .NET tool"
• "ToolPackageRuntimeIdentifiers"
• ".NET 10 tool packaging"
• "cross-platform .NET tool with AOT"

1. Configure your .csproj with ToolPackageRuntimeIdentifiers and PublishAot=true
2. Generate the pointer package (metapackage)
3. Build Native AOT packages for each target RID
4. Create CoreCLR fallback with -r any
5. Validate package structure

Step 1: Configure .csproj

```xml

Exe

net10.0

enable

true

your-tool-name

any;osx-arm64;linux-arm64;linux-x64

true

true

Size

true

```

Step 2: Build Packages

```bash

# 1. Create pointer package (no binaries, just metadata)

dotnet pack -o ./packages

# 2. Build Native AOT for each target platform

dotnet pack -r osx-arm64 -o ./packages # On macOS

dotnet pack -r linux-arm64 -o ./packages # On Linux ARM or container

dotnet pack -r linux-x64 -o ./packages # On Linux x64 or container

# 3. Create CoreCLR fallback for all other platforms

dotnet pack -r any -p:PublishAot=false -o ./packages

```

Step 3: Install & Run

```bash

dotnet tool install -g your-tool-name

your-tool-name # Auto-selects best package for platform

```

| Concept | Description |

| --------------------------------- | ----------------------------------------------------- |

| Pointer Package | Metapackage that references RID-specific packages |

| ToolPackageRuntimeIdentifiers | Lists RIDs, creates pointer structure (no auto-build) |

| -r any | CoreCLR fallback for unlisted platforms |

| -p:PublishAot=false | Disables AOT for CoreCLR fallback |

• PublishAot=true disables automatic RID package generation (AOT can't cross-compile OSes)
• ToolPackageRuntimeIdentifiers creates the pointer package structure
• Manual -r builds produce AOT binaries per platform
• -r any -p:PublishAot=false creates portable CoreCLR fallback

• [reference.md](./reference.md): Complete build script, container builds, CI/CD patterns
• [examples.md](./examples.md): Real-world examples and troubleshooting

• .NET 10 SDK installed
• Docker (for cross-platform Linux builds from macOS/Windows)
• AOT-compatible container: mcr.microsoft.com/dotnet/sdk:10.0-noble-aot