mirror of
https://github.com/ohmyzsh/ohmyzsh.git
synced 2026-01-23 02:35:38 +01:00
44 lines
1.4 KiB
Markdown
44 lines
1.4 KiB
Markdown
# asdf
|
||
|
||
Adds integration with [asdf](https://github.com/asdf-vm/asdf), the extendable version manager, with support for Ruby, Node.js, Elixir, Erlang and more.
|
||
|
||
## Installation
|
||
|
||
1. [Install](https://asdf-vm.com/guide/getting-started.html#_1-install-asdf) asdf and ensure that's it's discoverable on `$PATH`;
|
||
2. Enable it by adding it to your `plugins` definition in `~/.zshrc`:
|
||
|
||
```sh
|
||
plugins=(asdf)
|
||
```
|
||
|
||
## Usage
|
||
|
||
Refer to the [asdf plugin documentation](https://asdf-vm.com/guide/getting-started.html#_4-install-a-plugin) for information on how to add a plugin and install the many runtime versions for it.
|
||
|
||
Example for installing the nodejs plugin and the many runtimes for it:
|
||
|
||
```sh
|
||
# Add plugin to asdf
|
||
asdf plugin add nodejs
|
||
|
||
# Install the latest available nodejs runtime version
|
||
asdf install nodejs latest
|
||
|
||
# Install nodejs v16.5.0 runtime version
|
||
asdf install nodejs 16.5.0
|
||
|
||
# Set the latest version in .tools-version in the current working directory
|
||
asdf set nodejs latest
|
||
|
||
# Set a version globally that will apply to all directories under $HOME
|
||
asdf set -u nodejs 16.5.0
|
||
```
|
||
|
||
## Backward Compatibility
|
||
|
||
`asdf` has significantly changed since 0.16.0. The current implementation doesn’t align with older versions. **If you're using 0.15.0 or older version, please follow upgrade guide in official page**: https://asdf-vm.com/guide/upgrading-to-v0-16.html.
|
||
|
||
|
||
## Maintainer
|
||
|
||
- [@RobLoach](https://github.com/RobLoach)
|