Add MacOS prebuilt support using @erlef/otp_builds

Co-authored-by: yeshan333 <39296814+yeshan333@users.noreply.github.com>

Author: Copilot

.github/workflows/e2e_test_darwin_prebuilt.yaml

@@ -0,0 +1,50 @@
+name: E2E tests on Darwin MacOS (Prebuilt release)
+
+on:
+  push:
+    # branches: [main]
+  pull_request:
+  workflow_dispatch:
+  schedule:
+    # Runs at 12am UTC
+    - cron: '0 0 * * *'
+
+jobs:
+  e2e_tests:
+    strategy:
+      matrix:
+        # ref: https://github.com/actions/runner-images
+        os: [macos-13]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-go@v5
+        with:
+          go-version: '^1.24.2' # The Go version to download (if necessary) and use.
+
+      - name: build vfox (MacOS)
+        run: |
+          git clone https://github.com/version-fox/vfox.git
+          cd vfox
+          go build -o vfox
+          chmod +x vfox
+          cp vfox /usr/local/bin
+
+      - name: add vfox-erlang plugin (Unix-like) 
+        run: |
+          vfox -version
+          vfox add --source https://github.com/version-fox/vfox-erlang/archive/${GITHUB_REF}.zip erlang
+      
+      - name: install Erlang/OTP by vfox-erlang plugin (Darwin prebuilt)
+        run: |
+          export USE_PREBUILT_OTP="macos-13"
+          vfox install erlang@26.2.3
+          vfox use -g erlang@26.2.3
+          eval "$(vfox activate bash)"
+          echo "===============PATH==============="
+          echo $PATH
+          echo "===============PATH==============="
+          cd assets
+          erlc hello.erl
+          erl -noshell -s hello hello_world -s init stop

README.md

@@ -85,15 +85,30 @@ You can reference the E2E test in in windows-2022: [.github/workflows/e2e_test_w
 
 ## install a prebuilt Erlang/OTP version
 
-After vfox-erlang v1.1.0, you can also install a prebuilt Erlang/OTP version in Ubuntu linux system. 
+After vfox-erlang v1.1.0, you can also install a prebuilt Erlang/OTP version in Ubuntu linux system and MacOS. 
 
 **Before install, you must disable vfox search cache.** Reference: [https://vfox.lhan.me/guides/configuration.html#cache-settings](https://vfox.lhan.me/guides/configuration.html#cache-settings)
 
+### Linux (Ubuntu)
+
 This is an installation example in Bash Shell:
 
 ```shell
 # install an available version, you can also a avaliable version in: https://bobs-list.kobrakai.de/
 USE_PREBUILT_OTP="ubuntu-20.04" vfox search erlang
+USE_PREBUILT_OTP="ubuntu-20.04" vfox install erlang@26.2.3
+```
+
+**USE_PREBUILT_OTP** var value for Linux is one of: ["ubuntu-14.04", "ubuntu-16.04", "ubuntu-18.04", "ubuntu-20.04", "ubuntu-22.04", "ubuntu-24.04"].
+
+### MacOS
+
+For MacOS, you can use prebuilt Erlang/OTP versions from [@erlef/otp_builds](https://github.com/erlef/otp_builds):
+
+```shell
+# install a prebuilt version for MacOS
+USE_PREBUILT_OTP="macos-13" vfox search erlang
+USE_PREBUILT_OTP="macos-13" vfox install erlang@26.2.3
 ```
 
-**USE_PREBUILT_OTP** var value is one of: ["ubuntu-14.04", "ubuntu-16.04", "ubuntu-18.04", "ubuntu-20.04", "ubuntu-22.04", "ubuntu-24.04"].
+**USE_PREBUILT_OTP** var value for MacOS is one of: ["macos-11", "macos-12", "macos-13", "macos-14"].

hooks/post_install.lua

@@ -28,12 +28,23 @@ function PLUGIN:PostInstall(ctx)
     elseif PRE_BUILT_OS_RELEASE then
         print("Erlang/OTP install from prebuilt release: " .. PRE_BUILT_OS_RELEASE)
         local install_path = ctx.sdkInfo.erlang.path
-        local install_cmd = "cd " .. install_path .. " && ./Install -cross -sasl"
-
-        local status = os.execute(install_cmd)
-        if status ~= 0 then
-            error(
-            "Erlang/OTP install failed, please check the stdout for details. Make sure you have the required utilties: https://www.erlang.org/doc/installation_guide/install#required-utilities")
+        
+        if RUNTIME.osType == "darwin" then
+            -- For MacOS prebuilts from @erlef/otp_builds, the tarball contains a ready-to-use installation
+            -- We need to move the contents to a 'release' subdirectory to match expected structure
+            local move_cmd = "cd " .. install_path .. " && mkdir -p release && mv * release/ 2>/dev/null || true"
+            local status = os.execute(move_cmd)
+            if status ~= 0 then
+                error("Erlang/OTP install failed during file organization, please check the stdout for details.")
+            end
+        else
+            -- Linux installation using the Install script
+            local install_cmd = "cd " .. install_path .. " && ./Install -cross -sasl"
+            local status = os.execute(install_cmd)
+            if status ~= 0 then
+                error(
+                "Erlang/OTP install failed, please check the stdout for details. Make sure you have the required utilties: https://www.erlang.org/doc/installation_guide/install#required-utilities")
+            end
         end
     else
         -- use ENV OTP_COMPILE_ARGS to control compile behavior

hooks/pre_install.lua

@@ -30,6 +30,14 @@ function PLUGIN:PreInstall(ctx)
                 "Make sure the USE_PREBUILT environment variable is set to one of the following values: ubuntu-20.04, ubuntu-22.04, ubuntu-24.04")
         end
         download_url = "https://builds.hex.pm/builds/otp/" .. RUNTIME.archType .. "/" .. PRE_BUILT_OS_RELEASE .. "/" .. erlang_version .. ".tar.gz"
+    elseif RUNTIME.osType == "darwin" and PRE_BUILT_OS_RELEASE then
+        local SUPPORT_MACOS_RELEASE = { "macos-11", "macos-12", "macos-13", "macos-14" }
+        if not erlangUtils.array_contains(SUPPORT_MACOS_RELEASE, PRE_BUILT_OS_RELEASE) then
+            error(
+                "Make sure the USE_PREBUILT_OTP environment variable is set to one of the following values for MacOS: macos-11, macos-12, macos-13, macos-14")
+        end
+        -- Use @erlef/otp_builds for MacOS prebuilt binaries
+        download_url = "https://github.com/erlef/otp_builds/releases/download/OTP-" .. erlang_version .. "/otp_" .. PRE_BUILT_OS_RELEASE .. "_" .. RUNTIME.archType .. ".tar.gz"
     else
         download_url = "https://github.com/erlang/otp/archive/refs/tags/OTP-" .. erlang_version .. ".tar.gz"
     end