pio-update
Update the PlatformIO core and packages
TLDR
Perform a full update of all packages, development platforms and global libraries
Update core packages only (skips platforms and libraries)
Check for new versions of packages, platforms and libraries but do not actually update them
SYNOPSIS
pio update
PARAMETERS
--core-packages
Forces the update of PlatformIO Core packages only.
--force
Forces the update even if the PlatformIO Core is already up-to-date.
--with-package-manager
Update PlatformIO Package Manager (pioregr).
DESCRIPTION
The `pio update` command is used to update the PlatformIO Core (the command-line interface) and related components like PlatformIO platforms and libraries. This ensures that you have the latest features, bug fixes, and security patches. Running this command regularly is recommended for a stable and up-to-date development environment for embedded systems development. It automatically checks for newer versions of PlatformIO Core and any installed PlatformIO platforms/libraries. If updates are available, it downloads and installs them. The update process usually involves checking dependencies, downloading new packages, and replacing old files. This command can resolve incompatibilities between different PlatformIO components, and improves overall stability of the PlatformIO development environment. The update includes updates of PlatformIO's package manager, `pioregr`, the core that is used as the interpreter of `platformio.ini` files.
CAVEATS
The `pio update` command requires an active internet connection to download updates.
Ensure that you have sufficient permissions to install software on your system.
Interruption during the update process can lead to corruption, so avoid closing the terminal or restarting your system during the update.
TROUBLESHOOTING
If you encounter errors during the update process, try running the command with the `--force` option to force the update. If the problem persists, consider reinstalling PlatformIO Core from scratch.
UPDATE FREQUENCY
It is recommended to run `pio update` periodically (e.g., weekly or monthly) to ensure you have the latest bug fixes and improvements. Consider updating PlatformIO prior to opening new issues or reporting bugs to ensure you are running the most recent version.
HISTORY
The `pio update` command is a fundamental part of PlatformIO, designed to maintain the toolchain's integrity and functionality. It was introduced to simplify the update process and address the complexities of managing dependencies in embedded development. It has been consistently refined with each PlatformIO release to improve its reliability and efficiency.
SEE ALSO
pio upgrade(1), pio platform(1), pio lib(1)
