dotnet clean

Artikel ini berlaku untuk: ✔️ .NET Core 3.1 SDK dan versi yang lebih baru

Nama

dotnet clean - Membersihkan output proyek.

Sinopsis

dotnet clean [<PROJECT>|<SOLUTION>] [--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

Deskripsi

Perintah dotnet clean membersihkan output dari build sebelumnya. Ini diimplementasikan sebagai target MSBuild, sehingga proyek dievaluasi saat perintah dijalankan. Hanya output yang dibuat selama build yang dibersihkan. Folder perantara (obj) dan output akhir (bin) dibersihkan.

Argumen

PROJECT | SOLUTION

Proyek atau solusi MSBuild untuk dibersihkan. Jika file proyek atau solusi tidak ditentukan, MSBuild mencari direktori kerja saat ini untuk file yang memiliki ekstensi file yang berakhiran proj atau sln, dan menggunakan file tersebut.

Opsi

• --artifacts-path <ARTIFACTS_DIR>

  Semua file output build dari perintah yang dijalankan akan masuk ke subfolder di bawah jalur yang ditentukan, dipisahkan oleh proyek. Untuk informasi selengkapnya, lihat Tata Letak Output Artefak. Tersedia sejak .NET 8 SDK.

• -c|--configuration <CONFIGURATION>

  Menentukan konfigurasi build. Pengaturan default untuk sebagian besar proyek adalah Debug, tetapi Anda dapat mengambil alih pengaturan konfigurasi build di proyek Anda. Opsi ini hanya diperlukan saat membersihkan jika Anda menentukannya selama waktu build.

• -f|--framework <FRAMEWORK>

  Kerangka kerja yang ditentukan pada waktu build. Kerangka kerja harus ditentukan dalam file proyek. Jika Anda menentukan kerangka kerja pada waktu build, Anda harus menentukan kerangka kerja saat membersihkan.

• -?|-h|--help

  Mencetak deskripsi cara menggunakan perintah.

• --interactive

  Memungkinkan perintah berhenti dan menunggu input atau tindakan pengguna. Misalnya, untuk menyelesaikan autentikasi. Tersedia sejak SDK .NET Core 3.0.

• --nologo

  Tidak menampilkan banner startup atau pesan hak cipta.

• -o|--output <OUTPUT_DIRECTORY>

  Direktori yang berisi artefak build untuk dibersihkan. Tentukan sakelar -f|--framework <FRAMEWORK> dengan sakelar direktori output jika Anda menentukan kerangka kerja saat proyek dibangun.

  • .NET 7.0.200 SDK dan yang lebih baru

    Jika Anda menentukan --output opsi saat menjalankan perintah ini pada solusi, CLI akan mengeluarkan peringatan (kesalahan dalam 7.0.200) karena semantik jalur output yang tidak jelas. Opsi --output ini tidak diizinkan karena semua output dari semua proyek yang dibuat akan disalin ke direktori yang ditentukan, yang tidak kompatibel dengan proyek multi-target, serta proyek yang memiliki versi dependensi langsung dan transitif yang berbeda. Untuk informasi selengkapnya, lihat Opsi tingkat solusi --output tidak lagi valid untuk perintah terkait build.

• -r|--runtime <RUNTIME_IDENTIFIER>

  Membersihkan folder output dari runtime yang ditentukan. Ini digunakan ketika penyebaran mandiri dibuat.

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

  Menentukan apakah pencatat terminal harus digunakan untuk output build. Defaultnya adalah auto, yang pertama memverifikasi lingkungan sebelum mengaktifkan pengelogan terminal. Pemeriksaan lingkungan memverifikasi bahwa terminal mampu menggunakan fitur output modern dan tidak menggunakan output standar yang dialihkan sebelum mengaktifkan pencatat baru. on melewati pemeriksaan lingkungan dan mengaktifkan pengelogan terminal. off melewati pemeriksaan lingkungan dan menggunakan pencatat konsol default.

  Pencatat terminal menunjukkan fase pemulihan diikuti oleh fase build. Selama setiap fase, proyek bangunan saat ini muncul di bagian bawah terminal. Setiap proyek yang membangun menghasilkan target MSBuild yang saat ini sedang dibangun dan jumlah waktu yang dihabiskan untuk target tersebut. Anda dapat mencari informasi ini untuk mempelajari lebih lanjut tentang build. Setelah proyek selesai dibangun, satu bagian "build completed" ditulis yang menangkap:

  • Nama proyek bawaan.
  • Kerangka kerja target (jika multi-target).
  • Status build tersebut.
  • Output utama build tersebut (yang di-hyperlink).
  • Diagnostik apa pun yang dihasilkan untuk proyek tersebut.

  Opsi ini tersedia mulai dari .NET 8.

• -v|--verbosity <LEVEL>

  Mengatur tingkat verbositas perintah. Nilai yang diizinkan adalah q[uiet], m[inimal], n[ormal], d[etailed], dan diag[nostic]. Default adalah normal. Untuk informasi selengkapnya, lihat LoggerVerbosity .

Contoh

• Bersihkan build default proyek:

  dotnet clean
  

• Bersihkan proyek yang dibangun menggunakan konfigurasi Rilis:

  dotnet clean --configuration Release