dotnet add package

  • Makale
  • Okumak için 2 dakika

Bu makale şu şekilde geçerlidir: ✔️ .NET Core 2. x SDK ve sonraki sürümleri

Name

dotnet add package -Proje dosyasına bir paket başvurusu ekler.

Özeti

dotnet add [<PROJECT>] package <PACKAGE_NAME>
    [-f|--framework <FRAMEWORK>] [--interactive]
    [-n|--no-restore] [--package-directory <PACKAGE_DIRECTORY>]
    [--prerelease] [-s|--source <SOURCE>] [-v|--version <VERSION>]

dotnet add package -h|--help

Description

dotnet add packageKomut, bir proje dosyasına paket başvurusu eklemek için uygun bir seçenek sağlar. Komutu çalıştırdıktan sonra, paketin projedeki çerçeveler ile uyumlu olduğundan emin olmak için bir uyumluluk denetimi vardır. Denetim başarılı olursa, <PackageReference> proje dosyasına bir öğe eklenir ve DotNet restore çalıştırılır.

Örneğin, Newtonsoft.Json Todo. csproj öğesine eklemek aşağıdaki örneğe benzer bir çıktı üretir:

Writing C:\Users\me\AppData\Local\Temp\tmp95A8.tmp
info : Adding PackageReference for package 'Newtonsoft.Json' into project 'C:\projects\ToDo\ToDo.csproj'.
log  : Restoring packages for C:\Temp\projects\consoleproj\consoleproj.csproj...
info :   GET https://api.nuget.org/v3-flatcontainer/newtonsoft.json/index.json
info :   OK https://api.nuget.org/v3-flatcontainer/newtonsoft.json/index.json 79ms
info :   GET https://api.nuget.org/v3-flatcontainer/newtonsoft.json/12.0.1/newtonsoft.json.12.0.1.nupkg
info :   OK https://api.nuget.org/v3-flatcontainer/newtonsoft.json/12.0.1/newtonsoft.json.12.0.1.nupkg 232ms
log  : Installing Newtonsoft.Json 12.0.1.
info : Package 'Newtonsoft.Json' is compatible with all the specified frameworks in project 'C:\projects\ToDo\ToDo.csproj'.
info : PackageReference for package 'Newtonsoft.Json' version '12.0.1' added to file 'C:\projects\ToDo\ToDo.csproj'.

Todo. csproj dosyası artık <PackageReference> başvurulan paket için bir öğe içeriyor.

<PackageReference Include="Newtonsoft.Json" Version="12.0.1" />

Örtük geri yükleme

,,,, dotnet restore Ve gibi geri yükleme gerektiren tüm komutlar tarafından örtük olarak çalıştırıldığı için çalıştırmanız gerekmez dotnet new dotnet build dotnet run dotnet test dotnet publish dotnet pack . Örtük geri yüklemeyi devre dışı bırakmak için --no-restore seçeneğini kullanın.

dotnet restoreBu komut, açıkça geri yükleme işleminin, Azure DevOps Services veya derleme sistemlerindeki sürekli tümleştirme yapıları gibi, geri yüklemenin ne zaman gerçekleşeceğini açıkça denetmasının gerektiği bazı senaryolarda de yararlıdır.

NuGet beslemelerini yönetme hakkında daha fazla bilgi için dotnet restore belgelerinebakın.

Bağımsız değişkenler

  • PROJECT

    Proje dosyasını belirtir. Belirtilmemişse, komut geçerli dizinde bir arama yapar.

  • PACKAGE_NAME

    Eklenecek paket başvurusu.

Seçenekler

  • -f|--framework <FRAMEWORK>

    Yalnızca belirli bir çerçeveyihedeflerken bir paket başvurusu ekler.

  • -?|-h|--help

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

  • --interactive

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

  • -n|--no-restore

    Geri yükleme önizlemesi ve uyumluluk denetimi yapılmadan bir paket başvurusu ekler.

  • --package-directory <PACKAGE_DIRECTORY>

    Paketlerin geri yükleneceği dizin. varsayılan paket geri yükleme konumu %userprofile%\.nuget\packages Windows ve ~/.nuget/packages macos ve Linux üzerinde. Daha fazla bilgi için, bkz. NuGet genel paketleri, önbelleği ve temp klasörlerini yönetme.

  • --prerelease

    Ön sürüm paketlerinin yüklenmesine izin verir. .NET Core 5 SDK 'dan beri kullanılabilir

  • -s|--source <SOURCE>

    geri yükleme işlemi sırasında kullanılacak NuGet paket kaynağının urı 'si.

  • -v|--version <VERSION>

    Paketin sürümü. bkz. NuGet paketi sürümü oluşturma.

Örnekler

  • Newtonsoft.Jsonbir projeye NuGet paketi ekleyin:

    dotnet add package Newtonsoft.Json

  • Bir projeye paketin belirli bir sürümünü ekleyin:

    dotnet add ToDo.csproj package Microsoft.Azure.DocumentDB.Core -v 1.0.0

  • belirli bir NuGet kaynağını kullanarak bir paket ekleyin:

    dotnet add package Microsoft.AspNetCore.StaticFiles -s https://dotnet.myget.org/F/dotnet-core/api/v3/index.json

Ayrıca bkz.