dotnet clean — команда для очистки проектов в среде .NET.

Эта статья относится к: ✔️ пакету SDK для .NET 6 и более поздних версий

Имя

dotnet clean — очищает выходные данные проекта.

Синопсис

dotnet clean [<PROJECT>|<SOLUTION>|<FILE>] [--artifacts-path <ARTIFACTS_DIR>]
    [-c|--configuration <CONFIGURATION>]
    [-f|--framework <FRAMEWORK>] [--interactive]
    [--nologo] [-o|--output <OUTPUT_DIRECTORY>]
    [-r|--runtime <RUNTIME_IDENTIFIER>] [--tl:[auto|on|off]]
    [-v|--verbosity <LEVEL>]

dotnet clean -h|--help

Description

Команда dotnet clean очищает выходные данные предыдущей сборки. Он реализуется как целевой объект MSBuild, поэтому проект оценивается при выполнении команды. Очищаются только выходные данные, созданные во время сборки. Удаляются промежуточные (obj) и конечные папки выходных данных (bin).

Arguments

PROJECT | SOLUTION | FILE

Файл проекта или решения или C# (файлового приложения) для работы. Если файл не указан, MSBuild ищет текущий каталог для проекта или решения.

• PROJECT — это путь и имя файла файла проекта C#, F# или Visual Basic, или путь к каталогу, который содержит файл проекта C#, F# или Visual Basic.

• SOLUTION — это путь и имя файла решения (.sln или расширение SLNX) или путь к каталогу, содержаму файл решения.

• FILE — это аргумент, добавленный в .NET 10. Путь и имя файла приложения на основе файлов. Приложения на основе файлов содержатся в одном файле, который создается и запускается без соответствующего файла проекта (CSPROJ). Дополнительные сведения см. в разделе "Создание файловых приложений C#".

Options

• --artifacts-path <ARTIFACTS_DIR>

  Все выходные файлы сборки из выполняемой команды будут отправляться в вложенные папки в соответствии с указанным путем, разделенным проектом. Дополнительные сведения см. в разделе "Макет выходных данных артефактов". Доступно с пакета SDK для .NET 8.

• -c|--configuration <CONFIGURATION>

  Определяет конфигурацию сборки. По умолчанию для большинства проектов используется Debug, но вы можете переопределить параметры конфигурации сборки в проекте. Этот параметр требуется только при очистке, если он указан во время сборки.

• -f|--framework <FRAMEWORK>

  Платформа, указанная во время сборки. Платформа должна быть определена в файле проекта. Если вы указали платформу во время сборки, необходимо указать платформу при очистке.

• -?|-h|--help

  Выводит описание использования команды.

• --interactive

  Позволяет команде остановить и ждать ввода или действия пользователя. Например, чтобы завершить проверку подлинности.

• --nologo

  Не отображает баннер запуска или сообщение об авторских правах.

• -o|--output <OUTPUT_DIRECTORY>

  Каталог, содержащий артефакты сборки для очистки. -f|--framework <FRAMEWORK> Укажите параметр с параметром выходного каталога, если вы указали платформу при создании проекта.

  • Пакет SDK для .NET 7.0.200 и более поздних версий

    Если указать --output параметр при выполнении этой команды в решении, интерфейс командной строки выдает предупреждение (ошибка в версии 7.0.200) из-за неясной семантики выходного пути. Этот --output параметр запрещен, так как все выходные данные всех встроенных проектов будут скопированы в указанный каталог, который не совместим с многоцелыми проектами, а также проектами с различными версиями прямых и транзитивных зависимостей. Дополнительные сведения см. в разделе "Параметр уровня --output решения" больше недействителен для команд, связанных со сборкой.

• -r|--runtime <RUNTIME_IDENTIFIER>

  Очищает выходную папку указанной среды выполнения. Это используется при создании автономного развертывания .

• --tl:[auto|on|off]

  Указывает, следует ли использовать средство ведения журнала терминала для выходных данных сборки. Значением по умолчанию является autoто, что сначала проверяет среду перед включением ведения журнала терминалов. Проверка среды проверяет, что терминал может использовать современные выходные функции и не использует перенаправленные стандартные выходные данные перед включением нового средства ведения журнала. on пропускает проверку среды и включает ведение журнала терминалов. off пропускает проверку среды и использует средство ведения журнала консоли по умолчанию.

  Средство ведения журнала терминала показывает этап восстановления, за которым следует этап сборки. На каждом этапе в нижней части терминала отображаются строительные проекты. Каждый проект, который создает выходные данные как целевого объекта MSBuild, который в настоящее время создается, так и время, затраченное на этот целевой объект. Эти сведения можно найти, чтобы узнать больше о сборке. После завершения сборки проекта записывается один раздел "сборка завершена", который записывает:

  • Имя созданного проекта.
  • Целевая платформа (если она используется с несколькими целевыми объектами).
  • Состояние этой сборки.
  • Основные выходные данные этой сборки (которая гиперссылок).
  • Любая диагностика, созданная для этого проекта.

  Этот параметр доступен начиная с .NET 8.

• -v|--verbosity <LEVEL>

  Задает уровень детализации команды. Допустимые значения: q[uiet], m[inimal], n[ormal], d[etailed] и diag[nostic]. Значение по умолчанию — normal. Дополнительные сведения см. в разделе LoggerVerbosity.

Примеры

• Очистка сборки проекта по умолчанию:

  dotnet clean
  

• Очистка файловой программы:

  dotnet clean Program.cs.
  

  Поддержка приложений на основе файлов добавлена в пакет SDK для .NET 10.0.100.

• Очистка проекта, созданного с помощью конфигурации выпуска:

  dotnet clean --configuration Release