nuget.exe sürümlerini bulmak için tools.json

Bugün, makinenizde nuget.exe en son sürümünü betik biçiminde edinmenin birkaç yolu vardır. Örneğin, paketi nuget.org indirip ayıklayabilirsiniz NuGet.CommandLine . Bunun karmaşıklığı vardır çünkü zaten nuget.exe sahip olmanız gerekir (için nuget.exe install) veya temel bir unzip aracı kullanarak .nupkg dosyasının sıkıştırmasını açmanız ve içindeki ikiliyi bulmanız gerekir.

Zaten nuget.exe varsa, kullanabilirsiniz nuget.exe update -self, ancak bunun için de nuget.exe'nin mevcut bir kopyasına sahip olmanız gerekir. Bu yaklaşım sizi en son sürüme de güncelleştirir. Belirli bir sürümün kullanılmasına izin vermez.

Uç tools.json nokta hem önyükleme sorununu çözmek hem de indirdiğiniz nuget.exe sürümünün denetimini vermek için kullanılabilir. Bu, CI/CD ortamlarında veya özel betiklerde nuget.exe'ın yayımlanan sürümlerini keşfetmek ve indirmek için kullanılabilir.

Uç tools.json nokta kimliği doğrulanmamış bir HTTP isteği (örneğin Invoke-WebRequest , PowerShell veya wget) kullanılarak getirilebilir. JSON seri durumdan çıkarıcı kullanılarak ayrıştırılabilir ve sonraki nuget.exe indirme URL'leri de kimliği doğrulanmamış HTTP istekleri kullanılarak getirilebilir.

Uç nokta şu yöntem kullanılarak GET getirilebilir:

GET https://dist.nuget.org/tools.json

Uç noktanın JSON şemasına buradan ulaşabilirsiniz:

GET https://dist.nuget.org/tools.schema.json

Response

Yanıt, nuget.exe tüm kullanılabilir sürümlerini içeren bir JSON belgesidir.

Kök JSON nesnesi aşağıdaki özelliğe sahiptir:

Dizideki nuget.exe her nesne aşağıdaki özelliklere sahiptir:

Dizideki öğeler azalan SemVer 2.0.0 düzeninde sıralanır. Bu garanti, en yüksek sürüm numarasıyla ilgilenen bir istemcinin yükünü azaltmaya yöneliktir. Ancak bu, listenin kronolojik düzende sıralanmadığı anlamına gelir. Örneğin, daha düşük bir ana sürüme daha yüksek bir ana sürümden sonraki bir tarihte hizmet verirseniz, bu hizmet sunulan sürüm listenin en üstünde görünmez. En son sürümün zaman damgası tarafından yayımlanmasını istiyorsanız, diziyi dizeye uploaded göre sıralamanız yeterlidir. Bunun işe yaradığı için uploaded zaman damgası ISO 8601 biçimindedir ve bu biçim kronolojik olarak sözcük temelli sıralama (basit bir dize sıralama) kullanılarak sıralanabilir.

özelliği, stage aracın bu sürümünün nasıl izlendiğini gösterir.

En son, önerilen sürüme sahip olmak için basit bir yaklaşım, listedeki değeri olan stage ilk sürümü almaktır ReleasedAndBlessed. Bu işe yarar çünkü sürümler SemVer 2.0.0 düzeninde sıralanır.

NuGet.CommandLine nuget.org paketi genellikle yalnızca sürümlerle ReleasedAndBlessed güncelleştirilir.

Örnek isteği

GET https://dist.nuget.org/tools.json

Örnek yanıt

{
    "nuget.exe": [
        {
            "version": "4.8.0-preview3",
            "url": "https://dist.nuget.org/win-x86-commandline/v4.8.0-preview3/nuget.exe",
            "stage": "EarlyAccessPreview",
            "uploaded": "2018-07-06T23:00:00.0000000Z"
        },
        {
            "version": "4.7.1",
            "url": "https://dist.nuget.org/win-x86-commandline/v4.7.1/nuget.exe",
            "stage": "ReleasedAndBlessed",
            "uploaded": "2018-08-10T23:00:00.0000000Z"
        },
        {
            "version": "4.6.1",
            "url": "https://dist.nuget.org/win-x86-commandline/v4.6.1/nuget.exe",
            "stage": "Released",
            "uploaded": "2018-03-22T23:00:00.0000000Z"
        },
        {
            "version": "3.5.0",
            "url": "https://dist.nuget.org/win-x86-commandline/v3.5.0/nuget.exe",
            "stage": "ReleasedAndBlessed",
            "uploaded": "2016-12-19T15:30:00.0000000-08:00"
        },
        {
            "version": "2.8.6",
            "url": "https://dist.nuget.org/win-x86-commandline/v2.8.6/nuget.exe",
            "stage": "ReleasedAndBlessed",
            "uploaded": "2015-09-01T12:30:00.0000000-07:00"
        }
    ]
}