Delen via

dotnet-migratie

  • Artikel

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

Naam

dotnet migrate: migreert een .NET Core-project van preview 2 naar een .NET Core SDK-project.

Samenvatting

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 opdracht dotnet migrate is niet meer beschikbaar vanaf .NET Core 3.0 SDK. Het kan alleen een Preview 2 .NET Core-project migreren naar een .NET Core-project van 1.x, dat niet wordt ondersteund.

De opdracht migreert standaard het hoofdproject en eventuele projectverwijzingen die het hoofdproject bevat. Dit gedrag wordt uitgeschakeld met behulp van de optie --skip-project-references 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 global.json-bestand door een pad door te geven naar het global.json-bestand.
  • Een solution.sln(x)-bestand, waar de projecten waarnaar in de oplossing wordt verwezen, worden gemigreerd.
  • In alle submappen van de opgegeven map recursief.

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

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

De opdracht dotnet migrate ondersteunt alleen geldige projecten op basis van preview 2 project.json. 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 op preview 2 project.jsongebaseerd project en vervolgens de opdracht dotnet migrate 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(x) bestand: de projecten waarnaar in de oplossing wordt verwezen, worden gemigreerd.
  • een map die moet worden gemigreerd: zoekt recursief naar project.json bestanden die in de opgegeven map moeten worden gemigreerd.

Standaard ingesteld op de huidige map als er niets is opgegeven.

Opties

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

Uitvoermigratierapportbestand als JSON in plaats van gebruikersberichten.

-h|--help

Hiermee drukt u een korte help voor de opdracht af.

-r|--report-file <REPORT_FILE>

Uitvoermigratierapport naar een bestand naast de console.

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

Sla de migratie van projectverwijzingen over. Standaard worden projectverwijzingen recursief gemigreerd.

--skip-backup

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

-t|--template-file <TEMPLATE_FILE>

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

-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 er meer dan één xproj in een projectmap staat.

Voorbeelden

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

dotnet migrate

Migreer alle projecten die global.json bestand omvat:

dotnet migrate path/to/global.json

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

dotnet migrate -s -v 1.0.0-preview4