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.

A lista de comandos do núcleo asdf é bastante pequena, mas pode facilitar muitos fluxos de trabalho.

Instalação e configuração

Baseado no Guia de Introdução.

Execute

shell

asdf exec <command> [args...]

asdf exec <command> [args...]

Executa o comando shim para a versão atual

Variável de Ambiente

shell

asdf env <command> [util]

asdf env <command> [util]

Informações

shell

asdf info

asdf info

Um comando auxiliar para imprimir as informações de depuração do SO, Shell e asdf. Compartilhe isso ao fazer um relatório de bug.

Reshim

shell

asdf reshim <name> <version>

asdf reshim <name> <version>

Isso recria os shims para a versão atual de um pacote. Por padrão, os calços são criados por plugins durante a instalação de uma ferramenta. Algumas ferramentas como a npm CLI permitem a instalação global de executáveis, por exemplo, instalando Yarn via npm install -g fio. Como este executável não foi instalado por meio do ciclo de vida do plug-in, ainda não existe shim para ele. asdf reshim nodejs <version> forçará o recálculo de shims para quaisquer novos executáveis, como yarn, para <version> de nodejs.

Versionamento do Shim

shell

asdf shim-versions <command>

asdf shim-versions <command>

Lista os plugins e versões que fornecem shims para um comando.

Como exemplo, o Node.js vem com dois executáveis, node e npm. Quando muitas versões das ferramentas são instaladas com asdf-nodejs shim-versions pode retornar:

shell

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

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

shell

➜ asdf shim-versions npm
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 tem um comando embutido para atualização que depende do Git (nosso método de instalação recomendado). Se você instalou usando um método diferente, siga as etapas para esse método:

Method	Latest Stable Release	Latest commit on `master`
asdf (via Git)	`asdf update`	`asdf update --head`
Homebrew	`brew upgrade asdf`	`brew upgrade asdf --fetch-HEAD`
Pacman	Obter manualmente um novo `PKGBUILD` e reconstruir ou usar suas preferências de AUR.

Desinstalar

Para desinstalar asdf siga os passos:

Bash & Git

Em seu ~/.bashrc remova as linhas do asdf.sh e seus complementos:

shell

. "$HOME/.asdf/asdf.sh"
. "$HOME/.asdf/completions/asdf.bash"

. "$HOME/.asdf/asdf.sh"
. "$HOME/.asdf/completions/asdf.bash"

Remova o diretório $HOME/.asdf:

shell

rm -rf "${ASDF_DATA_DIR:-$HOME/.asdf}"

rm -rf "${ASDF_DATA_DIR:-$HOME/.asdf}"

Execute o comando para remover todos os arquivos de configurações do asdf:

shell

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

Bash & Git (macOS)

Em seu ~/.bash_profile remova as linhas do asdf.sh e remova seus complementos:

shell

. "$HOME/.asdf/asdf.sh"
. "$HOME/.asdf/completions/asdf.bash"

. "$HOME/.asdf/asdf.sh"
. "$HOME/.asdf/completions/asdf.bash"

Remova o diretório $HOME/.asdf:

shell

rm -rf "${ASDF_DATA_DIR:-$HOME/.asdf}"

rm -rf "${ASDF_DATA_DIR:-$HOME/.asdf}"

Execute o comando para remover todos os arquivos de configurações do asdf:

shell

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

Bash & Homebrew

Em seu ~/.bashrc remova as linhas do asdf.sh e remova seus complementos:

shell

. $(brew --prefix asdf)/libexec/asdf.sh
. $(brew --prefix asdf)/etc/bash_completion.d/asdf.bash

. $(brew --prefix asdf)/libexec/asdf.sh
. $(brew --prefix asdf)/etc/bash_completion.d/asdf.bash

?> Os complementos precisam instruções de configuração do Homebrew e siga o guia de remoção.

Desinstale usando seu gerenciador de pacotes:

shell

brew uninstall asdf --force

brew uninstall asdf --force

Execute o comando para remover todos os arquivos de configurações do asdf:

shell

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

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.

Em seu ~/.bash_profile remova as linhas do asdf.sh e remova seus complementos:

shell

. $(brew --prefix asdf)/libexec/asdf.sh
. $(brew --prefix asdf)/etc/bash_completion.d/asdf.bash

. $(brew --prefix asdf)/libexec/asdf.sh
. $(brew --prefix asdf)/etc/bash_completion.d/asdf.bash

?> Os complementos precisam instruções de configuração do Homebrew e siga o guia de remoção.

Desinstale usando seu gerenciador de pacotes:

shell

brew uninstall asdf --force

brew uninstall asdf --force

Execute o comando para remover todos os arquivos de configurações do asdf:

shell

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

Bash & Pacman

Em seu ~/.bashrc remova as linhas do asdf.sh e seus complementos:

shell

. /opt/asdf-vm/asdf.sh

. /opt/asdf-vm/asdf.sh

Desinstale usando seu gerenciador de pacotes:

shell

pacman -Rs asdf-vm

pacman -Rs asdf-vm

Remova o diretório $HOME/.asdf:

shell

rm -rf "${ASDF_DATA_DIR:-$HOME/.asdf}"

rm -rf "${ASDF_DATA_DIR:-$HOME/.asdf}"

Execute o comando para remover todos os arquivos de configurações do asdf:

shell

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

Fish & Git

Em seu ~/.config/fish/config.fish remova as linhas do asdf.sh:

shell

source ~/.asdf/asdf.fish

source ~/.asdf/asdf.fish

e remova os complementos de com esse comando:

shell

rm -rf ~/.config/fish/completions/asdf.fish

rm -rf ~/.config/fish/completions/asdf.fish

Remova o diretório $HOME/.asdf:

shell

rm -rf (string join : -- $ASDF_DATA_DIR $HOME/.asdf)

rm -rf (string join : -- $ASDF_DATA_DIR $HOME/.asdf)

Execute o comando para remover todos os arquivos de configurações do asdf:

shell

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

Fish & Homebrew

Em seu ~/.config/fish/config.fish remova as linhas do asdf.fish:

shell

source "(brew --prefix asdf)"/libexec/asdf.fish

source "(brew --prefix asdf)"/libexec/asdf.fish

Desinstale usando seu gerenciador de pacotes:

shell

brew uninstall asdf --force

brew uninstall asdf --force

Execute o comando para remover todos os arquivos de configurações do asdf:

shell

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

Fish & Pacman

Em seu ~/.config/fish/config.fish remova as linhas do asdf.fish:

shell

source /opt/asdf-vm/asdf.fish

source /opt/asdf-vm/asdf.fish

Desinstale usando seu gerenciador de pacotes:

shell

pacman -Rs asdf-vm

pacman -Rs asdf-vm

Remova o diretório $HOME/.asdf:

shell

rm -rf (string join : -- $ASDF_DATA_DIR $HOME/.asdf)

rm -rf (string join : -- $ASDF_DATA_DIR $HOME/.asdf)

Execute o comando para remover todos os arquivos de configurações do asdf:

shell

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

Elvish & Git

Em seu ~/.config/elvish/rc.elv remova as linhas que importa o módulo asdf:

shell

use asdf _asdf; var asdf~ = $_asdf:asdf~
set edit:completion:arg-completer[asdf] = $_asdf:arg-completer~

use asdf _asdf; var asdf~ = $_asdf:asdf~
set edit:completion:arg-completer[asdf] = $_asdf:arg-completer~

e desinstale o módulo asdf com este comando:

shell

rm -f ~/.config/elvish/lib/asdf.elv

rm -f ~/.config/elvish/lib/asdf.elv

Remova o diretório $HOME/.asdf:

shell

if (!=s $E:ASDF_DATA_DIR "") { rm -rf $E:ASDF_DATA_DIR } else { rm -rf ~/.asdf }

if (!=s $E:ASDF_DATA_DIR "") { rm -rf $E:ASDF_DATA_DIR } else { rm -rf ~/.asdf }

Execute este comando para remover todos os arquivos de configuração asdf:

shell

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

Elvish & Homebrew

Em seu ~/.config/elvish/rc.elv remova as linhas que importa o módulo asdf:

shell

use asdf _asdf; var asdf~ = $_asdf:asdf~
set edit:completion:arg-completer[asdf] = $_asdf:arg-completer~

use asdf _asdf; var asdf~ = $_asdf:asdf~
set edit:completion:arg-completer[asdf] = $_asdf:arg-completer~

e desinstale o módulo asdf com este comando:

shell

rm -f ~/.config/elvish/lib/asdf.elv

rm -f ~/.config/elvish/lib/asdf.elv

Desinstale com seu gerenciador de pacotes:

shell

brew uninstall asdf --force

brew uninstall asdf --force

Execute este comando para remover todos os arquivos de configuração asdf:

shell

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

Elvish & Pacman

Em seu ~/.config/elvish/rc.elv remova as linhas que importa o módulo asdf:

shell

use asdf _asdf; var asdf~ = $_asdf:asdf~
set edit:completion:arg-completer[asdf] = $_asdf:arg-completer~

use asdf _asdf; var asdf~ = $_asdf:asdf~
set edit:completion:arg-completer[asdf] = $_asdf:arg-completer~

e desinstale o módulo asdf com este comando:

shell

rm -f ~/.config/elvish/lib/asdf.elv

rm -f ~/.config/elvish/lib/asdf.elv

Desinstale com seu gerenciador de pacotes:

shell

pacman -Rs asdf-vm

pacman -Rs asdf-vm

Remova o diretório $ HOME/.asdf:

shell

if (!=s $E:ASDF_DATA_DIR "") { rm -rf $E:ASDF_DATA_DIR } else { rm -rf ~/.asdf }

if (!=s $E:ASDF_DATA_DIR "") { rm -rf $E:ASDF_DATA_DIR } else { rm -rf ~/.asdf }

Execute este comando para remover todos os arquivos de configuração asdf:

shell

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

ZSH & Git

Em seu ~/.zshrc remova as linhas do asdf.sh e seus complementos:

shell

. "$HOME/.asdf/asdf.sh"
# ...
fpath=(${ASDF_DIR}/completions $fpath)
autoload -Uz compinit
compinit

. "$HOME/.asdf/asdf.sh"
# ...
fpath=(${ASDF_DIR}/completions $fpath)
autoload -Uz compinit
compinit

Ou use ZSH Framework plugin.

Remova o diretório $HOME/.asdf:

shell

rm -rf "${ASDF_DATA_DIR:-$HOME/.asdf}"

rm -rf "${ASDF_DATA_DIR:-$HOME/.asdf}"

Execute o comando para remover todos os arquivos de configurações do asdf:

shell

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

ZSH & Homebrew

Em seu ~/.zshrc remova as linhas do asdf.sh:

shell

. $(brew --prefix asdf)/libexec/asdf.sh

. $(brew --prefix asdf)/libexec/asdf.sh

Desinstale usando seu gerenciador de pacotes:

shell

brew uninstall asdf --force

brew uninstall asdf --force

Execute o comando para remover todos os arquivos de configurações do asdf:

shell

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

ZSH & Pacman

Em seu ~/.zshrc remova as linhas do asdf.sh:

shell

. /opt/asdf-vm/asdf.sh

. /opt/asdf-vm/asdf.sh

Desinstale usando seu gerenciador de pacotes:

shell

pacman -Rs asdf-vm

pacman -Rs asdf-vm

Remova o diretório $HOME/.asdf:

shell

rm -rf "${ASDF_DATA_DIR:-$HOME/.asdf}"

rm -rf "${ASDF_DATA_DIR:-$HOME/.asdf}"

Execute o comando para remover todos os arquivos de configurações do asdf:

shell

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

rm -rf "$HOME/.tool-versions" "$HOME/.asdfrc"

Tudo pronto! 🎉

Core ​

Instalação e configuração ​

Execute ​

Variável de Ambiente ​

Informações ​

Reshim ​

Versionamento do Shim ​

Atualizar ​

Desinstalar ​

Core

Instalação e configuração

Execute

Variável de Ambiente

Informações

Reshim

Versionamento do Shim

Atualizar

Desinstalar