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

Bugün, makinenizde nuget.exe en son sürümünü betikle yazılabilir bir şekilde edinmenin birkaç yolu vardır. Örneğin, NuGet.CommandLine paketini nuget.org'dan indirip ayıklayabilirsiniz. Bu biraz karmaşıklık içerir çünkü ya zaten nuget.exe install için nuget.exe'ye sahip olmanız gerekir ya da temel bir unzip aracı kullanarak .nupkg dosyasını açıp içindeki çift dosyayı bulmanız gerekecektir.

zaten nuget.exe varsa nuget.exe update -self'yi de kullanabilirsiniz, ancak bunun için mevcut bir nuget.exe 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çnoktanın tools.json hem önyükleme sorununu çözmek hem de indirdiğiniz nuget.exe versiyonunun kontrolünü sağlamak için kullanılabilir. Bu, CI/CD ortamlarında veya özel betiklerde nuget.exe'in yayımlanan sürümlerini bulmak ve indirmek için kullanılabilir.

Endpoint tools.json, kimliği doğrulanmamış bir HTTP isteği (örneğin PowerShell'deki Invoke-WebRequest veya wget) kullanılarak getirilebilir. JSON ayrıştırıcı kullanılarak ayrıştırılabilir ve ardından nuget.exe indirme URL'leri, kimlik doğrulaması yapılmadan HTTP istekleri kullanılarak da alınabilir.

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

Yanıt

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

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

İsim	Türü	Gerekli
nuget.exe	nesne dizisi	yes

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

İsim	Türü	Gerekli	Notes
version	String	yes	SemVer 2.0.0 dizesi
url	String	yes	nuget.exe'in bu sürümünü indirilebilecek Mutlak URL
stage	String	yes	Enum dizesi
Yüklenen	String	yes	Sürümün ne zaman kullanıma sunulduğuna ilişkin yaklaşık ISO 8601 zaman damgası

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.

Özellik stage, bu aracın sürümünün ne kadar iyi değerlendirildiğini belirtir.

Aşama	Meaning
Erken Erişim Önizlemesi	İndirme web sayfasında henüz görünmüyor ve iş ortakları tarafından doğrulanmalıdır
Serbest bırakıldı	İndirme sitesinde mevcuttur ancak geniş çapta kullanım için henüz önerilmez
SerbestBırakıldıVeKutsandı	İndirme sitesinde kullanılabilir ve kullanım için önerilir

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

Nuget.org'daki NuGet.CommandLine paketi genellikle yalnızca ReleasedAndBlessed ana sürümlerle güncellenir.

Numune 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"
        }
    ]
}