dotnet new install

  • Makale

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

Name

dotnet new install - bir şablon paketi yükler.

Özet

dotnet new install <PATH|NUGET_ID>  [--interactive] [--add-source|--nuget-source <SOURCE>] [--force] 
    [-d|--diagnostics] [--verbosity <LEVEL>] [-h|--help]

Description

komutudotnet new install, veya NUGET_ID tarafından sağlanan bir şablon paketi PATH yükler. Şablon paketinin belirli bir sürümünü veya yayın öncesi sürümünü yüklemek istiyorsanız, sürümünü biçiminde <package-name>::<package-version>belirtin. Varsayılan olarak, dotnet new en son kararlı paket sürümünü temsil eden sürüm için * geçirir. Daha fazla bilgi için Örnekler bölümüne bakın.

Bu komutu çalıştırdığınızda şablon paketinin bir sürümü zaten yüklüyse, şablon paketi belirtilen sürüme güncelleştirilir. Sürüm belirtilmezse, paket en son kararlı sürüme güncelleştirilir. .NET SDK 6.0.100'den başlayarak, bağımsız değişken sürümü belirtiyorsa ve NuGet paketinin bu sürümü zaten yüklüyse, yeniden yüklenmez. Bağımsız değişken bir PATH ise ve zaten yüklüyse, yeniden yüklenmez.

.NET SDK 6.0.100'ün öncesinde, şablon paketleri düzeltme eki sürümleri de dahil olmak üzere her .NET SDK sürümü için ayrı ayrı yönetiliyordu. Örneğin şablon paketini .NET SDK 5.0.100'de kullanarak dotnet new --install yüklerseniz, yalnızca .NET SDK 5.0.100 için yüklenir. Paketteki şablonlar makinenizde yüklü olan diğer .NET SDK sürümlerinde kullanılamaz.

.NET SDK 6.0.100'den başlayarak, yüklü şablon paketleri makinenize yüklenen sonraki .NET SDK sürümlerinde kullanılabilir. .NET SDK 6.0.100'de yüklü bir şablon paketi .NET SDK 6.0.101, .NET SDK 6.0.200 vb. Ancak, bu şablon paketleri .NET SDK 6.0.100'ün önceki .NET SDK sürümlerinde kullanılamaz. Önceki .NET SDK sürümlerinde .NET SDK 6.0.100 veya sonraki sürümlerde yüklü bir şablon paketini kullanmak için bu .NET SDK sürümünde kullanarak dotnet new install yüklemeniz gerekir.

Not

.NET 7 SDK'sı ile başlayarak söz dotnet new dizimi değişti:

  • , , ve seçenekleri , , installsearchve uninstall alt komutları haline geldilist.--uninstall--install--search--list
  • Bu --update-apply seçenek alt komut haline geldi update .
  • kullanmak --update-checkiçin seçeneğiyle update birlikte --check-only alt komutunu kullanın.

Daha önce kullanılabilir olan diğer seçenekler, ilgili alt komutları ile birlikte kullanılmaya devam eder. Veya seçeneği aracılığıyla -h--help her alt komut için ayrı yardım sağlanır: dotnet new <subcommand> --help alt komut için desteklenen tüm seçenekleri listeler.

Ayrıca, artık için dotnet newsekme tamamlama kullanılabilir. Yüklü şablon adları ve seçili bir şablonun sağladığı seçenekler için tamamlanmayı destekler. .NET SDK'sı için sekme tamamlama özelliğini etkinleştirmek için bkz. Sekme tamamlamayı etkinleştirme.

Eski söz dizimi örnekleri:

  • Azure web işleri proje şablonu paketinin en son sürümünü yükleyin:

    dotnet new --install Microsoft.Azure.WebJobs.ProjectTemplates

Bağımsız değişkenler

  • <PATH|NUGET_ID>

    Dosya sistemindeki klasör veya şablon paketinin yükleneceği NuGet paket tanımlayıcısı. dotnet new geçerli çalışma dizini için kullanılabilen NuGet kaynaklarından ve seçeneğiyle --add-source belirtilen kaynaklardan NuGet paketini yüklemeyi dener. NuGet kaynağından bir şablon paketinin belirli bir sürümünü veya yayın öncesi sürümünü yüklemek istiyorsanız, sürümünü biçiminde <package-name>::<package-version>belirtin.

Seçenekler

  • --add-source|--nuget-source <SOURCE>

    Varsayılan olarak, dotnet new install paketin yükleneceği NuGet kaynağını belirlemek için geçerli dizindeki NuGet yapılandırma dosyalarının hiyerarşisini kullanır. belirtilirse --nuget-source , kaynak denetlenecek kaynaklar listesine eklenir.
    Geçerli dizin için yapılandırılmış kaynakları denetlemek için kullanın dotnet nuget list source. Daha fazla bilgi için bkz. Yaygın NuGet Yapılandırmaları

    Not

    NuGet'in Https Everywhere girişiminin dotnet new ardından akışlar kullanıma sunılıyor http . Bir http akış geçirilirse paketler için sorgulanır ve bir uyarı görüntülenir. --force gerekirse bu davranışı geçersiz kılmak için seçeneği kullanılabilir.

  • -d|--diagnostics

    Tanılama çıkışını etkinleştirir. .NET SDK 7.0.100'den itibaren kullanılabilir.

  • --force

    Başka bir kaynaktan gelen şablon paketini geçersiz kılsalar bile belirtilen kaynaklardan şablon paketlerinin yüklenmesine izin verir. .NET SDK 7.0.100'den itibaren kullanılabilir.

  • -h|--help

    Yükleme komutu için yardım yazdırır. .NET SDK 7.0.100'den itibaren kullanılabilir.

  • --interactive

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

  • -v|--verbosity <LEVEL>

    Komutun ayrıntı düzeyini ayarlar. İzin verilen değerler , m[inimal], n[ormal]ve diag[nostic]değerleridirq[uiet]. .NET SDK 7.0.100'den itibaren kullanılabilir.

Örnekler

  • ASP.NET Core için SPA şablonlarının en son sürümünü yükleyin:

    dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates

  • ASP.NET Core için SPA şablonlarının 2.0 sürümünü yükleyin:

    dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0

  • Etkileşimli modu kullanarak özel bir NuGet kaynağından ASP.NET Core için SPA şablonlarının 2.0 sürümünü yükleyin:

    dotnet new --install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0 --add-source "https://api.my-custom-nuget.com/v3/index.json" --interactive

Ayrıca bkz.