dotnet restore

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

Name

dotnet restore -Bir projenin bağımlılıklarını ve araçlarını geri yükler.

Özeti

dotnet restore [<ROOT>] [--configfile <FILE>] [--disable-parallel]
    [-f|--force] [--force-evaluate] [--ignore-failed-sources]
    [--interactive] [--lock-file-path <LOCK_FILE_PATH>] [--locked-mode]
    [--no-cache] [--no-dependencies] [--packages <PACKAGES_DIRECTORY>]
    [-r|--runtime <RUNTIME_IDENTIFIER>] [-s|--source <SOURCE>]
    [--use-lock-file] [-v|--verbosity <LEVEL>]

dotnet restore -h|--help

Description

dotnet restorekomut, bağımlılıkları geri yüklemek için NuGet kullanır ve proje dosyasında belirtilen projeye özel araçları. çoğu durumda, dotnet restore aşağıdaki komutları çalıştırdığınızda NuGet geri yükleme dolaylı olarak çalıştırıldıklarından, komutu açıkça kullanmanız gerekmez:

bazen örtük NuGet geri yüklemeyi bu komutlarla çalıştırmak kullanışlı olabilir. Örneğin, derleme sistemleri gibi bazı otomatikleştirilmiş sistemlerin, dotnet restore ağ kullanımını denetleyebilmeleri için geri yüklemenin ne zaman gerçekleşeceğini denetlemek için açıkça çağrılması gerekir. örtük NuGet geri yüklemeyi engellemek için, --no-restore bayrağı, örtük geri yüklemeyi devre dışı bırakmak için bu komutlardan herhangi biriyle kullanabilirsiniz.

Akışları belirt

bağımlılıkları geri yüklemek için NuGet paketlerin bulunduğu akışlara ihtiyacı vardır. Akışlar genellikle nuget.config yapılandırma dosyası aracılığıyla sağlanır. .NET SDK yüklendiğinde varsayılan bir yapılandırma dosyası sağlanır. Ek akışlar belirtmek için aşağıdakilerden birini yapın:

nuget.config akışlarını seçeneği ile geçersiz kılabilirsiniz -s .

Kimliği doğrulanmış akışların nasıl kullanılacağı hakkında daha fazla bilgi için bkz. kimliği doğrulanmış akışlardan paketlerikullanma.

Genel paketler klasörü

Bağımlılıklar için, geri yükleme işlemi sırasında bağımsız değişkeni kullanarak geri yüklenen paketlerin nerede yerleştirileceğini belirtebilirsiniz --packages . belirtilmemişse, varsayılan NuGet paket önbelleği kullanılır ve bu, .nuget/packages tüm işletim sistemlerindeki kullanıcının giriş dizinindeki dizininde bulunur. Örneğin, Linux üzerinde /home/user1 veya Windows 'de c:\Users\User1 .

Project özgü araç

Projeye özgü araçlar için, dotnet restore önce aracın paketlenmesi gereken paketi geri yükler ve ardından, araç bağımlılıklarını proje dosyasında belirtilen şekilde geri yüklemeye devam eder.

nuget.config farklar

Komutun davranışı, varsa dotnet restore nuget.config dosyasındaki ayarlardan etkilenir. örneğin,nuget.configayarlanması, globalPackagesFolder geri yüklenen NuGet paketlerini belirtilen klasöre koyar. Bu seçenek, komutunda seçeneğini belirtmeye yönelik bir alternatiftir --packages dotnet restore . Daha fazla bilgi için nuget.config başvurusunabakın.

Yok sayan üç özel ayar vardır dotnet restore :

  • Bindingyönlendirmeler

    bağlama <PackageReference> yeniden yönlendirmeleri öðelerle çalışmaz ve .net yalnızca <PackageReference> NuGet paketlerine ait öğeleri destekler.

  • çözümden

    bu ayar Visual Studio özeldir ve .net için uygulanmaz. .net bir dosya kullanmaz packages.config ve bunun yerine <PackageReference> NuGet paketleri için öğeleri kullanır.

  • trustedSigners

    Platformlar arası Paket imza doğrulaması desteği .NET 5.0.100 SDK 'sına eklenmiştir.

İş yükü bildirimi İndirmeleri

Bu komutu çalıştırdığınızda, iş yükleri için reklam bildirimlerinin zaman uyumsuz karşıdan yükleme işlemini başlatır. Bu komut tamamlandığında indirme çalışmaya devam ediyorsa, indirme durdurulur. Daha fazla bilgi için bkz. reklam bildirimleri.

Bağımsız değişkenler

  • ROOT

    Geri yüklenecek proje dosyasının isteğe bağlı yolu.

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

    Paralel olarak birden çok projenin geri yüklenmesini devre dışı bırakır.

  • --force

    Son geri yükleme başarılı olsa bile tüm bağımlılıkların çözülmesini zorlar. Bu bayrağın belirtilmesi, Project. varlıklar. JSON dosyasını silme ile aynıdır.

  • --force-evaluate

    Bir kilit dosyası zaten mevcut olsa bile, geri yüklemeyi tüm bağımlılıklara yeniden değerlendirmeye zorlar.

  • -?|-h|--help

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

  • --ignore-failed-sources

    Yalnızca sürüm gereksinimini karşılayan paketler varsa başarısız kaynaklar hakkında uyar.

  • --interactive

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

  • --lock-file-path <LOCK_FILE_PATH>

    Proje kilit dosyasının yazıldığı çıkış konumu. Bu, varsayılan olarak PROJECT_ROOT \packages.Lock.JSON.

  • --locked-mode

    Proje kilit dosyası güncelleştirilmeye izin verme.

  • --no-cache

    HTTP isteklerinin önbelleğe alınamadı belirtir.

  • --no-dependencies

    Projeden projeye (P2P) başvuruları olan bir projeyi geri yüklerken, başvuruları değil kök projeyi geri yükler.

  • --packages <PACKAGES_DIRECTORY>

    Geri yüklenen paketlerin dizinini belirtir.

  • -r|--runtime <RUNTIME_IDENTIFIER>

    Paket geri yüklemesi için bir çalışma zamanı belirtir. Bu, <RuntimeIdentifiers> . csproj dosyasındaki etiketinde açıkça listelenmeyen çalışma zamanları paketlerini geri yüklemek için kullanılır. Çalışma zamanı tanımlayıcıları (RID 'Ler) listesi için bkz. RID kataloğu. Bu seçeneği birden çok kez belirterek birden çok grup belirtin.

  • -s|--source <SOURCE>

    geri yükleme işlemi sırasında kullanılacak NuGet paketi kaynağının urı '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ğlanarak sağlayabilirsiniz.

  • --use-lock-file

    Proje kilitleme dosyasının oluşturulup geri yükleme ile kullanılmasını sağlar.

  • -v|--verbosity <LEVEL>

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

Örnekler

  • Geçerli dizindeki proje için bağımlılıkları ve araçları geri yükle:

    dotnet restore
    
  • Verilen yolda bulunan projenin bağımlılıklarını ve araçlarını geri yükleyin app1 :

    dotnet restore ./projects/app1/app1.csproj
    
  • Kaynak olarak belirtilen dosya yolunu kullanarak geçerli dizindeki proje için bağımlılıkları ve araçları geri yükleyin:

    dotnet restore -s c:\packages\mypackages
    
  • Kaynak olarak girilen iki dosya yolunu kullanarak geçerli dizindeki proje için bağımlılıkları ve araçları geri yükleyin:

    dotnet restore -s c:\packages\mypackages -s c:\packages\myotherpackages
    
  • Geçerli dizindeki proje için bağımlılıkları ve araçları ayrıntılı çıktıyı gösteren geri yükleyin:

    dotnet restore --verbosity detailed