Gambaran umum .NET CLI

Artikel
09/22/2022

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

Antarmuka baris perintah .NET (CLI) adalah toolchain lintas platform untuk mengembangkan, membangun, menjalankan, dan menerbitkan aplikasi .NET.

.NET CLI disertakan dengan .NET SDK. Untuk mempelajari cara menginstal .NET SDK, lihat Menginstal .NET Core.

Perintah CLI

Perintah berikut diinstal secara default:

Perintah dasar

Project perintah modifikasi

Perintah lanjutan

Perintah manajemen alat

tool install
tool list
tool update
tool restore Tersedia sejak .NET Core SDK 3.0.
tool run Tersedia sejak .NET Core SDK 3.0.
tool uninstall

Alat adalah aplikasi konsol yang diinstal dari paket NuGet dan dipanggil dari prompt perintah. Anda dapat menulis alat sendiri atau menginstal alat yang ditulis oleh pihak ketiga. Alat juga dikenal sebagai alat global, alat jalur alat, dan alat lokal. Untuk informasi selengkapnya, lihat Gambaran umum alat .NET.

Struktur perintah

Struktur perintah CLI terdiri dari driver ("dotnet"), perintah, dan mungkin argumen dan opsi perintah. Anda melihat pola ini di sebagian besar operasi CLI, seperti membuat aplikasi konsol baru dan menjalankannya dari baris perintah seperti yang ditunjukkan perintah berikut saat dijalankan dari direktori bernama my_app:

dotnet new console
dotnet build --output ./build_output
dotnet ./build_output/my_app.dll

Driver

Driver diberi nama dotnet dan memiliki dua tanggung jawab, baik menjalankan aplikasi yang bergantung pada kerangka kerja atau menjalankan perintah.

Untuk menjalankan aplikasi yang bergantung pada kerangka kerja, tentukan aplikasi setelah driver, misalnya, dotnet /path/to/my_app.dll. Saat menjalankan perintah dari folder tempat DLL aplikasi berada, cukup jalankan dotnet my_app.dll. Jika Anda ingin menggunakan versi tertentu dari .NET Runtime, gunakan --fx-version <VERSION> opsi (lihat referensi perintah dotnet ).

Saat Anda memberikan perintah ke driver, dotnet.exe memulai proses eksekusi perintah CLI. Contohnya:

dotnet build

Pertama, driver menentukan versi SDK yang akan digunakan. Jika tidak ada file global.json , versi terbaru SDK yang tersedia akan digunakan. Ini mungkin versi pratinjau atau stabil, tergantung pada apa yang terbaru pada komputer. Setelah versi SDK ditentukan, versi tersebut menjalankan perintah .

Perintah

Perintah melakukan tindakan. Misalnya, dotnet build membangun kode. dotnet publish menerbitkan kode. Perintah diimplementasikan sebagai aplikasi konsol menggunakan dotnet {command} konvensi.

Argumen

Argumen yang Anda berikan pada baris perintah adalah argumen ke perintah yang dipanggil. Misalnya, saat Anda menjalankan dotnet publish my_app.csproj, my_app.csproj argumen menunjukkan proyek untuk diterbitkan dan diteruskan ke publish perintah .

Opsi

Opsi yang Anda berikan pada baris perintah adalah opsi untuk perintah yang dipanggil. Misalnya, saat Anda menjalankan dotnet publish --output /build_output, --output opsi dan nilainya diteruskan ke publish perintah .

Bagikan melalui