| title | 用于发现 nuget.exe 版本的工具 |
|---|---|
| description | 的端点 |
| author | jver |
| ms.author | jver |
| ms.date | 08/16/2018 |
| ms.topic | conceptual |
| ms.reviewer | kraigb |
| ms.openlocfilehash | a186db9727bdfd1b55bf73a1f29283352555dede |
| ms.sourcegitcommit | 39f2ae79fbbc308e06acf67ee8e24cfcdb2c831b |
| ms.translationtype | MT |
| ms.contentlocale | zh-CN |
| ms.lasthandoff | 11/05/2019 |
| ms.locfileid | 73611022 |
目前，有几种方法可以在计算机上以脚本方式获取 nuget.exe 的最新版本。 例如，你可以从 nuget.org 下载并提取NuGet.CommandLine包。这种方法有一定的复杂性，因为它要求您已经具有 nuget.exe （对于 nuget.exe install），或者必须使用基本解压缩工具来解压缩 nupkg，并在内部查找二进制文件。
如果你已有 nuget.exe，还可以使用 nuget.exe update -self，但这也需要具有 nuget.exe 的现有副本。 此方法还会更新到最新版本。 它不允许使用特定版本。
tools.json 终结点可用于解决启动问题，并可控制所下载的 nuget.exe 版本。 这可以用于 CI/CD 环境或自定义脚本，以发现和下载任何发布版本的 nuget.exe。
可以使用未经身份验证的 HTTP 请求获取 tools.json 终结点（例如，在 PowerShell 中 Invoke-WebRequest 或 wget）。 使用 JSON 反序列化程序可以对其进行分析，后续 nuget.exe 下载 Url 也可以使用未经身份验证的 HTTP 请求提取。
可以使用 GET 方法获取终结点：
GET https://dist.nuget.org/tools.json
此处提供终结点的JSON 架构：
GET https://dist.nuget.org/tools.schema.json
响应是一个 JSON 文档，其中包含 nuget.exe 的所有可用版本。
根 JSON 对象具有以下属性：
| “属性” | 键入 | 必需 |
|---|---|---|
| nuget.exe | 对象数组 | 是 |
nuget.exe 数组中的每个对象具有以下属性：
| “属性” | 键入 | 必需 | 注意 |
|---|---|---|---|
| 版本 | string | 是 | SemVer 2.0.0 字符串 |
| URL | string | 是 | 下载此版本的 nuget.exe 的绝对 URL |
| 结束 | string | 是 | 枚举字符串 |
| 上载 | string | 是 | 可用版本的大约 ISO 8601 时间戳 |
数组中的项将按降序、SemVer 2.0.0 顺序排序。 这一保证旨在降低对最高版本号感兴趣的客户端的负担。 但这意味着列表不按时间顺序进行排序。 例如，如果在较高的主要版本之前的日期提供较低的主要版本，则此服务版本将不会显示在列表的顶部。 如果需要由时间戳发布的最新版本，只需按 uploaded 字符串对数组进行排序即可。 这是因为 uploaded 时间戳采用ISO 8601格式，可以使用字典排序（即简单字符串排序）按时间顺序进行排序。
stage 属性指示此版本工具的审查。
| 阶段 | 含义 |
|---|---|
| EarlyAccessPreview | 在下载网页上还不可见，应由合作伙伴验证 |
| Released（已释放） | 在下载站点上可用，但尚不建议用于跨范围使用 |
| ReleasedAndBlessed | 在下载站点提供，建议用于使用 |
使用最新的建议版本的一种简单方法是使用列表中具有 ReleasedAndBlessed``stage 值的第一个版本。 这是因为版本按 SemVer 2.0.0 顺序排序。
Nuget.org 上的 NuGet.CommandLine 包通常仅更新 ReleasedAndBlessed 版本。
GET https://dist.nuget.org/tools.json
[!code-JSON tools-json.json]