Guia para configurar um ambiente para Elixir usando ASDF

Se você está começando a desenvolver em Elixir ou precisa configurar um ambiente para trabalhar em um projeto existente, o ASDF é uma ferramenta útil para gerenciar diferentes versões do Elixir e do Erlang/OTP em seu sistema. Neste guia, explicaremos passo a passo como configurar seu ambiente usando o ASDF.

Passo 1: Instalação do ASDF

A primeira etapa é instalar o ASDF em seu sistema. Para fazer isso, siga as instruções em asdf-vm.com para sua plataforma específica. Certifique-se de seguir as etapas de instalação corretamente antes de prosseguir.

Passo 2: Instalação do Erlang

Após a instalação do ASDF, você precisa instalar o Erlang. Use os comandos a seguir para listar todas as versões disponíveis do Erlang:

asdf list-all erlang

Você verá uma lista de versões disponíveis, como "1.11.2", "1.11.2-otp-21", "1.11.2-otp-22", etc. Cada versão do Elixir é compilada com diferentes versões principais do Erlang/OTP. Para garantir a compatibilidade máxima entre o Elixir e o Erlang, escolha uma versão "-otp-XY" que corresponda à versão principal do Erlang instalada em seu sistema.

Por exemplo, se você instalou o Erlang 26.0, execute o seguinte comando para instalar o Erlang 26.0 usando o ASDF:

asdf install erlang 26.0

Passo 3: Instalação do Elixir

Após instalar o Erlang, você pode prosseguir com a instalação do Elixir. Use o seguinte comando para listar todas as versões disponíveis do Elixir:

asdf list-all elixir

Assim como no passo anterior, cada versão do Elixir tem múltiplas versões compiladas com diferentes versões principais do Erlang/OTP. Escolha uma versão do Elixir que corresponda à versão principal do Erlang que você instalou anteriormente.

Por exemplo, se você instalou o Erlang 26.0, execute o seguinte comando para instalar o Elixir 1.15.2-otp-26 usando o ASDF:

asdf install elixir 1.15.2-otp-26

Passo 4: Configuração global

Após a instalação do Erlang e do Elixir, você pode definir as versões globais para uso em todo o sistema. Use os comandos a seguir:

asdf global erlang 26.0
asdf global elixir 1.15.2-otp-26

Agora, o Erlang 26.0 e o Elixir 1.15.2-otp-26 estão configurados globalmente em seu sistema.

Passo 5: Configuração local (opcional)

Se você deseja configurar uma versão específica do Erlang e do Elixir para um projeto específico, você pode usar a configuração local. Navegue até o diretório do seu projeto e execute os seguintes comandos:

asdf local erlang 26.0
asdf
local elixir 1.15.2-otp-26

Isso configurará o Erlang e o Elixir especificados apenas para esse projeto específico. Certifique-se de executar esses comandos dentro do diretório raiz do seu projeto.

Passo 6: Verificação

Para verificar se a configuração foi feita corretamente, execute o seguinte comando:

elixir -v

Você verá a versão do Elixir sendo exibida, confirmando que seu ambiente foi configurado corretamente.

Conclusão

Neste guia, expliquei passo a passo como configurar um ambiente para Elixir usando o ASDF. Você aprendeu como instalar o ASDF, instalar versões específicas do Erlang e do Elixir e configurar globalmente ou localmente para seus projetos. Agora você está pronto para começar a desenvolver em Elixir com um ambiente devidamente configurado. Aproveite sua jornada de desenvolvimento!