NuGet paketi yüklendiğinde ne olur?

Basitçe söylemek gerekirse, farklı NuGet araçları genellikle proje dosyasındaki veya packages.configiçindeki bir pakete başvuru oluşturur ve ardından paketi etkili bir şekilde yükleyen bir paket geri yükleme işlemi gerçekleştirir. İstisna, paketi yalnızca bir nuget install klasörüne genişleten ve diğer dosyaları değiştirmeyen packages klasörü ile ilgilidir.

Genel süreç aşağıdaki gibidir:

1. (nuget.exe dışındaki tüm araçlar) Paket tanımlayıcısını ve sürümünü proje dosyasına veya packages.config kaydedin.

   Yükleme aracı Visual Studio veya dotnet CLI ise, araç önce paketi yüklemeyi dener. Uyumsuzsa, paket veya proje dosyasına packages.configeklenmez.

2. Paketi alın:

   • Paketin (tam identifer ve sürüm numarasına göre) Genel paketleri ve önbellek klasörlerini yönetme bölümünde açıklandığı gibi genel paketler klasörüne zaten yüklenip yüklenmediğini denetleyin.

   • Paket genel paketler klasöründe değilse, yapılandırma dosyalarında listelenen kaynaklardan almayı deneyin. Paket Kaynağı Eşleme yapılandırmaları bu noktada uygulanır. Çevrimiçi kaynaklar için, -NoHttpCache komutlarıyla belirtilmediği veya --no-http-cache ile dotnet restore belirtilmediği sürece paketi HTTP önbelleğinden almayı deneyin. (Visual Studio ve dotnet add package her zaman önbelleği kullanın.) Önbellekten bir paket kullanılıyorsa çıktıda "CACHE" görünür. Önbelleğin son kullanma süresi 30 dakikadır.

   • Paket kayan sürüm kullanılarak veya en düşük sürüm olmadan belirtildiyse, NuGet en iyi eşleşmeyi bulmak için tüm kaynaklara başvuracaktır . Örnek: 1.*, (, 2.0.0].

   • Paket HTTP önbelleğinde değilse, yapılandırmada listelenen kaynaklardan indirmeyi deneyin. Bir paket indirilirse çıkışta "GET" ve "Ok" görünür. NuGet, http trafiğini normal düzeyde ayrıntılı olarak günlüğe kaydeder.

   • Paket herhangi bir kaynaktan başarıyla alınamazsa yükleme bu noktada NU1103 gibi bir hatayla başarısız olur. Komutlardan gelen hataların yalnızca denetlenen son kaynağı gösterdiğini, ancak bunun paketin herhangi bir kaynaktan mevcut olmadığını ima ettiğini unutmayın.

   Paketi alırken, NuGet yapılandırmasındaki kaynakların sırası geçerli olabilir:

   • NuGet, HTTP kaynaklarını denetlemeden önce yerel klasörü ve ağ paylaşımlarını denetler.

3. Paketin bir kopyasını ve diğer bilgileri genel paketleri ve önbellek klasörlerini yönetme konusunda açıklandığı gibi http-cache klasörüne kaydedin.

4. İndirilirse, paketi kullanıcı başına genel paketler klasörüne yükleyin. NuGet, her paket tanımlayıcısı için bir alt klasör oluşturur ve ardından paketin yüklü her sürümü için alt klasörler oluşturur.

5. NuGet, paket bağımlılıklarını gerektiği gibi yükler. Bu işlem, Bağımlılık Çözümlemesi'nde açıklandığı gibi işlemdeki paket sürümlerini güncelleştirebilir.

6. Diğer proje dosyalarını ve klasörlerini güncelleştirin:

   • PackageReference kullanan projeler için içinde depolanan obj/project.assets.jsonpaket bağımlılığı grafiğini güncelleştirin. Paket içeriği hiçbir proje klasörüne kopyalanmaz.
   • app.config ve/veya web.config, paket kaynak ve yapılandırma dosyası dönüştürmelerini kullanıyorsa güncelleyin.

7. (yalnızca Visual Studio) Varsa paketin benioku dosyasını Visual Studio penceresinde görüntüleyin.

NuGet paketleriyle üretken kodlamanın keyfini çıkarın!