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

asdf exec <command> [args...]

Executa o comando shim para a versão atual

Variável de Ambiente

asdf env <command> [util]

Informações

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

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

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:

➜ 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 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

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

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

2. Remova o diretório $HOME/.asdf:

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

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

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

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"

2. Remova o diretório $HOME/.asdf:

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

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

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

Bash & Homebrew

1. Em seu ~/.bashrc 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

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

2. Desinstale usando seu gerenciador de pacotes:

brew uninstall asdf --force

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

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.

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

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

2. Desinstale usando seu gerenciador de pacotes:

brew uninstall asdf --force

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

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

Bash & Pacman

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

. /opt/asdf-vm/asdf.sh

2. Desinstale usando seu gerenciador de pacotes:

pacman -Rs asdf-vm

3. Remova o diretório $HOME/.asdf:

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

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

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

Fish & Git

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

source ~/.asdf/asdf.fish

e remova os complementos de com esse comando:

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

2. Remova o diretório $HOME/.asdf:

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

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

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

Fish & Homebrew

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

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

2. Desinstale usando seu gerenciador de pacotes:

brew uninstall asdf --force

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

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

Fish & Pacman

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

source /opt/asdf-vm/asdf.fish

2. Desinstale usando seu gerenciador de pacotes:

pacman -Rs asdf-vm

3. Remova o diretório $HOME/.asdf:

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

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

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

Elvish & Git

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

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:

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

2. Remova o diretório $HOME/.asdf:

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

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

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

Elvish & Homebrew

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

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:

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

2. Desinstale com seu gerenciador de pacotes:

brew uninstall asdf --force

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

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

Elvish & Pacman

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

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:

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

2. Desinstale com seu gerenciador de pacotes:

pacman -Rs asdf-vm

3. Remova o diretório $ HOME/.asdf:

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

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

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

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

Ou use ZSH Framework plugin.

2. Remova o diretório $HOME/.asdf:

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

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

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

ZSH & Homebrew

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

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

2. Desinstale usando seu gerenciador de pacotes:

brew uninstall asdf --force

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

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

ZSH & Pacman

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

. /opt/asdf-vm/asdf.sh

2. Desinstale usando seu gerenciador de pacotes:

pacman -Rs asdf-vm

3. Remova o diretório $HOME/.asdf:

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

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

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

Tudo pronto! 🎉