dotnet migrasi
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