dotnet migreren

  • Artikel

Dit artikel is van toepassing op: ✔️ .NET Core 2.x SDK

Naam

dotnet migrate - Migreert een Preview 2 .NET Core-project naar een .NET Core SDK-project.

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

Beschrijving

Deze opdracht is afgeschaft. De dotnet migrate opdracht is niet meer beschikbaar vanaf .NET Core 3.0 SDK. Het kan alleen een Preview 2 .NET Core-project migreren naar een 1.x .NET Core-project, dat niet meer wordt ondersteund.

Standaard migreert de opdracht het hoofdproject en eventuele projectverwijzingen die het hoofdproject bevat. Dit gedrag is uitgeschakeld met behulp van de --skip-project-references optie tijdens runtime.

Migratie kan worden uitgevoerd op de volgende assets:

  • Eén project door het project.json-bestand op te geven dat moet worden gemigreerd.
  • Alle mappen die zijn opgegeven in het bestand global.json door te geven in een pad naar het bestand global.json .
  • Een bestand solution.sln , waarin de projecten waarnaar in de oplossing wordt verwezen, worden gemigreerd.
  • In alle submappen van de opgegeven map recursief.

Met de dotnet migrate opdracht wordt het gemigreerde bestand project.json in een backup map bewaard, die wordt gemaakt als de map niet bestaat. Dit gedrag wordt overschreven met behulp van de --skip-backup optie.

De migratiebewerking voert standaard de status van het migratieproces uit naar standaarduitvoer (STDOUT). Als u de --report-file <REPORT_FILE> optie gebruikt, wordt de uitvoer opgeslagen in het opgegeven bestand.

De dotnet migrate opdracht ondersteunt alleen geldige Preview 2 project.json-projecten. Dit betekent dat u deze niet kunt gebruiken om DNX- of Preview 1 project.json-projecten rechtstreeks te migreren naar MSBuild/csproj-projecten. U moet het project eerst handmatig migreren naar een preview 2 project.json-project en vervolgens de dotnet migrate opdracht gebruiken om het project te migreren.

Argumenten

PROJECT_JSON/GLOBAL_JSON/SOLUTION_FILE/PROJECT_DIR

Het pad naar een van de volgende opties:

  • een project.json-bestand dat moet worden gemigreerd.
  • een global.json-bestand : de mappen die zijn opgegeven in global.json worden gemigreerd.
  • een solution.sln-bestand : de projecten waarnaar in de oplossing wordt verwezen, worden gemigreerd.
  • een map die moet worden gemigreerd: recursief zoekt naar project.json-bestanden die moeten worden gemigreerd in de opgegeven map.

De standaardinstelling is de huidige map als er niets is opgegeven.

Opties

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

Voer het migratierapportbestand uit als JSON in plaats van gebruikersberichten.

-h|--help

Hiermee wordt een korte help voor de opdracht afgedrukt.

-r|--report-file <REPORT_FILE>

Voer een migratierapport uit naar een bestand naast de -console.

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

Het migreren van projectverwijzingen overslaan. Standaard worden projectverwijzingen recursief gemigreerd.

--skip-backup

Sla het verplaatsen van project.json, global.json en *.xproj naar een map over na een backup geslaagde migratie.

-t|--template-file <TEMPLATE_FILE>

Csproj-sjabloonbestand dat moet worden gebruikt voor migratie. Standaard wordt dezelfde sjabloon gebruikt als de sjabloon die door is verwijderd dotnet new console .

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

De versie van het SDK-pakket waarnaar wordt verwezen in de gemigreerde app. De standaardwaarde is de versie van de SDK in dotnet new.

-x|--xproj-file <FILE>

Het pad naar het xproj-bestand dat moet worden gebruikt. Vereist wanneer een projectmap meer dan één xproj bevat.

Voorbeelden

Migreer een project in de huidige map en alle bijbehorende project-naar-project-afhankelijkheden:

dotnet migrate

Migreer alle projecten die het bestand global.json bevat:

dotnet migrate path/to/global.json

Migreer alleen het huidige project en geen P2P-afhankelijkheden (project-naar-project). Gebruik ook een specifieke SDK-versie:

dotnet migrate -s -v 1.0.0-preview4