Dela via

dotnet migrate

  • Artikel

Den här artikeln gäller för: ✔️ .NET Core 2.x SDK

Name

dotnet migrate – Migrerar ett .NET Core-projekt i förhandsversion 2 till ett .NET Core SDK-projekt.

Synopsis

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

Description

Det här kommandot är inaktuellt. Kommandot dotnet migrate är inte längre tillgängligt från och med .NET Core 3.0 SDK. Det kan bara migrera ett .NET Core-projekt för förhandsversion 2 till ett 1.x .NET Core-projekt, vilket inte stöds.

Som standard migrerar kommandot rotprojektet och alla projektreferenser som rotprojektet innehåller. Det här beteendet inaktiveras med --skip-project-references alternativet vid körning.

Migrering kan utföras på följande tillgångar:

  • Ett enskilt projekt genom att ange filen project.json som ska migreras.
  • Alla kataloger som anges i filen global.json genom att skicka in en sökväg till filen global.json .
  • En solution.sln-fil där den migrerar de projekt som refereras i lösningen.
  • Rekursivt på alla underkataloger i den angivna katalogen.

Kommandot dotnet migrate behåller den migrerade project.json-filen i en backup katalog, vilket skapas om katalogen inte finns. Det här beteendet åsidosättas med hjälp av --skip-backup alternativet .

Som standard matar migreringsåtgärden ut tillståndet för migreringsprocessen till standardutdata (STDOUT). Om du använder --report-file <REPORT_FILE> alternativet sparas utdata i den angivna filen.

Kommandot dotnet migrate stöder endast giltiga project.json-baserade projekt i förhandsversion 2. Det innebär att du inte kan använda den för att migrera DNX- eller Preview 1-projekt.json-baserade projekt direkt till MSBuild/csproj-projekt. Du måste först migrera projektet manuellt till ett Project.json-baserat projekt för förhandsversion 2 och sedan använda dotnet migrate kommandot för att migrera projektet.

Argument

PROJECT_JSON/GLOBAL_JSON/SOLUTION_FILE/PROJECT_DIR

Sökvägen till något av följande:

  • en project.json-fil som ska migreras.
  • en global.json-fil : mapparna som anges i global.json migreras.
  • en solution.sln-fil : de projekt som refereras i lösningen migreras.
  • en katalog att migrera: söker rekursivt efter project.json-filer som ska migreras i den angivna katalogen.

Standardvärdet är aktuell katalog om inget har angetts.

Alternativ

--format-report-file-json <REPORT_FILE>

Rapportfil för utdatamigrering som JSON i stället för användarmeddelanden.

-h|--help

Skriver ut en kort hjälp för kommandot.

-r|--report-file <REPORT_FILE>

Utdatamigreringsrapport till en fil utöver -konsolen.

-s|--skip-project-references [Debug|Release]

Hoppa över att migrera projektreferenser. Som standard migreras projektreferenser rekursivt.

--skip-backup

Hoppa över att flytta project.json, global.json och *.xproj till en backup katalog efter lyckad migrering.

-t|--template-file <TEMPLATE_FILE>

Csproj-mallfil som ska användas för migrering. Som standard används samma mall som den som släpptes av dotnet new console .

-v|--sdk-package-version <VERSION>

Den version av sdk-paketet som refereras i den migrerade appen. Standardvärdet är versionen av SDK:et i dotnet new.

-x|--xproj-file <FILE>

Sökvägen till xproj-filen som ska användas. Krävs när det finns mer än en xproj i en projektkatalog.

Exempel

Migrera ett projekt i den aktuella katalogen och alla dess projekt-till-projekt-beroenden:

dotnet migrate

Migrera alla projekt som global.json-filen innehåller:

dotnet migrate path/to/global.json

Migrera endast det aktuella projektet och inga P2P-beroenden (project-to-project). Använd också en specifik SDK-version:

dotnet migrate -s -v 1.0.0-preview4