Bagikan melalui

templat baru <dotnet>

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

Nama

dotnet new - Membuat proyek baru, file konfigurasi, atau solusi berdasarkan templat yang ditentukan.

Sinopsis

dotnet new <TEMPLATE> [--dry-run] [--force] [-lang|--language {"C#"|"F#"|VB}]
    [-n|--name <OUTPUT_NAME>] [-f|--framework <FRAMEWORK>] [--no-update-check]
    [-o|--output <OUTPUT_DIRECTORY>] [--project <PROJECT_PATH>]
    [-d|--diagnostics] [--verbosity <LEVEL>] [Template options]

dotnet new -h|--help

Deskripsi

Perintah dotnet new membuat proyek .NET atau artefak lainnya berdasarkan templat.

Perintah memanggil mesin templat untuk membuat artefak pada disk berdasarkan templat dan opsi yang ditentukan.

Catatan

Dimulai dengan .NET 7 SDK, dotnet new sintaks telah berubah:

  • --list, --search, --install, dan --uninstall opsi menjadi list, search, install, dan uninstall sub-perintah.
  • Opsi --update-apply menjadi subperintah update.
  • Untuk menggunakan --update-check, gunakan update sub-perintah dengan --check-only opsi .

Opsi lain yang tersedia sebelumnya masih tersedia untuk digunakan dengan subperintah opsi masing-masing. Bantuan terpisah untuk setiap subperintah tersedia melalui opsi -h atau --help: dotnet new <subcommand> --help mencantumkan semua opsi yang didukung untuk subperintah.

Selain itu, penyelesaian tab sekarang tersedia untuk dotnet new. Ini mendukung penyelesaian untuk nama templat yang diinstal dan untuk opsi yang disediakan templat yang dipilih. Untuk mengaktifkan penyelesaian tab untuk SDK .NET, lihat Mengaktifkan penyelesaian tab.

Penyelesaian tab

Dimulai dengan .NET SDK 7.0.100, penyelesaian tab tersedia untuk dotnet new. Ini mendukung penyelesaian untuk nama template yang diinstal, serta penyelesaian untuk opsi yang disediakan oleh template yang dipilih. Untuk mengaktifkan penyelesaian tab untuk SDK .NET, lihat Mengaktifkan penyelesaian tab.

Pemulihan implisit

Anda tidak harus menjalankan dotnet restore karena dijalankan secara implisit oleh semua perintah yang memerlukan terjadinya pemulihan, seperti dotnet new, dotnet build, dotnet run, dotnet test, dotnet publish, dan dotnet pack. Untuk menonaktifkan pemulihan implisit, gunakan opsi --no-restore.

Perintah dotnet restore masih berguna dalam skenario tertentu di mana pemulihan secara eksplisit masuk akal, seperti pembangunan integrasi berkelanjutan di Azure DevOps Services atau dalam sistem pembangunan yang perlu secara eksplisit mengontrol saat pemulihan terjadi.

Untuk informasi tentang cara mengelola umpan NuGet, lihat dotnet restore dokumentasi.

Argumen

  • TEMPLATE

    Templat untuk membuat instans saat perintah dipanggil. Setiap templat mungkin memiliki opsi tertentu yang dapat Anda lewati. Untuk informasi selengkapnya, lihat Opsi templat.

    Anda dapat menjalankan dotnet new list untuk melihat daftar semua templat yang terinstal.

    Perintahsearch harus digunakan untuk mencari templat di NuGet.org.

    Untuk daftar templat yang dikirim dengan .NET SDK, lihat Templat yang telah diinstal sebelumnya.

Opsi

  • --dry-run

    Menampilkan ringkasan apa yang akan terjadi jika perintah yang diberikan dijalankan jika akan menghasilkan pembuatan templat.

  • --force

    Memaksa konten dibuat meskipun akan mengubah file yang ada. Ini diperlukan ketika templat yang dipilih akan mengambil alih file yang ada di direktori output.

  • -?|-h|--help

    Mencetak deskripsi cara menggunakan perintah.

  • -lang|--language {C#|F#|VB}

    Bahasa templat yang akan dibuat. Bahasa yang diterima bervariasi menurut templat (lihat default di bagian argumen ). Tidak valid untuk beberapa templat.

    Catatan

    Beberapa shell menafsirkan # sebagai karakter khusus. Dalam kasus tersebut, sertakan nilai parameter bahasa dalam tanda kutip. Contohnya,dotnet new console -lang "F#".

  • -n|--name <OUTPUT_NAME>

    Nama untuk output yang dibuat. Jika tidak ada nama yang ditentukan, nama direktori saat ini akan digunakan.

  • -f|--framework <FRAMEWORK>

    Menentukan kerangka kerja target. Ini mengharapkan moniker kerangka kerja target (TFM). Contoh: "net6.0", "net7.0-macos". Nilai ini akan tercermin dalam file proyek.

  • -no-update-check

    Menonaktifkan pemeriksaan pembaruan paket templat saat membuat templat. Tersedia sejak .NET SDK 6.0.100. Saat membuat instans templat dari paket templat yang diinstal dengan menggunakan dotnet new --install, dotnet new memeriksa apakah ada pembaruan untuk templat. Dimulai dengan .NET 6, tidak ada pemeriksaan pembaruan yang dilakukan untuk templat default .NET. Untuk memperbarui templat default .NET, instal versi patch dari .NET SDK.

  • -o|--output <OUTPUT_DIRECTORY>

    Lokasi untuk menempatkan output yang dihasilkan. Defaultnya adalah direktori saat ini.

  • --project <PROJECT_PATH>

    Proyek tempat templat ditambahkan. Proyek ini digunakan untuk evaluasi konteks. Jika tidak ditentukan, proyek di direktori saat ini atau induk akan digunakan. Tersedia sejak .NET SDK 7.0.100.

  • -d|--diagnostics

    Mengaktifkan output diagnostik. Tersedia sejak .NET SDK 7.0.100.

  • -v|--verbosity <LEVEL>

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

Opsi templat

Setiap templat mungkin memiliki opsi tambahan yang ditentukan. Untuk informasi selengkapnya, lihat templat default .NET untuk dotnet new.

Contoh

  • Buat proyek aplikasi konsol C#:

    dotnet new console

  • Buat proyek aplikasi konsol F# di direktori saat ini:

    dotnet new console --language "F#"

  • Buat proyek pustaka kelas .NET Standard 2.0 di direktori yang ditentukan:

    dotnet new classlib --framework "netstandard2.0" -o MyLibrary

  • Buat proyek ASP.NET Core C# MVC baru di direktori saat ini tanpa autentikasi:

    dotnet new mvc -au None

  • Buat proyek xUnit baru:

    dotnet new xunit

  • Buat global.json di pengaturan direktori saat ini versi SDK ke 8.0.101:

    dotnet new globaljson --sdk-version 8.0.101 --roll-forward latestFeature

  • Tampilkan bantuan untuk templat aplikasi konsol C#:

    dotnet new console -h

  • Tampilkan bantuan untuk templat aplikasi konsol F#:

    dotnet new console --language "F#" -h

Lihat juga

  • Last updated on