dotnet workload install

  • Makale

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

Veri Akışı Adı

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

Ö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>] [--version <VERSION>]

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

Açıklama

komutu bir dotnet workload install veya daha fazla isteğe bağlı iş yükü yükler. .NET MAUI ve Blazor WebAssembly AOT gibi çeşitli uygulama türleri için destek sağlamak için isteğe bağlı iş yükleri .NET SDK'sının üzerine yüklenebilir.

Komut workload-set güncelleştirme modundayken iş yükü sürümleri yüklenir:

  • Bir global.json veya seçenekte belirtilen en son iş yükü kümesinden veya --version iş yükü kümesi sürümündendir.
  • Her bir iş yükünün en son sürümü olmayabilir. Örneğin, install bayrağını daha önce kullandıysanız --version komut daha yeni bir iş yükü kümesi yüklemez.

Daha fazla bilgi için bkz . .NET SDK iş yükü kümeleri. workload-set güncelleştirme modu 8.0.400 SDK'dan itibaren kullanılabilir.

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

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

Korumalı bir dizine yüklenen macOS ve Linux SDK yüklemeleri için komutun yükseltilmiş olarak çalıştırılması gerekir (komutunu kullanın sudo ). Windows'da, SDK Program Files dizinine yüklenmiş olsa bile komutun yükseltilmiş olarak çalıştırılması gerekmez. Windows için komut, 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. Komutlar dotnet workload , seçtiğiniz SDK sürümüne bağlı olarak farklı sonuçlar verir. Bu davranış, sürüm farklılıklarına düzeltme eki uygulamak için değil, ana ve ikincil sürüm ve özellik bandı farklılıkları 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. global.json dosyasını kullanarak SDK sürümünü belirtebilirsiniz.

Reklam bildirimleri

Bir iş yükü yüklemesinin gerektirdiği varlıkların adları ve sürümleri bildirimlerde tutulur. Varsayılan olarak, dotnet workload install komut bir iş yükü yüklemeden önce en son kullanılabilir bildirimleri indirir. Bildirimin yerel kopyası, bir iş yükünün varlıklarını bulmak ve indirmek için gereken bilgileri sağlar.

dotnet workload list komutu, yüklü iş yüklerinin sürümlerini şu anda kullanılabilir olan sürümlerle karşılaştırır. Yüklü sürümden daha yeni bir sürümün kullanılabilir olduğunu bulduğunda, bu olguyu komut çıkışında tanıtır. içindeki dotnet workload list bu yeni sürüm bildirimleri .NET 6'dan itibaren kullanılabilir.

Bu bildirimleri etkinleştirmek için bildirimlerin kullanılabilir en son sürümleri indirilir ve reklam bildirimleri olarak depolanır. Aşağıdaki komutlardan herhangi biri çalıştırıldığında bu indirmeler arka planda zaman uyumsuz olarak gerçekleşir.

Bildirim indirme işlemi tamamlanmadan önce bir komut biterse, indirme durdurulur. Bu komutlardan biri bir sonraki çalıştırıldığında indirme işlemi yeniden denenecektir. Ortam değişkenlerini bu arka plan indirmelerini devre dışı bırakmak veya sıklıklarını denetlemek için ayarlayabilirsiniz. Varsayılan olarak, bunlar günde birden fazla kez gerçekleşmez.

seçeneğini kullanarak --skip-manifest-update komutun dotnet workload install bildirim indirmeleri yapmasını engelleyebilirsiniz.

Komut ayrıca dotnet workload update reklam bildirimlerini de indirir. İndirmeler, bir güncelleştirme olup olmadığını öğrenmek için gereklidir, bu nedenle bunların çalışmasını engelleme seçeneği yoktur. Ancak, iş yükü güncelleştirmelerini atlamak ve yalnızca bildirim indirmelerini yapmak için seçeneğini kullanabilirsiniz --advertising-manifests-only . Bu seçenek .NET 6'dan itibaren kullanılabilir.

Bağımsız değişkenler

  • WORKLOAD_ID...

    Yüklenecek iş yükü kimliği veya birden çok kimlik. Hangi iş yüklerinin kullanılabilir olduğunu öğrenmek için dotnet iş yükü aramasını kullanın.

Seçenekler

  • --configfile <FILE>

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

  • --disable-parallel

    Birden çok projenin paralel olarak geri yüklenmesini engeller.

  • -?|-h|--help

    komutunun nasıl kullanılacağına ilişkin bir açıklama yazdırır.

  • --ignore-failed-sources

    Paket kaynağı hatalarını uyarı olarak ele alır.

  • --include-previews

    ön sürüm iş yükü bildirimlerine izin verir.

  • --interactive

    Komutun durmasına ve kullanıcı girişini veya eylemini beklemesine izin verir. Örneğin, kimlik doğrulamasını tamamlamak için.

  • --no-cache

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

  • --skip-manifest-update

    İş yükü bildirimlerini güncelleştirme işlemini atlayın. İş yükü bildirimleri, her iş yükü için hangi varlıkların ve sürümlerin yüklenmesi gerektiğini tanımlar.

  • -s|--source <SOURCE>

    Kullanılacak NuGet paket kaynağının URI'sini belirtir. Bu ayar, nuget.config dosyalarında belirtilen tüm kaynakları geçersiz kılar. Bu seçenek birden çok kez belirtilerek birden çok kaynak sağlanabilir.

  • --temp-dir <PATH>

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

  • -v|--verbosity <LEVEL>

    Komutun ayrıntı düzeyini ayarlar. İzin verilen değerler , m[inimal], n[ormal], d[etailed]ve diag[nostic]değerleridirq[uiet]. Varsayılan değer: minimal. Veya diagnostic ayrıntı belirtirsenizdetailed, komut indirmiş olduğu Nuget paketleri hakkındaki bilgileri görüntüler.

  • --version

    Yüklenecek veya güncelleştirilecek iş yükü kümesi sürümü. İş yükü kümesi sürümünü global.json belirtirseniz, iş yükü kümesi sürümünü belirtmek için seçeneğini kullanamazsınız --version . Bu durumda seçeneğinin kullanılmasını --version mümkün kılmak için komutunu global.json dosyasını içeren yolun dışında çalıştırın. 8.0.400 SDK'dan itibaren kullanılabilir. Daha fazla bilgi için bkz . .NET SDK iş yükü kümeleri.

Örnekler

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

    dotnet workload install maui

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

    dotnet workload install maui-android maui-ios