Menginstal SDK untuk repositori dengan dotnetup

Note

dotnetup berada dalam pratinjau publik. Fitur dan perilakunya mungkin berubah sebelum ketersediaan umum.

Ketika Anda tidak menyediakan saluran SDK, dotnetup sdk install mencari dari direktori saat ini ke akar sistem file. Ini menggunakan file yang sudah ada dan paling dekat global.json. Jika file tersebut berformat salah, perintah gagal alih-alih mencari direktori induk. Jika tidak ada file, sistem menggunakan latest.

Instal dependensi repositori

Dari direktori repositori, jalankan:

dotnetup sdk install

Untuk file ini global.json , dotnetup melacak 10.0.1xx pita fitur:

{
  "sdk": {
    "version": "10.0.103",
    "rollForward": "latestPatch"
  }
}

Jalur global.json adalah sumber requirement yang tersimpan. Anda dapat melihat sumber dan versi yang diinstal dengan:

dotnetup list

Memahami pemetaan roll-forward

Untuk versi SDK seperti 10.0.103, dotnetup memetakan rollForward sebagai berikut:

rollForward Nilai Saluran dotnetup yang tersimpan
Dihilangkan atau latestPatch 10.0.1xx
latestFeature 10.0
latestMinor 10
latestMajor latest
disable, patch, feature, minor, atau major Versi yang tepat 10.0.103

Persyaratan yang tepat disematkan dan tidak diubah oleh dotnetup update. Properti allowPrerelease tidak memengaruhi saluran yang diturunkan dotnetup.

Gunakan sdk.paths

Jika global.json mencakup sdk.paths, dotnetup menggunakan jalur pertama saat opsi --install-path tidak ada. Ini menentukan nilai relatif dari direktori yang berisi global.json.

Prioritas jalur penginstalan adalah:

  1. --install-path
  2. Entri pertama sdk.paths
  3. Akar instalasi .NET default yang dikelola dotnetup

Pratinjau batasan

Build pratinjau publik saat ini memperlakukan entri pertama sdk.paths sebagai jalur. Ini tidak menafsirkan $host$ sebagai sentinel atau melewati entri kosong. Untuk menggunakan akar penginstalan default yang dikelola dotnetup, hilangkan sdk.paths atau atur --install-path secara eksplisit.

Pembaruan global.json

Setelah Anda mengubah sdk.version atau rollForward, jalankan dotnetup sdk install dari direktori repositori untuk menerapkan persyaratan baru. Sebelum garbage collection memuat ulang sumber yang diubah global.json, dotnetup sdk update proses telah menyimpan persyaratan, sehingga lulus pertamanya mungkin masih menggunakan persyaratan sebelumnya.

Untuk menginstal versi terbaru di saluran turunan dan menulis versi tersebut kembali ke global.json, jalankan:

dotnetup sdk install --update-global-json

Kemudian, perbarui semua persyaratan repositori terlacak dan filenya dengan:

dotnetup sdk update --update-global-json

Hanya sdk.version yang berubah. Ini mempertahankan pemformatan yang ada, properti lain, dan pengodean teks yang terdeteksi.

Hapus persyaratan repositori yang cocok

Perintah hapus instalan menghapus setiap spesifikasi yang cocok globaljson di akar penginstalan yang dipilih. Ini tidak menargetkan satu repositori pun. Untuk menghapus persyaratan yang cocok dari akar default, jalankan:

dotnetup sdk uninstall 10.0.1xx --source globaljson

Untuk memilih direktori root penginstalan kustom, tambahkan --install-path:

dotnetup sdk uninstall 10.0.1xx --source globaljson --install-path <INSTALL_PATH>

dotnetup menghapus file hanya ketika tidak ada persyaratan yang tersisa yang membutuhkannya.

Baca juga