version-fox / vfox-elixir

Elixir vfox plugin. Use the vfox to manage multiple Elixir versions in Linux/Darwin MacOS/Windows. all platform~
Apache License 2.0
7 stars 1 forks source link
elixir elixir-lang elixir-windows vfox vfox-plugin
![logo](./assets/vfox-elixir-logo.png) [![E2E tests](https://github.com/version-fox/vfox-elixir/actions/workflows/e2e_test.yaml/badge.svg)](https://github.com/version-fox/vfox-elixir/actions/workflows/e2e_test.yaml)

vfox-elixir plugin

Elixir vfox plugin. Use the vfox to manage multiple Elixir versions in Linux/Darwin MacOS/Windows. all platform~

Usage

# install plugin
vfox add --source https://github.com/version-fox/vfox-elixir/archive/refs/heads/main.zip elixir

# install an available version
vfox search elixir
# or specific version 
vfox install elixir@1.16.2

Before install Elixir

vfox-elixir plugin would install Elixir through the Elixir source code compilation. So you must have the utilities mentioned in the document -> Compiling from source.

The installation of Elixir relies on Erlang/OTP. You can use the vfox-erlang plugin to manage your Erlang/OTP versions.

Ensure that Elixir and Erlang/OTP versions are compatible -> Elixir and Erlang/OTP compatibility.

Here are two examples of installing on Ubuntu 20.04 and MacOS 13.

install in Linux (Ubuntu 20.04)

# install utilities
sudo apt-get -y install build-essential autoconf m4 libncurses5-dev libwxgtk3.0-gtk3-dev libwxgtk-webview3.0-gtk3-dev libgl1-mesa-dev libglu1-mesa-dev libpng-dev libssh-dev unixodbc-dev xsltproc fop libxml2-utils libncurses-dev openjdk-11-jdk

# install Erlang/OTP
vfox add --source https://github.com/version-fox/vfox-erlang/archive/refs/heads/main.zip erlang
vfox install erlang@26.2.3
vfox use -g erlang@26.2.3

# install Elixir
vfox add --source https://github.com/version-fox/vfox-elixir/archive/refs/heads/main.zip elixir
vfox install elixir@1.16.2
vfox use -g elixir@1.16.2

You can reference the E2E test in Ubuntu 20.04: https://github.com/version-fox/vfox-elixir/actions/workflows/e2e_test.yaml

install in Darwin (MacOS 12)

# install utilities
brew install autoconf libxslt fop wxwidgets openssl

# install Erlang/OTP
vfox add --source https://github.com/version-fox/vfox-erlang/archive/refs/heads/main.zip erlang
vfox install erlang@26.2.3
vfox use -g erlang@26.2.3

# install Elixir
vfox add --source https://github.com/version-fox/vfox-elixir/archive/refs/heads/main.zip elixir
vfox install elixir@1.16.2
vfox use -g elixir@1.16.2

You can reference the E2E test in MacOS 12: https://github.com/version-fox/vfox-elixir/actions/workflows/e2e_test.yaml

install Elixir in Windows platform

You should use the v.0.5.3+ vfox version to add vfox-elixir plugin in Wondows platform. Only support install Elixir versions after v1.15, Elixir versions before v1.15 can also be installed using the deprecated Online Elixir Installer.

# make sure an Erlang/OTP version is installed.
vfox use -g erlang@26.2.3

# Get avaliable version
vfox search elixir

# install an specific version
vfox install elixir@1.16.2-elixir-otp-26