dotnet-store(1)

dotnet store

This article applies to: ✔️ .NET Core 3.1 SDK and later versions

NAME

dotnet-store - Stores the specified assemblies in the runtime package store.

SYNOPSIS

    dotnet store -m|--manifest <PATH_TO_MANIFEST_FILE>
        -f|--framework <FRAMEWORK_VERSION> -r|--runtime <RUNTIME_IDENTIFIER>
        [--framework-version <FRAMEWORK_VERSION>] [--output <OUTPUT_DIRECTORY>]
        [--skip-optimization] [--skip-symbols] [-v|--verbosity <LEVEL>]
        [--working-dir <WORKING_DIRECTORY>]
    dotnet store -h|--help

DESCRIPTION

dotnet store stores the specified assemblies in the runtime package store. By default, assemblies are optimized for the target runtime and framework. For more information, see the runtime package store topic.

  Required options

•   -f|--framework <FRAMEWORK>

    Specifies the target framework. The target framework has to be specified in the project file.

•   -m|--manifest <PATH_TO_MANIFEST_FILE>

    The package store manifest file is an XML file that contains the list of packages to store. The format of the manifest file is compatible with the SDK-style project format. So, a project file that references the desired packages can be used with the -m|--manifest option to store assemblies in the runtime package store. To specify multiple manifest files, repeat the option and path for each file. For example: --manifest packages1.csproj --manifest packages2.csproj.

•   -r|--runtime <RUNTIME_IDENTIFIER>

    The runtime identifier to target.

  Optional options

•   --framework-version <FRAMEWORK_VERSION>

    Specifies the .NET SDK version. This option enables you to select a specific framework version beyond the framework specified by the -f|--framework option.

•   -?|-h|--help

    Prints out a description of how to use the command.

•   -o|--output <OUTPUT_DIRECTORY>

    Specifies the path to the runtime package store. If not specified, it defaults to the store subdirectory of the user profile .NET installation directory.

•   --skip-optimization

    Skips the optimization phase. For more information about optimization, see Preparing a runtime environment.

•   --skip-symbols

    Skips symbol generation. Currently, you can only generate symbols on Windows and Linux.

•   -v|--verbosity <LEVEL>

    Sets the verbosity level of the command. Allowed values are q[uiet], m[inimal], n[ormal], d[etailed], and diag[nostic]. For more information, see <xref:Microsoft.Build.Framework.LoggerVerbosity>.

•   -w|--working-dir <WORKING_DIRECTORY>

    The working directory used by the command. If not specified, it uses the obj subdirectory of the current directory.

EXAMPLES

•   Store the packages specified in the packages.csproj project file for .NET 6.0.1:

        dotnet store --manifest packages.csproj --framework-version 6.0.1 --framework net6.0 --runtime win-x64

•   Store the packages specified in the packages.csproj without optimization:

        dotnet store --manifest packages.csproj --skip-optimization --framework net6.0 --runtime linux-x64

SEE ALSO

•   Runtime package store