dotnet iş yükü yükleme

Bu makale şu sürümler için geçerlidir: ✔️ .NET 6 SDK ve sonraki sürümleri

Name

dotnet workload install - İsteğe bağlı iş yüklerini yükleme.

Özet

dotnet workload install <WORKLOAD_ID>...
    [--configfile <FILE>] [--disable-parallel]
    [--ignore-failed-sources] [--include-previews] [--interactive]
    [--no-cache] [--skip-manifest-update]
    [--source <SOURCE>] [--temp-dir <PATH>] [-v|--verbosity <LEVEL>]

dotnet workload install -?|-h|--help

Description

Komutu, dotnet workload install bir veya daha fazla isteğe bağlı iş yükü yüklür. isteğe bağlı iş yükleri , .NET MAUI ve Blazor WebAssembly AOTgibi çeşitli uygulama türleri için destek sağlamak üzere .NET SDK'sı üzerine yükleyebilir.

Yüklemek için kullanabileceğiniz iş yüklerini öğrenmek için dotnet iş yükü aramasını kullanın.

Yükseltilmiş çalıştırma zamanları

Korumalı bir dizine yüklenmiş macOS ve Linux SDK yüklemeleri için komutun yükseltilmiş olarak çalışması gerekir (komutunu sudo kullanın). Bu Windows, SDK Program Files dizinine yüklenmiş olsa bile komutunun yükseltilmiş olarak çalışmasına gerek yoktur. Bu Windows, bu konum için MSI yükleyicilerini kullanır.

Sonuçlar SDK sürümüne göre değişiklik gösterir

Komutlar dotnet workload belirli SDK sürümleri bağlamında çalışır. Hem .NET 6.0.100 SDK hem de .NET 6.0.200 SDK'sı yüklü olduğunu varsayalım. dotnet workloadKomutlar, seçtiğiniz SDK sürümüne bağlı olarak farklı sonuçlar verir. Bu davranış, düzeltme eki sürümü farklılıkları için değil ana ve ikincil sürüm ve özellik bant farkları için geçerlidir. Örneğin, .NET SDK 6.0.101 ve 6.0.102 aynı sonuçları verirken, 6.0.100 ve 6.0.200 farklı sonuçlar verir. SDK sürümünü global.json dosyasını veya komutların --sdk-version seçeneğini kullanarak dotnet workload belirtebilirsiniz.

Reklam bildirimleri

İş yükü yüklemesi için gereken varlıkların adları ve sürümleri bildirimlerinde korunur. Varsayılan olarak, dotnet workload install komut bir iş yükü yüklemeden önce kullanılabilir en son bildirimleri indirir. Daha sonra bir bildirimin yerel kopyası, bir iş yükünün varlıklarını bulmak ve indirmek için gereken bilgileri sağlar.

komutu dotnet workload list yüklü iş yüklerinin sürümlerini şu anda kullanılabilen sürümlerle karşılaştırıldığında. Yüklü sürümden daha yeni bir sürümün kullanılabilir olduğunu bulduğunda, bu gerçeği komut çıkışında tanıtıyor. sürümündeki bu yeni sürüm bildirimleri dotnet workload list .NET 6'dan başlayarak kullanılabilir.

Bu bildirimleri etkinleştirmek için, bildirimlerin kullanılabilir en son sürümleri indirilir ve reklam bildirimleri olarak depolanır. Bu indirmeler, aşağıdaki komutlardan herhangi biri çalıştır olduğunda arka planda zaman uyumsuz olarak uzer.

Bildirim indirmesi bitmeden önce bir komut biterse, indirme durdurulur. Bu komutlardan biri bir sonraki çalıştırılanda indirme yeniden deneniyor. Bu arka plan indirmelerini devre dışı bırakmak veya sıklıklarını kontrol etmek için ortam değişkenlerini ayarlayın. Varsayılan olarak, bunlar günde birden fazla kez olmaz.

seçeneğini kullanarak dotnet workload install komutun bildirim indirmeleri yapmalarını --skip-manifest-update önlebilirsiniz.

Komut dotnet workload update ayrıca reklam bildirimlerini indirir. Bir güncelleştirmenin kullanılabilir olup olmadığını öğrenmek için indirmeler gereklidir, bu nedenle, bu güncelleştirmelerin çalıştırılamalarını engelleme seçeneği yoktur. Ancak, iş yükü güncelleştirmelerini --advertising-manifests-only atlamak ve yalnızca bildirim indirmelerini yapmak için seçeneğini kullanabilirsiniz. Bu seçenek .NET 6'dan başlayarak kullanılabilir.

Bağımsız değişkenler

Seçenekler

  • --configfile <FILE>

    NuGet yapılandırma dosyası (nuget.config) . Belirtilirse, yalnızca bu dosyanın ayarları kullanılır. Belirtilmezse, geçerli dizinden yapılandırma dosyalarının hiyerarşisi kullanılır. Daha fazla bilgi için bkz. Ortak NuGet Yapılandırmaları.

  • --disable-parallel

    Birden çok proje paralel olarak geri yüklemeyi önler.

  • -?|-h|--help

    Komutunun nasıl kullanıla ilgili bir açıklama yazdırır.

  • --ignore-failed-sources

    Paket kaynak hatalarına uyarı olarak davranır.

  • --include-previews

    Ön bildirim iş yükü bildirimlerine izin verir.

  • --interactive

    Komutun kullanıcı girişini veya eylemlerini durdurması ve beklemesini sağlar. Örneğin, kimlik doğrulamasını tamamlamak için.

  • --no-cache

    Paketlerin ve http isteklerinin önbelleğe alınmasını önler.

  • --skip-manifest-update

    İş yükü bildirimlerinin güncelleştirilmesini atlayın. İş yükü bildirimleri, her iş yükü için hangi varlıkların ve sürümlerin yüklü olması gerektiğini tanımlar.

  • -s|--source <SOURCE>

    Hangi paket kaynağının NuGet URI'sı belirtir. Bu ayar, dosyalarda belirtilen tüm kaynakları nuget.config geçersiz kılar. Bu seçenek birden çok kez belirterek birden çok kaynak sağlanmalıdır.

  • --temp-dir <PATH>

    Paketleri indirmek ve ayıklamak için kullanılan geçici NuGet (güvenli olmalıdır) belirtin.

  • -v|--verbosity <LEVEL>

    Komutun ayrıntı düzeyini ayarlar. İzin verilen değerler,,, q[uiet] m[inimal] n[ormal] d[etailed] ve diag[nostic] . Varsayılan değer: minimal. Belirtin detailed veya diagnostic ayrıntı düzeyi belirtirseniz, komut Indirdiği NuGet paketleri hakkındaki bilgileri görüntüler.

Örnekler

  • İş yükünü maui yükleyin:

    dotnet workload install maui
    
  • ve iş maui-android maui-ios yüklerini yükleyin:

    dotnet workload install maui-android maui-ios