Skip to content

README.md

Latest commit

 

History

History
126 lines (94 loc) · 3.87 KB

README.md

File metadata and controls

126 lines (94 loc) · 3.87 KB

Dotnet CLI (dotnet)

This Feature installs the latest .NET SDK, which includes the .NET CLI and the shared runtime. Options are provided to choose a different version or additional versions.

Example Usage

"features": {
    "ghcr.io/devcontainers/features/dotnet:2": {}
}

Options

Options Id Description Type Default Value
version Select or enter a .NET SDK version. Use 'latest' for the latest version, 'lts' for the latest LTS version, 'X.Y' or 'X.Y.Z' for a specific version, 'X.Y-preview' or 'X.Y-daily' for prereleases. string latest
additionalVersions Enter additional .NET SDK versions, separated by commas. Use 'latest' for the latest version, 'lts' for the latest LTS version, 'X.Y' or 'X.Y.Z' for a specific version, 'X.Y-preview' or 'X.Y-daily' for prereleases. string -
dotnetRuntimeVersions Enter additional .NET runtime versions, separated by commas. Use 'latest' for the latest version, 'lts' for the latest LTS version, 'X.Y' or 'X.Y.Z' for a specific version, 'X.Y-preview' or 'X.Y-daily' for prereleases. string -
aspNetCoreRuntimeVersions Enter additional ASP.NET Core runtime versions, separated by commas. Use 'latest' for the latest version, 'lts' for the latest LTS version, 'X.Y' or 'X.Y.Z' for a specific version, 'X.Y-preview' or 'X.Y-daily' for prereleases. string -
workloads Enter additional .NET SDK workloads, separated by commas. Use 'dotnet workload search' to learn what workloads are available to install. string -

Customizations

VS Code Extensions

  • ms-dotnettools.csharp

Configuration examples

Installing only the latest .NET SDK version (the default).

"features": {
    "ghcr.io/devcontainers/features/dotnet:2": "latest" // or "" or {}
}

Installing an additional SDK version. Multiple versions can be specified as comma-separated values.

"features": {
    "ghcr.io/devcontainers/features/dotnet:2": {
        "version": "latest", // (this can be omitted)
        "additionalVersions": "lts"
    }
}

Installing specific SDK versions.

"features": {
    "ghcr.io/devcontainers/features/dotnet:2": {
        "version": "6.0",
        "additionalVersions": "7.0, 8.0"
    }
}

Installing a specific SDK feature band.

"features": {
    "ghcr.io/devcontainers/features/dotnet:2": {
        "version": "6.0.4xx",
    }
}

Installing a specific SDK patch version.

"features": {
    "ghcr.io/devcontainers/features/dotnet:2": {
        "version": "6.0.412",
    }
}

Installing only the .NET Runtime or the ASP.NET Core Runtime. (The SDK includes all runtimes so this configuration is only useful if you need to run .NET apps without building them from source.)

"features": {
    "ghcr.io/devcontainers/features/dotnet:2": {
        "version": "none",
        "dotnetRuntimeVersions": "latest, lts",
        "aspnetCoreRuntimeVersions": "latest, lts",
    }
}

Installing .NET workloads. Multiple workloads can be specified as comma-separated values.

"features": {
    "ghcr.io/devcontainers/features/dotnet:2": {
      "workloads": "aspire, wasm-tools"
    }
}

Installing prerelease builds. Supports preview and daily suffixes.

"features": {
    "ghcr.io/devcontainers/features/dotnet:2": {
        "version": "10.0-preview",
        "additionalVersions": "10.0.1xx-daily",
        "dotnetRuntimeVersions": "10.0-daily",
        "aspnetCoreRuntimeVersions": "10.0-daily"
    }
}

OS Support

This Feature should work on recent versions of Debian/Ubuntu-based distributions with the apt package manager installed.

bash is required to execute the install.sh script.

Note: This file was auto-generated from the devcontainer-feature.json. Add additional notes to a NOTES.md.