Panoramica dell'interfaccia della riga di comando di .NET
Questo articolo si applica a: ✔️ .NET Core 3.1 SDK e versioni successive
L'interfaccia della riga di comando di .NET è una toolchain multipiattaforma per lo sviluppo, la compilazione, l'esecuzione e la pubblicazione di applicazioni .NET.
L'interfaccia della riga di comando di .NET è inclusa in .NET SDK. Per altre informazioni su come installare .NET SDK, vedere Installare .NET Core.
Comandi dell'interfaccia della riga di comando
Per impostazione predefinita vengono installati i comandi seguenti:
Comandi di base
new
restore
build
publish
run
test
vstest
pack
migrate
clean
sln
help
store
watch
format
(disponibile a partire da .NET 6 SDK)
Comandi per la modifica dei progetti
Comandi NuGet
nuget delete
nuget locals
nuget push
nuget add source
(disponibile a partire da .NET Core 3.1.200 SDK)nuget disable source
(disponibile a partire da .NET Core 3.1.200 SDK)nuget enable source
(disponibile a partire da .NET Core 3.1.200 SDK)nuget list source
(disponibile a partire da .NET Core 3.1.200 SDK)nuget remove source
(disponibile a partire da .NET Core 3.1.200 SDK)nuget update source
(disponibile a partire da .NET Core 3.1.200 SDK)nuget verify
(disponibile a partire da .NET 5 SDK)nuget trust
(disponibile a partire da .NET 5 SDK)nuget sign
(disponibile a partire da .NET 6 SDK)
Comandi di gestione dei carichi di lavoro
workload
(disponibile a partire da .NET 7 SDK)workload install
(disponibile a partire da .NET 6 SDK)workload list
(disponibile a partire da .NET 6 SDK)workload update
(disponibile a partire da .NET 6 SDK)workload restore
(disponibile a partire da .NET 6 SDK)workload repair
(disponibile a partire da .NET 6 SDK)workload uninstall
(disponibile a partire da .NET 6 SDK)workload search
(disponibile a partire da .NET 6 SDK)
Comandi avanzati
Comandi di gestione degli strumenti
Gli strumenti sono applicazioni console installate dai pacchetti NuGet e vengono richiamati dal prompt dei comandi. È possibile scrivere strumenti propri o installare strumenti scritti da terze parti. Gli strumenti sono noti anche come strumenti globali, strumenti tool-path e strumenti locali. Per altre informazioni, vedere Panoramica degli strumenti .NET.
Struttura dei comandi
La struttura dei comandi dell'interfaccia della riga di comando è composta dal driver ("dotnet"), dal comando e, in alcuni casi, dagli argomenti e dalle opzioni. Questo modello può essere osservato nella maggior parte delle operazioni dall'interfaccia della riga di comando, inclusa la creazione di una nuova app console e la relativa esecuzione dalla riga di comando. I comandi seguenti mostrano l'esecuzione dell'app console da una directory denominata my_app:
dotnet new console
dotnet build --output ./build_output
dotnet ./build_output/my_app.dll
Driver
Il driver, denominato dotnet, ha due compiti: eseguire un'app dipendente dal framework ed eseguire un comando.
Per eseguire un'applicazione dipendente dal framework, specificare l'app dopo il driver, ad esempio dotnet /path/to/my_app.dll
. Se si esegue il comando dalla cartella in cui si trova la DLL dell'app, è sufficiente eseguire dotnet my_app.dll
. Se si vuole usare una versione specifica del runtime .NET, usare l'opzione --fx-version <VERSION>
. Per altre informazioni, vedere il comando dotnet.
Nel momento in cui si fornisce un comando al driver, dotnet.exe
avvia il processo di esecuzione del comando dell'interfaccia della riga di comando. Ad esempio:
dotnet build
Come prima operazione, il driver determina la versione dell'SDK da usare. Se non è presente alcun file global.json viene usata la versione più recente disponibile dell'SDK. Può essere una versione di anteprima o una versione stabile, a seconda di qual è la più recente disponibile nel computer. Dopo aver determinato la versione dell'SDK viene eseguito il comando.
Comando
Il comando esegue un'azione. Ad esempio, dotnet build
compila il codice. dotnet publish
pubblica il codice. I comandi vengono implementati come un'applicazione console usando una convenzione dotnet {command}
.
Argomenti
Gli argomenti passati alla riga di comando sono gli argomenti per il comando richiamato. Ad esempio, quando si esegue dotnet publish my_app.csproj
, l'argomento my_app.csproj
indica il progetto da pubblicare e viene passato al comando publish
.
Opzioni
Le opzioni passate alla riga di comando sono le opzioni per il comando richiamato. Quando si esegue dotnet publish --output /build_output
, ad esempio, l'opzione --output
e il relativo valore vengono passati al comando publish
.