Chocolatey v0.9.9 Release Notes
Release Date: 2015-03-03 // about 9 years ago-
This also includes issues that were being tracked in the old Chocolatey repository: Chocolatey 0.9.9.
๐ The two links above will not capture everything that has changed, since this is a complete rewrite. We broke everything. If this were a v1+, it would be a major release. But we are less than v1, so 0.9.9 it is! ;)
๐ Okay, so we didn't really break everything. We have maintained nearly full compatibility with how you pass options into choco, although the output may be a bit different (but better, we hope) and in at least one case, additional switches (or a feature setting) is/are required - we limited this to security related changes only.
๐ We also fixed and improved a bunch of things, so we feel the trade off is well worth the changes.
We'll try to capture everything here that you should know about. Please call
choco -?
orchoco.exe -h
to get started.KNOWN ISSUES
- Known Issues
- TEMPORARY
install all
is missing - this is expected to be back in 0.9.10 - see #23 - Alternative sources (
webpi
,ruby
,python
,cygwin
,windowsfeature
) do not work yet. This is expected to be fixed in 0.9.10 - see #14 - Progress bar is missing when downloading until we are using internal posh components for Packages - see #56
- See Feature Parity for items not yet reimplemented from older PowerShell Chocolatey client (v0.9.8.32 and below).
๐ฅ BREAKING CHANGES
- [Security] Prompt for confirmation: For security reasons, we now stop for confirmation before changing the state of the system on most commands. You can pass
-y
to confirm any prompts or set a value in the config that will globally confirm - see #52 (NOTE: This is one of those additional switches we were talking about) - [Security] If your default installation is still at
c:\Chocolatey
, this version will force a move to ProgramData and update the environment settings - see #7 - Configuration Breaking Changes:
- You now have one config file to interact with in %ChocolateyInstall%\config - your user config is no longer valid and can be removed once you migrate settings to the config.
- The config will no longer be overwritten on upgrade.
- Choco no longer interacts with NuGet's config file at all. You will need to reset all of your apiKeys (see features for
apikey
). On the plus side, the keys will work for all users of the machine, unlike NuGet's apiKeys (only work for the user that sets them). - This also means you can no longer use
useNugetForSources
. It has been removed as a config setting.
- Packaging Changes:
- Choco now installs packages without version numbers on folders. This means quite a few things...
- Upgrading packages doesn't install a new version next to an old version, it actually upgrades.
- Dependencies resolve at highest available version, not the minimum version as before - see Chocolatey #415
- Package Maintenance Changes:
- Read the above about apikey changes
- Read above about dependency resolution changes.
- Deprecated/Removed Commands:
installmissing
and 'cinstm' have been removed. They were deprecated awhile ago, so this should not be a surprise. For equivalent functionality see the plain install/cinst commands.choco version
has been deprecated and will be removed in v1. Usechoco upgrade pkgName --noop
orchoco upgrade pkgName -whatif
instead.Write-ChocolateySuccess
,Write-ChocolateyFailure
have been deprecated.update
is nowupgrade
.update
has been deprecated and will be removed/replaced in v1. Update will be reincarnated later for a different purpose. Hint: It rhymes with smackage pindexes.
๐ FEATURES
- In app documentation! Use
choco -?
,choco -h
orchoco commandName -?
to learn about each command, complete with examples! - WhatIf/Noop mode for all commands (
--noop
can also be specified as-whatif
) - see Chocolatey #263 and Default Options and Switches - Performs like a package manager, expect to see queries failing because of unmet dependency issues.
- New Commands:
pin
- Suppress upgrades. This allows you to 'pin' an install to a particular version - see #1, Chocolatey #5 and Pin Commandapikey
- see ApiKey Commandnew
- see New Command and Chocolatey #157
- New ways to pass arguments! See How to Pass Options/Switches
- Did we mention there is a help menu that is actually helpful now? Shiny!
- AutoUninstaller!!!! But it is not enabled by default this version. See #15, #9 and Chocolatey #6
- New Helpers:
Install-ChocolateyShortcut
- see Chocolatey #238, Chocolatey #235 and Chocolatey #218
๐ BUG FIXES
๐ Probably a lot of bug fixes that may not make it here, but here are the ones we know about.
- Fix - Cannot upgrade from prerelease to same version released - see Chocolatey #122
- Fix - install
--force
should not use cache - see Chocolatey #199 - Fix - force dependencies as well - see --force-dependencies and Chocolatey #199
- Fix - Chocolatey should not stop on error - see Chocolatey #192
- Fix - Upgrading does not remove previous version - see Chocolatey #259
- Fix - Non-elevated shell message spills errors - see Chocolatey #540
- Fix - Package names are case sensitive for some sources - see Chocolatey #589
- Fix - Install-ChocolateyVsixPackage doesn't check for correct VS 2012 path - see Chocolatey #601
- Fix - Chocolatey behaves strangely after ctrl+c - see Chocolatey #608
- Fix - Uninstall doesn't respect version setting - see Chocolatey #612
- Fix - No update after download error - see Chocolatey #637
- Fix - cup ends silently on error - see Chocolatey #312
- Fix - cpack silently fails when dependency .NET 4.0+ is not met - see Chocolatey #270
- Fix - Regression in cver all in 0.9.8.27 - see Chocolatey #530
- Fix - Certain installs and updates fail with a "process with an Id of xxxx is not running" error - see Chocolatey #603
๐ IMPROVEMENTS
- [Security] Allow keeping
c:\chocolatey
install directory with environment variable - see #17 - [Security] Require switch on unofficial build - see #36
- Install script updates - see #7
- Ensure Chocolatey pkg is installed properly in lib folder - This means you can take a dependency on a minimum version of Chocolatey (we didn't like that before) - see #19
- Uninstall - allow abort - see #43
- Support for HTTPS basic authorization - see Chocolatey #128
- Smooth out success/failure logging - see Chocolatey #154
- Add $env:CHOCOLATEY_VERSION - see Chocolatey #251
- Replace ascii cue with visual cues - see Chocolatey #376
- Uninstall all versions of an app - see Chocolatey #389
- Add parameters in packages.config files - see Packages.config, Chocolatey #472, and #10
- Choco pack should support
-version
- see Chocolatey #526 - Enhancements to Start-ChocolateyProcessAsAdmin - see Chocolatey #564
- Install-ChocolateyFileAssociation - add label to new file types - see Chocolatey #564
- Clean up the verobsity of Chocolatey - see Chocolatey #374
- Compact choco upgrade --noop option - see Chocolatey #414
- Remove references to the Chocolatey gods - see Chocolatey #669
- Shims now have noop (
--shimgen-noop
) and help (--shimgen-help
) switches - see ShimGen #8 and ShimGen #10 - Shims will terminate underlying process on termination signal - see ShimGen #11
- Shims now have gui (
--shimgen-gui
) and exit (--shimgen-exit
) switches - see ShimGen #13 and ShimGen #12 - Dat help menu tho. I mean srsly guise - see Chocolatey #641