{"id":7744,"date":"2022-08-03T09:00:33","date_gmt":"2022-08-03T16:00:33","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/commandline\/?p=7744"},"modified":"2022-11-30T07:58:59","modified_gmt":"2022-11-30T15:58:59","slug":"windows-package-manager-1-3","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/commandline\/windows-package-manager-1-3\/","title":{"rendered":"Windows Package Manager 1.3"},"content":{"rendered":"

Today I get to announce Windows Package Manager 1.3 has been released. The team has been adding several enhancements to manifests to improve your package installation experience. We\u2019ve enabled better package version reporting. A new setting allows verbose logs to be on by default. If you run winget --info<\/code> the system architecture is now displayed. The progress bar was improved with more fine-grained blocks. And the Windows Package Manager now supports portable applications.<\/p>\n

\"Running<\/a><\/p>\n

Manifest Improvements<\/h2>\n

Display Documentation<\/h3>\n

Some packages include documentation associated with a package version. You will now be able to see the documentation and an associated URL when you run winget show <package><\/code>.<\/p>\n

\"Documentation<\/a><\/p>\n

Installation Notes<\/h3>\n

Most command-line packages require a terminal restart for the environment variables to be loaded. Some other packages have nuances related to what a user should understand before running them the first time. Installation notes will be displayed after the package is installed. We\u2019ve also added arguments and settings to manage these notes. The default behavior is to display these notes. You can add \u201csuppressInstallNotes\u201d as a setting to prevent them from being displayed. You can also pass \u201c–display-notes\u201d or \u201c–suppress-notes\u201d to override settings.<\/p>\n

\"Installation<\/a><\/p>\n

Expected Return Code Response URL<\/h3>\n

Most .exe-based installers can provide custom responses for various failure scenarios. We\u2019ve added an enhancement to provide not only a standard error message, but now a URL can also be included. We\u2019re hoping this will help with troubleshooting why something didn\u2019t go quite right. Manifest authors can add a \u201cReturnResponseURL\u201d to the array of \u201cInstallerReturnCode\u201d values.<\/p>\n

Note:<\/em><\/strong> The following example shows an error that was intentionally forced to occur.<\/p>\n

\"Expected<\/a><\/p>\n

New Settings<\/h2>\n

The Windows Package Manager settings file is opened with your default JSON editor when you run winget settings<\/code>. If you happen to have Visual Studio Code installed and configured, you also get the benefit of the JSON schema for tooltips and code completion. If you don\u2019t, you can run winget install vscode<\/code>.<\/p>\n

Installation Notes<\/h3>\n

The Windows Package Manager was designed to behave in a predictable manner by default and give users the ability to customize those behaviors. The \u201csuppressInstallNotes\u201d setting was added for users who prefer not to see install notes included in manifests.<\/p>\n

Verbose Logs<\/h3>\n

If you add \u201c–verbose-logs\u201d to any command, the Windows Package Manager adds additional information to the logs. This is often helpful for troubleshooting or digging deeper into exactly what the Windows Package Manager is doing. Users can now specify what level of logging they want. The \u201cLogging\u201d levels available are \u201cverbose\u201d, \u201cinfo\u201d, \u201cwarning\u201d, \u201cerror\u201d, and \u201ccritical\u201d.<\/p>\n

New Version Reporting<\/h2>\n

Some packages like the Microsoft .NET SDK display versions to users that are slightly different from their build numbers. Unfortunately, this caused confusion during the upgrade process, and it caused frustration for manifest authors. The Windows Package Manager will now honor the preferred version publishers would like to display, and the tooling will still be able to make the correct comparisons when determining if a newer version is available.<\/p>\n

In the example below from Windows Apps & Features, you can see the Microsoft .NET Runtime packages and the Microsoft .NET SDK package versions displayed start with \u201c6.0\u201d. The but the Microsoft .NET SDK version below the display name starts with \u201c6.3\u201d. Manifests can now use the display version (\u201cpackageVersion\u201d in the manifest) to show users what version is installed or which upgrade is available, but it can still use the build version (\u201cdisplayVersion\u201d manifest key from the registry and \u201cAppsAndFeatures\u201d from the manifest) for comparison.<\/p>\n

\"AppsAndFeatures<\/a><\/p>\n

Display System Architecture<\/h2>\n

Not all packages run natively on every architecture. Sometimes packages are run under emulation. We\u2019ve updated winget --info<\/code> so it now displays the system architecture so you can quickly see what architecture your hardware has. This might help with troubleshooting why a particular package doesn\u2019t have a matching installer, or why it might not behave exactly as you expect.<\/p>\n

\"Running<\/a><\/p>\n

An Even Better Progress Bar<\/h2>\n

One of our most popular features is the customizable progress bar. Thanks to a community contribution, it just got better. Additional fine-grained blocks make that progress bar buttery smooth. If you didn\u2019t know, you can customize your progress bar in settings. I use:<\/p>\n

“visual”: {“progressBar”: “rainbow”}<\/p>\n

Don\u2019t worry, all the styles get the improved progress bar.<\/p>\n

Support for Portable Packages<\/h2>\n

Is there a portable package you wish you could manage with the Windows Package Manager? These are essentially just executable programs that don\u2019t have an installer. Maybe you would like to winget install Microsoft.NuGet<\/code> or winget upgrade Microsoft.NuGet<\/code>. We wanted to make sure you could manage these portable packages, so we add the appropriate entries in Windows Apps & Features when you install them. That allows you to see them as installed applications. You can even uninstall them from there if you don\u2019t want to type winget uninstall Microsoft.NuGet<\/code>.<\/p>\n

\"Uninstall<\/a><\/p>\n

Note:<\/em><\/strong> We\u2019ve added Microsoft.NuGet to the repository so you can test this out. It will fail on Windows Package Manager versions lower than 1.3 as shown in the image below.<\/p>\n

\"Error<\/a><\/p>\n

Submitting Manifests for Portable Packages<\/h3>\n

The Windows Package Manager Community Repository<\/a> will begin accepting submissions for other portable packages after the upgrade has rolled out to a majority of the user base. This should take about one week. If you want to submit a pull request, go ahead. We\u2019ll mark it as blocked for now, and as soon as we begin to accept portable packages, we will run them all through validation.<\/p>\n","protected":false},"excerpt":{"rendered":"

Today I get to announce Windows Package Manager 1.3 has been released. The team has been adding several enhancements to manifests to improve your package installation experience. We\u2019ve enabled better package version reporting. A new setting allows verbose logs to be on by default. If you run winget –info the system architecture is now displayed. […]<\/p>\n","protected":false},"author":27535,"featured_media":7800,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1,1535,1728,5,1577],"tags":[29,1548,1576,1579],"class_list":["post-7744","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-commandline","category-open-source","category-windows","category-windows-10","category-windows-package-manager","tag-command-line","tag-open-source","tag-windows-package-manager","tag-winget"],"acf":[],"blog_post_summary":"

Today I get to announce Windows Package Manager 1.3 has been released. The team has been adding several enhancements to manifests to improve your package installation experience. We\u2019ve enabled better package version reporting. A new setting allows verbose logs to be on by default. If you run winget –info the system architecture is now displayed. […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/commandline\/wp-json\/wp\/v2\/posts\/7744","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/commandline\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/commandline\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/commandline\/wp-json\/wp\/v2\/users\/27535"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/commandline\/wp-json\/wp\/v2\/comments?post=7744"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/commandline\/wp-json\/wp\/v2\/posts\/7744\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/commandline\/wp-json\/wp\/v2\/media\/7800"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/commandline\/wp-json\/wp\/v2\/media?parent=7744"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/commandline\/wp-json\/wp\/v2\/categories?post=7744"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/commandline\/wp-json\/wp\/v2\/tags?post=7744"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}