5.0 KiB
Versões
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.
Instalar Versão
asdf install <name> <version>
# asdf install erlang 17.3
Se um plugin suporta o download e compilação do código-fonte, você pode especificar ref:foo no qual foo é uma 'branch' especifica, 'tag', ou 'commit'. Você também precisará usar o mesmo nome e referência ao desinstalar.
Instalar última versão estável
asdf install <name> latest
# asdf install erlang latest
Instale a última versão estável que inicia com um texto.
asdf install <name> latest:<version>
# asdf install erlang latest:17
Listar versões instaladas
asdf list <name>
# asdf list erlang
Limite as versões que inicie com um determinado texto.
asdf list <name> <version>
# asdf list erlang 17
Listar todas as versões disponíveis
asdf list all <name>
# asdf list all erlang
Limite as versões que inicie com um determinado texto.
asdf list all <name> <version>
# asdf list all erlang 17
Mostrar última versão estável
asdf latest <name>
# asdf latest erlang
Mostrar última versão estável que inicie com um determinado texto.
asdf latest <name> <version>
# asdf latest erlang 17
Selecionar versão atual
asdf global <name> <version> [<version>...]
asdf shell <name> <version> [<version>...]
asdf local <name> <version> [<version>...]
# asdf global elixir 1.2.4
asdf global <name> latest[:<version>]
asdf local <name> latest[:<version>]
# asdf global elixir latest
global escreve a versão para $HOME/.tool-versions.
shell selecione a versão na variável de ambiente ASDF_${LANG}_VERSION, para a atual seção do shell.
local escreve a versão para $PWD/.tool-versions, crie se necessário .
Veja em .tool-versions arquivo de seleção de configuração para mais detalhes.
::: warning Alternativa
Se você quiser selecionar a versão atual do seu shell ou para executar um comando em uma versão específica de sua ferramenta, você pode selecionar a versão na variável de ambiente ASDF_${TOOL}_VERSION.
:::
O seguinte exemplo executa os testes em um projeto Elixir na versão 1.4.0.
O formato da versão é o mesmo suportado pelo arquivo .tool-versions.
ASDF_ELIXIR_VERSION=1.4.0 mix test
Resposta do sistema de versão
Para usar o sistema de versão da ferramenta <name> inicie um gerenciador de versões do asdf para selecionar a versão na ferramenta do system.
Selecione o sistema com global, local ou shell
Set system with either global, local or shell conforme descrito em Selecionar versão atual.
asdf local <name> system
# asdf local python system
Verificar a versão atual
asdf current
# asdf current
# erlang 17.3 (set by /Users/kim/.tool-versions)
# nodejs 6.11.5 (set by /Users/kim/cool-node-project/.tool-versions)
asdf current <name>
# asdf current erlang
# 17.3 (set by /Users/kim/.tool-versions)
Desinstalar versão
asdf uninstall <name> <version>
# asdf uninstall erlang 17.3
Shims
Quando asdf instala um pacote é criado shims para cada programa executado no pacote do diretório $ASDF_DATA_DIR/shims (padrão ~/.asdf/shims). Esse diretório começa no $PATH (pelos asdf.sh, asdf.fish, etc) é como o programa instalado é disponibilizado no ambiente do sistema.
Os shims em si são atalhos simples que executam um programa auxiliar asdf exec passando o nome do plugin e o caminho para o executável no pacote instalado que o shim está contido.
O asdf exec ajuda a determinar a versão do pacote usado (como especificado no arquivo .tool-versions, pelo asdf local ... ou asdf global ...), o final do path do executavél no pacote instalado no diretório (pode ser manipulado pelo exec-path no callback do plugin) e o ambiente executado em (também fornecido pelo plugin - exec-env) e finalmente executado.
::: warning Observação
Observe que, como este sistema usa chamadas exec, qualquer scripts no pacote devem ser fornecidos pelo shell, a instancia em execução precisa ser aessado diretamente ao invés do shim. Os dois comandos do asdf: which e where pode ajudar com o retorno do caminho para o pacote instalado:
:::
# retorna o 'path' da versão atual em execução
source $(asdf which ${PLUGIN})/../script.sh
# retorna o 'path' do pacote instalado no diretório
source $(asdf where ${PLUGIN} $(asdf current ${PLUGIN}))/bin/script.sh
Ignorando shims do asdf
Se por algum motivo você deseja ignorar shims do asdf ou deseja que suas variáveis de ambiente sejam definidas automaticamente ao entrar no diretório do seu projeto, pode ser útil o asdf-direnv. Verifique o README para mais detalhes.