Mulai menggunakan dotnetup

Note

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

dotnetupadalah manajer toolchain lintas platform untuk penginstalan .NET tingkat pengguna. Ini menginstal, memperbarui, dan menghapus SDK dan runtime .NET tanpa menggunakan manajer paket sistem.

Prerequisites

• Salah satu sistem operasi dan arsitektur berikut:

  Sistem operasi	Architectures
  Windows	x64, Arm64
  macOS	x64, Arm64
  Linux (glibc)	x64, Arm64
  Linux (musl), seperti Alpine Linux	x64, Arm64

• Sebuah terminal.

• Bash di macOS atau Linux, atau PowerShell di Windows, untuk menjalankan skrip unduhan.

• Di macOS atau Linux, gunakan curl atau wget untuk mengunduh file, dan sha512sum atau shasum untuk memverifikasinya.

dotnetupmemiliki persyaratan sistem operasi yang sama dengan .NET Runtime. Untuk persyaratan khusus OS, lihat Menginstal .NET di Windows, Menginstal .NET di macOS, atau Menginstal .NET di Linux.

Important

Pada Windows, penyiapan default menggunakan everywhere mode akses. Mode ini:

• Memerlukan hak admin untuk memperbarui sistem PATH.
• Membuat penginstalan yang dikelola dotnetup lebih diutamakan daripada penginstalan .NET di seluruh komputer, seperti yang diinstal oleh Visual Studio. Proyek dan aplikasi yang memerlukan SDK atau runtime di seluruh sistem yang tidak juga diinstal oleh dotnetup gagal dibangun atau dijalankan.
• Mengubah sistem PATH, yang berlaku untuk semua pengguna. Proses dengan hak akses lebih tinggi yang dimulai oleh pengguna lain mungkin memuat .NET dari profil pengguna Anda.

Untuk menghindari efek ini, pilih mode akses none atau shell selama penyiapan. Jika Anda memilih everywhere, migrasikan penginstalan yang ada saat penyiapan menawarkannya. Untuk detailnya, lihat Pertimbangan Everywhere mode.

Unduh dotnetup

Skrip unduhan menginstal build terbaru preview secara default. Mereka memverifikasi executable yang diunduh dengan checksum SHA-512 dan menginstalnya di ~/.dotnetup.

Di macOS atau Linux, jalankan:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh | bash

Pada Windows, jalankan:

irm https://aka.ms/dotnetup/get-dotnetup.ps1 | iex

Untuk menginstal build terbaru daily di macOS atau Linux, jalankan:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh |
  bash -s -- --quality daily

Untuk menginstal build terbaru daily pada Windows, jalankan:

iex "& { $(irm https://aka.ms/dotnetup/get-dotnetup.ps1) } -Quality daily"

Important

Build harian belum menyelesaikan validasi rilis dan tidak ditandatangani secara digital. Gunakan build harian hanya untuk pengujian berumur pendek.

Skrip mencetak instruksi untuk menambahkan dotnetup ke PATH. Buka terminal baru setelah Anda menerapkan instruksi.

Jalankan penyiapan awal

Jalankan penyiapan interaktif:

> dotnetup init
Welcome to dotnetup!

SDK Channel: latest
Mode: <recommended-mode> (Suggested)

<recommended-mode> modifies <configuration-target> to set PATH and DOTNET_ROOT to prefer <install-path>.

Would you like to install .NET with the recommended settings?
> Yes, proceed with defaults and install

Installing SDK <resolved-version> to <install-path>...
<download and installation progress>
Installed at <install-path>:
  SDK <resolved-version>
<mode-specific environment guidance>
Setup complete!

Jalur, tampilan kemajuan, dan panduan lingkungan bergantung pada sistem Anda dan mode yang dipilih.

Mode akses yang disarankan adalah everywhere di Windows. Di macOS dan Linux, ini adalah shell saat dotnetup mendeteksi shell yang didukung dan none jika tidak.

Pilih Tidak, sesuaikan penyiapan untuk memilih saluran SDK, mode akses, dan opsi migrasi.

Pilih saluran SDK

Saluran SDK memberi tahu dotnetup SDK mana yang akan diinstal dan cara memperbaruinya.

Formulir kanal	Example	Result
Versi stabil terbaru	latest	SDK aktif stabil terbaru
LTS Terbaru	lts	SDK LTS stabil yang aktif terbaru
Pratinjau terbaru	preview	SDK pratinjau terbaru
Terbaru harian	daily	SDK harian terbaru yang tersedia
Utama	10	SDK terbaru untuk versi utama yang ditentukan
Major dan minor	10.0	SDK terbaru untuk versi utama dan minor yang ditentukan
Pita fitur	10.0.1xx	SDK terbaru dalam feature band yang ditentukan
Versi persis	10.0.103	Hanya versi SDK yang ditentukan
Tidak ada SDK awal	none	Lewati penginstalan selama penyiapan

Versi yang tepat tidak berubah selama pembaruan. Untuk semua bentuk yang diterima, lihat saluran dan versi dotnetup.

Pilih cara mengakses .NET

Mode akses mengontrol bagaimana terminal dan aplikasi menemukan penginstalan .NET yang dikelola dotnetup.

Mode akses	Behavior
none	Tidak mengubah variabel lingkungan ini. Jalankan .NET dengan dotnetup dotnet.
shell	Memodifikasi profil shell untuk mengatur variabel lingkungan ini. Proses dimulai dari shell tersebut menggunakan .NET SDK dan Runtime yang diinstal oleh dotnetup.
everywhere	Memodifikasi sistem PATH dan mengatur variabel lingkungan DOTNET_ROOT tingkat pengguna. Hanya tersedia di Windows.

Untuk detail dan pertimbangan selengkapnya untuk everywhere mode, lihat konfigurasi lingkungan dotnetup.

Migrasikan instalasi yang ada

Penyiapan dapat menawarkan untuk memigrasikan penginstalan SDK dan Runtime .NET seluruh mesin yang ada ke dalam penginstalan yang dikelola dotnetup. Lihat Pertimbangan mode Everywhere untuk mengetahui alasan migrasi sangat penting dengan mode everywhere.

Periksa penyiapan

Buka terminal baru setelah penyiapan mengubah lingkungan Anda.

Untuk shell mode atau everywhere , jalankan:

dotnet --version
dotnetup list

Untuk none mode, jalankan:

dotnetup dotnet -- --version
dotnetup list

Jalankan dotnetup init lagi untuk mengubah penyetelan.