dotnetup kullanmaya başlama

Note

dotnetup genel önizleme aşamasındadır. Özellikleri ve davranışı genel kullanılabilirlik öncesinde değişebilir.

dotnetup, kullanıcı düzeyinde .NET yüklemeleri için platformlar arası bir araç zinciri yöneticisidir. Sistem paketi yöneticisi kullanmadan .NET SDK'ları ve çalışma zamanlarını yükler, güncelleştirir ve kaldırır.

Prerequisites

• Aşağıdaki işletim sistemlerinden ve mimarilerden biri:

  İşletim Sistemi	Architectures
  Windows	x64, Arm64
  macOS	x64, Arm64
  Linux (glibc)	x64, Arm64
  Linux (musl), örneğin Alpine Linux	x64, Arm64

• Bir terminal.

• İndirme betiğini çalıştırmak için macOS veya Linux'ta Bash, Windows'ta ise PowerShell kullanın.

• macOS veya Linux'ta dosyaları indirmek için curl veya wget kullanın ve bunları doğrulamak için sha512sum veya shasum kullanın.

dotnetup.NET Çalışma Zamanı ile aynı işletim sistemi gereksinimlerine sahiptir. İşletim sistemine özgü gereksinimler için bkz. Windows'a .NET yükleme, macOS'a .NET yükleme veya Linux'a .NET yükleme.

Important

Windows'ta varsayılan kurulum everywhere erişim modunu kullanır. Bu mod:

• Sistemi güncelleştirmek için yükseltme PATHgerekir.
• Dotnetup tarafından yönetilen yüklemenin, Visual Studio yüklemeleri gibi makine genelindeki .NET yüklemelerinden öncelikli olmasını sağlar. Makine genelinde, ayrıca dotnetup tarafından yüklenmemiş olan bir SDK'ya veya çalışma zamanına ihtiyaç duyan projeler ve uygulamalar derlenemez veya çalıştırılamaz.
• Tüm kullanıcılar için geçerli olan sistemi PATHdeğiştirir. Diğer kullanıcıların başlattığı yükseltilmiş işlemler, .NET'i kullanıcı profilinizden bulabilir.

Bu etkileri önlemek için kurulum sırasında shell veya none erişim modunu seçin. everywhere seçeneğini belirlerseniz, kurulum önerdiğinde mevcut kurulumlarınızı taşıyın. Ayrıntılar için bkz. Her yerde moduyla ilgili dikkat edilmesi gerekenler.

dotnetup'ı indir

İndirme betikleri varsayılan olarak en son preview derlemeyi yükler. İndirilen yürütülebilir dosyayı SHA-512 sağlama toplamıyla doğrular ve ~/.dotnetup içine yükler.

macOS veya Linux'ta şunu çalıştırın:

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

Windows'da şunu çalıştırın:

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

macOS veya Linux'a en son daily derlemeyi yüklemek için şunu çalıştırın:

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

Windows'ta en son daily derlemeyi yüklemek için şunu çalıştırın:

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

Important

Günlük derlemeler sürüm doğrulamayı tamamlamamış ve imzalanmamıştır. Günlük derlemeleri yalnızca kısa süreli test için kullanın.

Betikler, PATH öğesini dotnetup öğesine eklemeye ilişkin yönergeleri yazdırır. Yönergeleri uyguladıktan sonra yeni bir terminal açın.

İlk kez kurulumu çalıştırın

Etkileşimli kurulumu çalıştırın:

> 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!

Yollar, ilerleme durumu görünümü ve ortam kılavuzu sisteminize ve seçili moda bağlıdır.

Önerilen erişim modu everywhere Windows'ta. macOS ve Linux'ta, dotnetup desteklenen bir kabuk algıladığında durum none, aksi takdirde shell olur.

SDK kanalını, erişim modunu ve geçiş seçeneklerini belirlemek için Hayır, kurulumu özelleştir'i seçin.

Bir SDK kanalı seçin

SDK kanalı, dotnetup öğesine hangi SDK'nın yükleneceğini ve onun nasıl güncelleştirileceğini söyler.

Kanallar formu	Example	Result
En son kararlı sürüm	latest	En son aktif kararlı SDK
En Son LTS	lts	En son desteklenen kararlı LTS SDK'sı
En son önizleme	preview	En son önizleme SDK'sı
En son günlük sürüm	daily	En son kullanılabilir günlük SDK
Binbaşı	10	Belirtilen ana sürüm için en son SDK
Büyük ve küçük	10.0	Belirtilen ana ve ikincil sürüm için en son SDK
Özellik şeridi	10.0.1xx	Belirtilen özellik bandında en son SDK
Tam olarak aynı sürüm	10.0.103	Yalnızca belirtilen SDK sürümü
İlk SDK yok	none	Kurulum sırasında kurulumu atla

Belirli sürümler güncelleştirmeler sırasında ilerlemez. Kabul edilen tüm formlar için bkz. dotnetup kanalları ve sürümleri.

.NET'e nasıl erişeceğinizi seçin

Erişim modu, terminallerin ve uygulamaların dotnetup tarafından yönetilen .NET yüklemesini nasıl bulacağını denetler.

Erişim modu	Behavior
none	Bu ortam değişkenlerini değiştirmez. dotnetup dotnet ile .NET'i çalıştırın.
shell	Bu ortam değişkenlerini ayarlamak için kabuk profilini değiştirir. Bu kabuktan başlatılan işlemler, dotnetup tarafından yüklenen .NET SDK'ları ve Çalışma Zamanlarını kullanır.
everywhere	Sistemi PATH değiştirir ve kullanıcı düzeyi DOTNET_ROOT ortam değişkenini ayarlar. Yalnızca Windows'ta kullanılabilir.

everywhere modu için daha fazla ayrıntı ve dikkat edilmesi gereken noktalar için bkz. dotnetup ortam yapılandırması.

Mevcut kurulumları taşıma

Kurulum, mevcut makine genelindeki .NET SDK ve Çalışma Zamanı yüklemelerini dotnetup tarafından yönetilen yüklemeye geçirmeyi önerebilir. Geçişin özellikle everywhere moduyla neden önemli olduğunu öğrenmek için Her yerde modu ile ilgili dikkat edilmesi gerekenler bölümüne bakın.

Kurulumu doğrulama

Kurulum ortamınızda değişiklik yaptıktan sonra yeni bir terminal açın.

everywhere veya shell modu için şunu çalıştırın:

dotnet --version
dotnetup list

none modu için şunu çalıştırın:

dotnetup dotnet -- --version
dotnetup list

Kurulumu değiştirmek için yeniden çalıştırın dotnetup init .