dotnet migrasi

  • Artikel

Artikel ini berlaku untuk: ✔️ .NET Core 2.x SDK

Nama

dotnet migrate - Memigrasikan proyek Pratinjau 2 .NET Core ke proyek gaya .NET Core SDK.

Sinopsis

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

Deskripsi

Perintah ini tidak digunakan lagi. Perintah dotnet migrate tidak lagi tersedia dimulai dengan .NET Core 3.0 SDK. Ini hanya dapat memigrasikan proyek Pratinjau 2 .NET Core ke proyek 1.x .NET Core, yang tidak didukung.

Secara default, perintah memigrasikan proyek akar dan referensi proyek apa pun yang dikandung proyek akar. Perilaku ini dinonaktifkan menggunakan opsi pada --skip-project-references durasi.

Migrasi dapat dilakukan pada aset berikut:

  • Satu proyek dengan menentukan file project.json yang akan dimigrasikan.
  • Semua direktori yang ditentukan dalam file global.json dengan meneruskan jalur ke file global.json .
  • File solution.sln , tempat memigrasikan proyek yang direferensikan dalam solusi.
  • Pada semua subdirektori direktori yang diberikan secara rekursif.

Perintah dotnet migrate menyimpan file project.json yang dimigrasikan di dalam backup direktori, yang dibuatnya jika direktori tidak ada. Perilaku ini ditimpa menggunakan --skip-backup opsi .

Secara default, operasi migrasi menghasilkan status proses migrasi ke output standar (STDOUT). Jika Anda menggunakan --report-file <REPORT_FILE> opsi , output disimpan ke file yang ditentukan.

Perintah dotnet migrate hanya mendukung proyek berbasis project.json Pratinjau 2 yang valid. Ini berarti Anda tidak dapat menggunakannya untuk memigrasikan proyek berbasis project.json DNX atau Pratinjau 1 langsung ke proyek MSBuild/csproj. Pertama-tama Anda perlu memigrasikan proyek secara manual ke proyek berbasis project.json Pratinjau 2 lalu menggunakan dotnet migrate perintah untuk memigrasikan proyek.

Argumen

PROJECT_JSON/GLOBAL_JSON/SOLUTION_FILE/PROJECT_DIR

Jalur ke salah satu hal berikut ini:

  • file project.json untuk dimigrasikan.
  • file global.json : folder yang ditentukan di global.json dimigrasikan.
  • file solution.sln : proyek yang dirujuk dalam solusi dimigrasikan.
  • direktori yang akan dimigrasikan: secara rekursif mencari file project.json untuk dimigrasikan di dalam direktori yang ditentukan.

Default ke direktori saat ini jika tidak ada yang ditentukan.

Opsi

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

Output file laporan migrasi sebagai JSON daripada pesan pengguna.

-h|--help

Mencetak bantuan singkat untuk perintah.

-r|--report-file <REPORT_FILE>

Laporan migrasi output ke file selain konsol.

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

Lewati migrasi referensi proyek. Secara default, referensi proyek dimigrasikan secara rekursif.

--skip-backup

Lewati pemindahan project.json, global.json, dan *.xproj ke backup direktori setelah migrasi berhasil.

-t|--template-file <TEMPLATE_FILE>

File csproj templat yang digunakan untuk migrasi. Secara default, templat yang sama dengan templat yang dihilangkan dotnet new console digunakan.

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

Versi paket sdk yang dirujuk di aplikasi yang dimigrasikan. Defaultnya adalah versi SDK di dotnet new.

-x|--xproj-file <FILE>

Jalur ke file xproj yang akan digunakan. Diperlukan ketika ada lebih dari satu xproj dalam direktori proyek.

Contoh

Migrasikan proyek di direktori saat ini dan semua dependensi proyek-ke-proyeknya:

dotnet migrate

Migrasikan semua proyek yang mencakup file global.json :

dotnet migrate path/to/global.json

Migrasikan hanya proyek saat ini dan tidak ada dependensi project-to-project (P2P). Selain itu, gunakan versi SDK tertentu:

dotnet migrate -s -v 1.0.0-preview4