Ler em inglês

Compartilhar via


tools.json para descobrir versões de nuget.exe

Hoje, existem algumas maneiras de obter a versão mais recente do nuget.exe em seu computador de forma programável. Por exemplo, você pode baixar e extrair o pacote NuGet.CommandLine do nuget.org. Isso tem certa complexidade, pois requer que você já tenha nuget.exe (para nuget.exe install) ou você tem que descompactar o .nupkg usando uma ferramenta básica de descompactação e encontrar o binário dentro.

Se você já tem nuget.exe, você também pode usar nuget.exe update -self, no entanto, isso também requer ter uma cópia existente do nuget.exe. Essa abordagem também atualiza você para a versão mais recente. Não permite o uso de uma versão específica.

O ponto de extremidade tools.json está disponível para resolver o problema de inicialização e para conceder controle da versão do nuget.exe que você baixar. Isso pode ser usado em ambientes de CI/CD ou em scripts personalizados para descobrir e baixar qualquer versão de lançamento do nuget.exe.

O ponto de extremidade tools.json pode ser obtido usando uma solicitação HTTP não autenticada (por exemplo, Invoke-WebRequest no PowerShell ou wget). Ele pode ser analisado usando um desserializador JSON e URLs de download de nuget.exe subsequentes também podem ser buscados usando solicitações HTTP não autenticadas.

O ponto de extremidade pode ser obtido usando o método GET:

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

O esquema JSON do ponto de extremidade está disponível aqui:

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

Resposta

A resposta é um documento JSON contendo todas as versões disponíveis de nuget.exe.

O objeto JSON raiz tem a seguinte propriedade:

Nome Digitar Obrigatório
nuget.exe matriz de objetos sim

O objeto na matriz nuget.exe tem as seguintes propriedades:

Nome Digitar Obrigatória Observações
version string sim Uma cadeia de caracteres do SemVer 2.0.0
url string sim Uma URL absoluta para baixar esta versão de nuget.exe
preparar string sim Uma cadeia de caracteres enumerada
Carregado string sim Um carimbo de data/hora ISO 8601 aproximado de quando a versão foi disponibilizada

Os itens na matriz serão classificados em ordem decrescente do SemVer 2.0.0. Esta garantia destina-se a reduzir a carga de um cliente que está interessado no número de versão mais alto. No entanto, isso significa que a lista não está classificada em ordem cronológica. Por exemplo, se uma versão principal inferior for atendida em uma data posterior a uma versão principal superior, essa versão com manutenção não aparecerá no topo da lista. Se você quiser que a versão mais recente seja lançada por carimbo de data/hora, basta classificar a matriz pela cadeia de caracteres uploaded. Isso funciona porque o carimbo de data/hora uploaded está no formato ISO 8601, que pode ser classificado cronologicamente usando uma classificação lexicográfica (ou seja, uma classificação de cadeia de caracteres simples).

A propriedade stage indica o quão verificada esta versão da ferramenta é.

Estágio Significado
EarlyAccessPreview Ainda não visível na página da web de download e deve ser validado por parceiros
Lançado Disponível no site de download, mas ainda não é recomendado para consumo generalizado
ReleasedAndBlessed Disponível no site de download e recomendado para consumo

Uma abordagem simples para ter a versão mais recente e recomendada é pegar a primeira versão da lista que tem o valor stage de ReleasedAndBlessed. Isso funciona porque as versões são classificadas na ordem SemVer 2.0.0.

O pacote NuGet.CommandLine no nuget.org normalmente só é atualizado com ReleasedAndBlessed versões.

Solicitação de exemplo

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

Resposta de exemplo

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