Aracılığıyla paylaş

dotnet new install (komut)

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

Ad

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]

Açıklama

dotnet new install komutu, sağlanan PATH veya NUGET_ID bir şablon paketi 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ü <package-name>@<package-version>biçiminde belirtin. (.NET 9.0.200 SDK'sında karakter yerine :: iki nokta üst üste ayırıcısı @ kullanım dışı bırakıldı.) 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ü belirtirse 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ümleridahil olmak üzere her .NET SDK sürümü için ayrı ayrı yönetiliyordu. Örneğin, .NET SDK 5.0.100'de dotnet new --install kullanarak şablon paketini 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 daha 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. içinde de kullanılabilir. 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ümlerinde yüklü bir şablon paketini kullanmak için, bu .NET SDK sürümündeki dotnet new install kullanarak yüklemeniz gerekir.

Not

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

  • --list, --search, --installve --uninstall seçenekleri list, search, installve uninstall alt komutları haline geldi.
  • --update-apply seçeneği update alt komutu haline geldi.
  • --update-checkkullanmak için update seçeneğiyle --check-only alt komutunu kullanın.

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

Ayrıca, sekme tamamlama özelliği artık dotnet newiçin kullanılabilir. Yüklü şablon adlarının ve seçilen bir şablonun sağladığı seçeneklerin tamamlanmasını 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

Uyarı

Şablonlar tetiklendiğinde MSBuild kodunu çalıştırabilir, güvenilmeyen .NET şablonlarını yüklemez veya çalıştıramaz.

Bağımsız değişken

  • <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 --add-source seçeneğiyle 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, <package-name>@<package-version>biçiminde sürümü belirtin. (.NET 9.0.200 SDK'sında karakter yerine :: iki nokta üst üste ayırıcısı @ kullanım dışı bırakıldı.)

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. --nuget-source belirtilirse, kaynak denetlenecek kaynaklar listesine eklenir. Geçerli dizin için yapılandırılmış kaynakları denetlemek için dotnet nuget list sourcekullanın. Daha fazla bilgi için bkz. Yaygın NuGet Yapılandırmaları.

    Not

    NuGet'in Https Everywhere girişiminin ardından dotnet newhttp akışları kullanıma sunar. bir http akışı geçirilirse paketler için sorgulanmaz ve bir uyarı görüntülenir. gerekirse bu davranışı geçersiz kılmak için --force 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

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

  • --interactive

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

  • -v|--verbosity <LEVEL>

    Komutun ayrıntı düzeyini ayarlar. İzin verilen değerler , q[uiet], m[inimal], n[ormal]ve d[etailed]diag[nostic]. Daha fazla bilgi için bkz. LoggerVerbosity.

Ö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.

  • Last updated on