Core

Hi, we've recently migrated our docs and added some new pages. If you would like to help translate this page, see the "Edit this page" link at the bottom of the page.

The core asdf command list is rather small, but can facilitate many workflows.

Installation & Setup

Covered in the Getting Started guide.

Exec

asdf exec <command> [args...]

Executes the command shim for the current version.

Env

asdf env <command> [util]

Info

asdf info

A helper command to print the OS, Shell and asdf debug information. Share this when making a bug report.

Reshim

asdf reshim <name> <version>

This recreates the shims for the current version of a package. By default, shims are created by plugins during installation of a tool. Some tools like the npm CLIopen in new window allow global installation of executables, for example, installing Yarnopen in new window via npm install -g yarn. Since this executable was not installed via the plugin lifecycle, no shim exists for it yet. asdf reshim nodejs <version> will force recalculation of shims for any new executables, like yarn, for <version> of nodejs .

Shim-versions

asdf shim-versions <command>

Lists the plugins and versions that provide shims for a command.

As an example, Node.jsopen in new window ships with two executables, node and npm. When many versions of the tools are installed with asdf-nodejsopen in new window shim-versions can return:

➜ asdf shim-versions node
nodejs 14.8.0
nodejs 14.17.3
nodejs 16.5.0
➜ asdf shim-versions npm
nodejs 14.8.0
nodejs 14.17.3
nodejs 16.5.0

Atualizar

asdf has a built in command to update which relies on Git (our recommended installation method). If you installed using a different method you should follow the steps for that method:

MethodLatest Stable ReleaseLatest commit on master
asdf (via Git)asdf updateasdf update --head
Homebrewbrew upgrade asdfbrew upgrade asdf --HEAD
PacmanObter manualmente um novo PKGBUILD e
reconstruir ou usar suas preferências de AURopen in new window.

Desinstalar

Para desinstalar asdf siga os passos:

Bash & Git
  1. Em seu ~/.bashrc remova as linhas do asdf.sh e seus complementos:
. $HOME/.asdf/asdf.sh
. $HOME/.asdf/completions/asdf.bash
1
2
  1. Remova o diretório $HOME/.asdf:
rm -rf ${ASDF_DATA_DIR:-$HOME/.asdf}
1
  1. Execute o comando para remover todos os arquivos de configurações do asdf:
rm -rf $HOME/.tool-versions $HOME/.asdfrc
1
Bash & Git (macOS)
  1. Em seu ~/.bash_profile remova as linhas do asdf.sh e remova seus complementos:
. $HOME/.asdf/asdf.sh
. $HOME/.asdf/completions/asdf.bash
1
2
  1. Remova o diretório $HOME/.asdf:
rm -rf ${ASDF_DATA_DIR:-$HOME/.asdf}
1
  1. Execute o comando para remover todos os arquivos de configurações do asdf:
rm -rf $HOME/.tool-versions $HOME/.asdfrc
1
Bash & Homebrew (macOS)

Caso esteja usando macOs Catalina ou mais recente, por padrão o shell é ZSH. Se não achar alguma configuração em seu ~/.bash_profile talvez esteja em ~/.zshrc em cada caso siga as intruções do ZSH.

  1. Em seu ~/.bash_profile remova as linhas do asdf.sh e remova seus complementos:
. $(brew --prefix asdf)/libexec/asdf.sh
. $(brew --prefix asdf)/etc/bash_completion.d/asdf.bash
1
2

?> Os complementos precisam instruções de configuração do Homebrewopen in new window e siga o guia de remoção.

  1. Desinstale usando seu gerenciador de pacotes:
brew uninstall asdf --force
1
  1. Execute o comando para remover todos os arquivos de configurações do asdf:
rm -rf $HOME/.tool-versions $HOME/.asdfrc
1
Bash & Pacman
  1. Em seu ~/.bashrc remova as linhas do asdf.sh e seus complementos:
. /opt/asdf-vm/asdf.sh
1
  1. Desinstale usando seu gerenciador de pacotes:
pacman -Rs asdf-vm
1
  1. Remova o diretório $HOME/.asdf:
rm -rf ${ASDF_DATA_DIR:-$HOME/.asdf}
1
  1. Execute o comando para remover todos os arquivos de configurações do asdf:
rm -rf $HOME/.tool-versions $HOME/.asdfrc
1
Fish & Git
  1. Em seu ~/.config/fish/config.fish remova as linhas do asdf.sh:
source ~/.asdf/asdf.fish
1

e remova os complementos de com esse comando:

rm -rf ~/.config/fish/completions/asdf.fish
1
  1. Remova o diretório $HOME/.asdf:
rm -rf ${ASDF_DATA_DIR:-$HOME/.asdf}
1
  1. Execute o comando para remover todos os arquivos de configurações do asdf:
rm -rf $HOME/.tool-versions $HOME/.asdfrc
1
Fish & Homebrew
  1. Em seu ~/.config/fish/config.fish remova as linhas do asdf.fish:
source "(brew --prefix asdf)"/libexec/asdf.fish
1
  1. Desinstale usando seu gerenciador de pacotes:
brew uninstall asdf --force
1
  1. Execute o comando para remover todos os arquivos de configurações do asdf:
rm -rf $HOME/.tool-versions $HOME/.asdfrc
1
Fish & Pacman
  1. Em seu ~/.config/fish/config.fish remova as linhas do asdf.fish:
source /opt/asdf-vm/asdf.fish
1
  1. Desinstale usando seu gerenciador de pacotes:
pacman -Rs asdf-vm
1
  1. Remova o diretório $HOME/.asdf:
rm -rf ${ASDF_DATA_DIR:-$HOME/.asdf}
1
  1. Execute o comando para remover todos os arquivos de configurações do asdf:
rm -rf $HOME/.tool-versions $HOME/.asdfrc
1
ZSH & Git
  1. Em seu ~/.zshrc remova as linhas do asdf.sh e seus complementos:
. $HOME/.asdf/asdf.sh
# ...
fpath=(${ASDF_DIR}/completions $fpath)
autoload -Uz compinit
compinit
1
2
3
4
5

Ou use ZSH Framework plugin.

  1. Remova o diretório $HOME/.asdf:
rm -rf ${ASDF_DATA_DIR:-$HOME/.asdf}
1
  1. Execute o comando para remover todos os arquivos de configurações do asdf:
rm -rf $HOME/.tool-versions $HOME/.asdfrc
1
ZSH & Homebrew
  1. Em seu ~/.zshrc remova as linhas do asdf.sh:
. $(brew --prefix asdf)/libexec/asdf.sh
1
  1. Desinstale usando seu gerenciador de pacotes:
brew uninstall asdf --force
1
  1. Execute o comando para remover todos os arquivos de configurações do asdf:
rm -rf $HOME/.tool-versions $HOME/.asdfrc
1
ZSH & Pacman
  1. Em seu ~/.zshrc remova as linhas do asdf.sh:
. /opt/asdf-vm/asdf.sh
1
  1. Desinstale usando seu gerenciador de pacotes:
pacman -Rs asdf-vm
1
  1. Remova o diretório $HOME/.asdf:
rm -rf ${ASDF_DATA_DIR:-$HOME/.asdf}
1
  1. Execute o comando para remover todos os arquivos de configurações do asdf:
rm -rf $HOME/.tool-versions $HOME/.asdfrc
1

Tudo pronto! 🎉