winget cli

Windows 包管理器

WinGet客户端

如果您是 Windows 包管理器的新手，您可能想探索 Windows 包管理器工具。客户端可以从两个默认源访问包。第一个是“msstore”Microsoft Store（适合所有​​人的免费应用程序，评级为“e”）。第二个是 WinGet 社区存储库“winget”。

笔记

可以配置组策略并修改配置的源。运行winget --info以查看任何配置的策略。

安装客户端

笔记

目前客户端需要 Windows 10 1809（内部版本 17763）或更高版本。不支持 Windows Server 2019，因为 Microsoft Store 不可用，依赖项也不更新。可以在 Windows Server 2022 上安装，这应该被视为实验性的（不支持），并且还需要手动安装依赖项。

微软商店【推荐】

客户端在应用程序安装程序包中分发。

开发版本

有两种方法可以获得开发版本：

• 安装 Windows 10 或 Windows 11 Insider 版本。
• 通过注册加入 Windows Package Manager Insider 计划。

笔记

在您收到加入 Windows Package Manager Insider 计划的电子邮件确认后，可能需要几天时间才能获取更新的应用安装程序。如果你决定从 GitHub 安装最新版本，并且已成功加入内部计划，则当下一个开发版本在 Microsoft Store 中发布时，你将收到更新。

从 Microsoft Store 收到更新的应用程序安装程序后，您应该能够执行winget features来查看实验性功能。一些用户报告了客户端不在其 PATH 上的问题。

手动更新

相同的 Microsoft Store 软件包将通过我们的版本提供。请注意，安装此软件包将为您提供 WinGet 客户端，但如果您尚未加入 Windows Package Manager Insider 计划，则不会启用 Microsoft Store 的自动更新。

笔记

您可能需要安装 VC++ v14 桌面框架包。仅当您收到有关缺少框架包的错误时，才需要在较旧版本的 Windows 10 上执行此操作。

故障排除

请阅读我们的故障排除指南。

管理员注意事项

安装程序的行为可能会有所不同，具体取决于您是否以管理员权限运行WinGet 。

• 在没有管理员权限的情况下运行WinGet时，某些应用程序可能需要提升权限才能安装。当安装程序运行时，Windows 将提示您提升。如果您选择不提升，应用程序将无法安装。

• 在管理员命令提示符下运行WinGet时，如果应用程序需要，您将不会看到提升提示。以管理员身份运行命令提示符时请务必小心，并且仅安装您信任的应用程序。

建立你自己的

您也可以自己构建客户端。虽然客户端应该功能完善，但我们还没有准备好为在官方分发机制之外运行的客户端提供全面支持。请随意提出问题，但要知道它的优先级可能会较低。

构建状态

Windows 包管理器发布路线图

我们的讨论中描述并包含了交付下一个 Windows 包管理器版本的计划，并将随着项目的进展进行更新。

Windows 包管理器概述

Windows 包管理器是一款旨在帮助您快速轻松地发现和安装那些使您的 PC 环境变得特别的包的工具。通过使用Windows 包管理器，您可以通过一个命令安装您最喜欢的包：

winget install

概述

客户端存储库

此 winget-cli 存储库包含旨在构建客户端的源代码。我们鼓励您参与该客户端的开发。我们的问题中有大量积压的功能。您可以对您想要的项目进行投票、添加更多项目，甚至可以开始创建一个项目。

来源

客户端是围绕源的概念构建的；一组有效的包。源提供了发现和检索有关包的元数据的能力，以便客户端可以对其进行操作。

• 默认的“winget”源包括 Windows 包管理器社区存储库中的包。
• 默认的“msstore”源包括 Microsoft Store 中的包。
• 还可以托管您自己的基于 REST 的私有源。

构建客户端

1. 克隆存储库
2. 配置您的系统，请使用配置文件。这可以通过以下任一方式应用：
   • Dev Home的机器配置工具
   • WinGet 配置。从项目根运行winget configure .configurations/configuration.dsc.yaml以便正确解析相对路径。
3. 从 VS 2022 的开发人员命令提示符运行vcpkg integrate install这是一次性安装步骤，直到步骤 2 中的配置文件更新为与 vcpkg 安装程序一起使用为止。

先决条件

• Windows 10 1809 (17763) 或更高版本
• 开发者模式已启用
• 视觉工作室 2022
  • 或者使用 WinGet 来安装它;)（尽管您可能需要通过“工具”->“获取工具和功能...”来调整工作负载）
• 以下工作负载：
  • .NET 桌面开发
  • 使用 C++ 进行桌面开发
  • 通用Windows平台开发
  • 检查 .vsconfig 文件以获取完整的组件列表
• 适用于 Windows 11 的 Windows SDK (10.0.22000.194)

笔记

您还可以通过winget install Microsoft.WindowsSDK --version 10.0.22000.832 （如果安装了较新版本，请使用 --force）或通过 Visual Studio > 获取工具和功能 > 单个组件 > Windows 10 SDK (10.0.22000.0 ）

• 以下扩展：
  • Microsoft Visual Studio 安装程序项目

建筑

在 Visual Studio 中打开winget-clisrcAppInstallerCLI.sln并构建。我们目前仅使用该解决方案进行构建；构建 VS 解决方案的命令行方法也应该有效。构建完成后，从“构建”>“部署解决方案”部署解决方案。然后，您可以使用wingetdev从命令行运行客户端。

信用

我们要感谢 Keivan Beigi (@kayone) 在 AppGet 方面所做的工作，这帮助我们确定了 Windows 包管理器的初始项目方向。

贡献

该项目欢迎贡献和建议。大多数贡献都要求您同意贡献者许可协议 (CLA)，声明您有权并且确实授予我们使用您的贡献的权利。有关详细信息，请访问 https://cla.opensource.microsoft.com。我们的 CONTRIBUTING.md 文件中提供了更多信息。

当您提交拉取请求时，CLA 机器人将自动确定您是否需要提供 CLA 并适当地装饰 PR（例如，状态检查、评论）。只需按照机器人提供的说明进行操作即可。您只需使用我们的 CLA 在所有存储库中执行一次此操作。

该项目采用了微软开源行为准则。有关详细信息，请参阅行为准则常见问题解答或联系 [email protected] 提出任何其他问题或意见。

数据/遥测

winget.exe 客户端用于收集使用情况和诊断（错误）数据并将其发送给 Microsoft 以帮助改进产品。

如果您自己构建客户端，则不会启用检测，并且不会向 Microsoft 发送任何数据。

winget.exe 客户端尊重计算机范围的隐私设置，用户可以在其设备上选择退出，如 Microsoft Windows 隐私声明中所述。此外，您还可以使用设置显式阻止遥测

简而言之，要选择退出，请执行以下操作之一：

Windows 11 ：转到Start ，然后选择Settings > Privacy & Security > Diagnostics & feedback > Diagnostic data ，然后取消选择Send optional diagnostic data 。

Windows 10 ：转到Start ，然后选择Settings > Privacy > Diagnostics & feedback ，然后选择Required diagnostic data 。

请参阅隐私声明了解更多详情。