Skip to content

Latest commit

 

History

History
433 lines (281 loc) · 9.79 KB

core.md

File metadata and controls

433 lines (281 loc) · 9.79 KB
Raw

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 CLI allow global installation of executables, for example, installing Yarn 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.js ships with two executables, node and npm. When many versions of the tools are installed with asdf-nodejs 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:

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:

::: details 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. Remova o diretório $HOME/.asdf:
rm -rf ${ASDF_DATA_DIR:-$HOME/.asdf}
  1. Execute o comando para remover todos os arquivos de configurações do asdf:
rm -rf $HOME/.tool-versions $HOME/.asdfrc

:::

::: details 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. Remova o diretório $HOME/.asdf:
rm -rf ${ASDF_DATA_DIR:-$HOME/.asdf}
  1. Execute o comando para remover todos os arquivos de configurações do asdf:
rm -rf $HOME/.tool-versions $HOME/.asdfrc

:::

::: details 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.

  1. Desinstale usando seu gerenciador de pacotes:
brew uninstall asdf --force
  1. Execute o comando para remover todos os arquivos de configurações do asdf:
rm -rf $HOME/.tool-versions $HOME/.asdfrc

:::

::: details Bash & Pacman

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

:::

::: details 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
  1. Remova o diretório $HOME/.asdf:
rm -rf ${ASDF_DATA_DIR:-$HOME/.asdf}
  1. Execute o comando para remover todos os arquivos de configurações do asdf:
rm -rf $HOME/.tool-versions $HOME/.asdfrc

:::

::: details Fish & Homebrew

  1. Em seu ~/.config/fish/config.fish remova as linhas do asdf.fish:
source "(brew --prefix asdf)"/libexec/asdf.fish
  1. Desinstale usando seu gerenciador de pacotes:
brew uninstall asdf --force
  1. Execute o comando para remover todos os arquivos de configurações do asdf:
rm -rf $HOME/.tool-versions $HOME/.asdfrc

:::

::: details Fish & Pacman

  1. Em seu ~/.config/fish/config.fish remova as linhas do asdf.fish:
source /opt/asdf-vm/asdf.fish
  1. Desinstale usando seu gerenciador de pacotes:
pacman -Rs asdf-vm
  1. Remova o diretório $HOME/.asdf:
rm -rf ${ASDF_DATA_DIR:-$HOME/.asdf}
  1. Execute o comando para remover todos os arquivos de configurações do asdf:
rm -rf $HOME/.tool-versions $HOME/.asdfrc

:::

::: details 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
  1. Remova o diretório $HOME/.asdf:
if (!=s $E:ASDF_DATA_DIR "") { rm -rf $E:ASDF_DATA_DIR } else { rm -rf ~/.asdf }
  1. Execute este comando para remover todos os arquivos de configuração asdf:
rm -rf $HOME/.tool-versions $HOME/.asdfrc

:::

::: details 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
  1. Desinstale com seu gerenciador de pacotes:
brew uninstall asdf --force
  1. Execute este comando para remover todos os arquivos de configuração asdf:
rm -rf $HOME/.tool-versions $HOME/.asdfrc

:::

::: details 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
  1. Desinstale com seu gerenciador de pacotes:
pacman -Rs asdf-vm
  1. Remova o diretório $ HOME/.asdf:
if (!=s $E:ASDF_DATA_DIR "") { rm -rf $E:ASDF_DATA_DIR } else { rm -rf ~/.asdf }
  1. Execute este comando para remover todos os arquivos de configuração asdf:
rm -rf $HOME/.tool-versions $HOME/.asdfrc

:::

::: details 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.

  1. Remova o diretório $HOME/.asdf:
rm -rf ${ASDF_DATA_DIR:-$HOME/.asdf}
  1. Execute o comando para remover todos os arquivos de configurações do asdf:
rm -rf $HOME/.tool-versions $HOME/.asdfrc

:::

::: details ZSH & Homebrew

  1. Em seu ~/.zshrc remova as linhas do asdf.sh:
. $(brew --prefix asdf)/libexec/asdf.sh
  1. Desinstale usando seu gerenciador de pacotes:
brew uninstall asdf --force
  1. Execute o comando para remover todos os arquivos de configurações do asdf:
rm -rf $HOME/.tool-versions $HOME/.asdfrc

:::

::: details ZSH & Pacman

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

:::

Tudo pronto! 🎉