dotnet migrate
Questo articolo si applica a: ✔️ .NET Core 2.x SDK
dotnet migrate
: esegue la migrazione di un progetto .NET Core Preview 2 a un progetto di tipo .NET Core SDK.
dotnet migrate [<SOLUTION_FILE|PROJECT_DIR>] [--format-report-file-json <REPORT_FILE>]
[-r|--report-file <REPORT_FILE>] [-s|--skip-project-references [Debug|Release]]
[--skip-backup] [-t|--template-file <TEMPLATE_FILE>] [-v|--sdk-package-version]
[-x|--xproj-file]
dotnet migrate -h|--help
Questo comando è deprecato. Il comando dotnet migrate
non è più disponibile a partire da .NET Core 3.0 SDK. Può solo eseguire la migrazione di un progetto .NET Core Anteprima 2 a un progetto .NET Core 1.x, per cui non è più disponibile il supporto.
Per impostazione predefinita, il comando esegue la migrazione del progetto radice e dei riferimenti del progetto presenti nel progetto radice. Questo comportamento viene disabilitato usando l'opzione --skip-project-references
in fase di esecuzione.
È possibile eseguire la migrazione in uno degli asset seguenti:
- Un singolo progetto, specificando il file project.json di cui eseguire la migrazione.
- Tutte le directory specificate nel file global.json, passando un percorso del file global.json.
- Un file solution.sln, dove vengono migrati i progetti a cui viene fatto riferimento nella soluzione.
- Tutte le sottodirectory della directory specificata, in modo ricorsivo.
Il comando dotnet migrate
mantiene il file project.json di cui è stata eseguita la migrazione all'interno di una directory backup
, che verrà creata se non esiste già. Questo comportamento viene sottoposto a override tramite l'opzione --skip-backup
.
Per impostazione predefinita, l'operazione di migrazione restituisce lo stato del processo di migrazione all'output standard (STDOUT). Se si usa l'opzione --report-file <REPORT_FILE>
, l'output viene salvato nel file specificato.
Il comando dotnet migrate
supporta solo progetti basati su project.json Preview 2 validi. Questo significa che non è possibile usare questo comando per eseguire la migrazione di progetti basati su DNX o project.json Preview 1 direttamente a progetti MSBuild/csproj. È prima necessario eseguire manualmente la migrazione del progetto a un progetto basato su project.json Preview 2 e quindi usare il comando dotnet migrate
per eseguire la migrazione del progetto.
PROJECT_JSON/GLOBAL_JSON/SOLUTION_FILE/PROJECT_DIR
Percorso a uno degli elementi seguenti:
- File project.json di cui eseguire la migrazione.
- File global.json: viene eseguita la migrazione delle cartelle specificate in global.json.
- File solution.sln: viene eseguita la migrazione dei progetti a cui viene fatto riferimento nella soluzione.
- Directory di cui eseguire la migrazione: vengono cercati in modo ricorsivo i file project.json di cui eseguire la migrazione all'interno della directory specificata.
Se non è specificata alcuna opzione, verrà impostata automaticamente la directory corrente.
--format-report-file-json <REPORT_FILE>
File di report di migrazione dell'output come JSON anziché messaggi utente.
-h|--help
Stampa una breve guida per il comando.
-r|--report-file <REPORT_FILE>
Report di migrazione dell'output a un file oltre che alla console.
-s|--skip-project-references [Debug|Release]
Ignora la migrazione dei riferimenti del progetto. Per impostazione predefinita, i riferimenti al progetto vengono migrati in modo ricorsivo.
--skip-backup
Ignorare lo spostamento di project.json, global.json e .xproj in una directory backup
dopo la migrazione con esito positivo.
-t|--template-file <TEMPLATE_FILE>
File csproj modello da usare per la migrazione. Per impostazione predefinita, viene usato lo stesso modello di quello eliminato da dotnet new console
.
-v|--sdk-package-version <VERSION>
Versione del pacchetto SDK a cui viene fatto riferimento nell'app di cui è stata eseguita la migrazione. Il valore predefinito è la versione dell'SDK in dotnet new
.
-x|--xproj-file <FILE>
Percorso del file xproj da usare. Obbligatorio quando è presente più di un progetto xproj nella directory di un progetto.
Eseguire la migrazione di un progetto nella directory corrente e in tutte le relative dipendenze da progetto a progetto:
dotnet migrate
Eseguire la migrazione di tutti i progetti inclusi nel file global.json:
dotnet migrate path/to/global.json
Eseguire solo la migrazione del progetto corrente e non delle dipendenze da progetto a progetto. Usare una versione specifica dell'SDK:
dotnet migrate -s -v 1.0.0-preview4
Feedback su .NET
.NET è un progetto di open source. Selezionare un collegamento per fornire feedback: