dotnet store

本文适用于：✔️ .NET 6 SDK 及更高版本

Name

dotnet store - 将指定的程序集存储在 运行时包存储中。

概要

dotnet store [-m|--manifest <PATH_TO_MANIFEST_FILE>]
  [-f|--framework <FRAMEWORK_VERSION>] [--disable-build-servers]
  [--framework-version <FRAMEWORK_VERSION>]
  [--output <OUTPUT_DIRECTORY>] [-r|--runtime <RUNTIME_IDENTIFIER>] 
  [--skip-optimization] [--skip-symbols]
  [--ucr|--use-current-runtime] [-v|--verbosity <LEVEL>]
  [--working-dir <WORKING_DIRECTORY>]

dotnet store -h|--help

Description

dotnet store 将指定的程序集存储在 运行时包存储中。 默认情况下，程序集针对目标运行时和框架进行优化。 有关详细信息，请参阅 运行时包存储 主题。

必需选项

• -f|--framework <FRAMEWORK>

  指定目标框架。 必须在项目文件中指定目标框架。

• --disable-build-servers

  强制运行命令以忽略任何永久性生成服务器。 此选项提供一种一致的方法来禁止对生成缓存的所有使用，这会强制从头开始生成。 当缓存可能由于某种原因而损坏或不正确时，不依赖缓存的生成非常有用。 自 .NET 7 SDK 起可用。

• -m|--manifest <PATH_TO_MANIFEST_FILE>

  包存储清单文件是包含要存储的包列表的 XML 文件。 清单文件的格式与 SDK 样式的项目格式兼容。 因此，引用所需包的项目文件可用于 -m|--manifest 将程序集存储在运行时包存储中的选项。 若要指定多个清单文件，请为每个文件重复选项和路径。 例如： --manifest packages1.csproj --manifest packages2.csproj。

• -r|--runtime <RUNTIME_IDENTIFIER>

  要面向的 运行时标识符 。

可选选项

• --framework-version <FRAMEWORK_VERSION>

  指定 .NET SDK 版本。 此选项使你能够选择一个特定框架版本，该版本超出了该选项指定的 -f|--framework 框架。

• -o|--output <OUTPUT_DIRECTORY>

  指定运行时包存储的路径。 如果未指定，则默认为用户配置文件 .NET 安装目录的 存储 子目录。

• --skip-optimization

  跳过优化阶段。 有关优化的详细信息，请参阅 准备运行时环境。

• --skip-symbols

  跳过符号生成。 目前，只能在 Windows 和 Linux 上生成符号。

• --ucr|--use-current-runtime

  将当前运行时用作目标运行时。 默认值为 false。

• -v|--verbosity <LEVEL>

  设置命令的详细级别。 允许使用的值为 q[uiet]、m[inimal]、n[ormal]、d[etailed] 和 diag[nostic]。 有关详细信息，请参阅 LoggerVerbosity。

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

  命令使用的工作目录。 如果未指定，则使用当前目录的 obj 子目录。

• -?|-h|--help

  打印出有关如何使用命令的说明。

例子

• 存储 .NET 6.0.1 的 packages.csproj 项目文件中指定的包：

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

• 在不优化的情况下存储 packages.csproj 中指定的包：

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

另请参阅

• 运行时包存储