ci: enhance build workflow with multi-platform support

Add macOS build target and implement matrix-based builds for all platforms.
Refactor GitHub Actions workflow to separate build and release jobs, with
proper artifact handling. Update documentation with platform-specific build
requirements and extend build script to support macOS compilation using Zig.

Author: devlifeX

.github/workflows/go.yml

@@ -1,7 +1,4 @@
-# This workflow will build a golang project
-# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-go
-
-name: Go
+name: Build and Release
 
 on:
   push:
@@ -13,9 +10,21 @@ on:
 
 jobs:
   build:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
+    name: Build on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        include:
+          - os: ubuntu-latest
+            output_name: dback-linux
+            asset_name: dback-linux
+          - os: macos-latest
+            output_name: dback-macos
+            asset_name: dback-macos
+          - os: windows-latest
+            output_name: dback-windows.exe
+            asset_name: dback-windows.exe
+
     steps:
       - uses: actions/checkout@v4
 
@@ -24,25 +33,54 @@ jobs:
         with:
           go-version: "1.21"
 
-      - name: Install Dependencies (Linux & Windows Cross-Compile)
+      # Install dependencies only on Linux
+      - name: Install Linux Dependencies
+        if: runner.os == 'Linux'
         run: |
           sudo apt-get update
-          sudo apt-get install -y libgl1-mesa-dev xorg-dev gcc-mingw-w64
+          sudo apt-get install -y libgl1-mesa-dev xorg-dev
 
-      - name: Build Linux
-        run: go build -v -o dback-linux main.go
-
-      - name: Build Windows
-        run: |
-          CC=x86_64-w64-mingw32-gcc CGO_ENABLED=1 GOOS=windows GOARCH=amd64 go build -v -o dback-windows.exe main.go
+      # Build
+      - name: Build
+        run: go build -v -o ${{ matrix.output_name }} main.go
 
+      # Test (Skip on Windows if problematic with CGO, but usually fine)
       - name: Test
         run: go test -v ./...
 
-      - name: Release
+      # Upload Artifact
+      - name: Upload Artifact
+        uses: actions/upload-artifact@v3
+        with:
+          name: ${{ matrix.asset_name }}
+          path: ${{ matrix.output_name }}
+
+  release:
+    needs: build
+    if: startsWith(github.ref, 'refs/tags/')
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Download Linux Artifact
+        uses: actions/download-artifact@v3
+        with:
+          name: dback-linux
+
+      - name: Download macOS Artifact
+        uses: actions/download-artifact@v3
+        with:
+          name: dback-macos
+
+      - name: Download Windows Artifact
+        uses: actions/download-artifact@v3
+        with:
+          name: dback-windows.exe
+
+      - name: Create Release
         uses: softprops/action-gh-release@v1
-        if: startsWith(github.ref, 'refs/tags/')
         with:
           files: |
             dback-linux
+            dback-macos
             dback-windows.exe

README.md

@@ -39,12 +39,24 @@ This script handles dependency checks and runs the application.
 *Note: You may need to install `gcc`, `libgl1-mesa-dev`, and `xorg-dev` if prompted.*
 
 ### Build Binaries
-To generate standalone executables for Linux and Windows:
+To generate standalone executables for Linux, Windows, and macOS:
 
 ```bash
 ./build.sh
 ```
-*Artifacts will be created as `dback-linux` and `dback-windows.exe`.*
+*Artifacts will be created as `dback-linux`, `dback-windows.exe`, and `dback-macos`.*
+
+## Build Requirements
+
+To build the application from source, you need **Go 1.21+** and the following platform-specific dependencies:
+
+| Platform | Requirements |
+| :--- | :--- |
+| **Linux** | `gcc`, `libgl1-mesa-dev`, `xorg-dev` |
+| **Windows** | `gcc` (MinGW-w64 or TDM-GCC) |
+| **macOS** | Xcode Command Line Tools (`xcode-select --install`) |
+| **Cross-Compile (Linux -> Windows)** | `mingw-w64` (`gcc-mingw-w64`) |
+| **Cross-Compile (Linux -> macOS)** | `zig` or `osxcross` |
 
 ### Docker Alternative
 If you have issues with system dependencies, you can run the app in a container:

build.sh

@@ -24,3 +24,20 @@ else
     echo "To build for Windows on Linux, install 'mingw-w64':"
     echo "  sudo apt-get install mingw-w64"
 fi
+
+echo ""
+echo "Building for macOS..."
+# Check for cross-compiler (Zig is best for macOS CGO cross-compilation)
+if command -v zig &> /dev/null; then
+    echo "Using Zig for macOS cross-compilation..."
+    CC="zig cc -target x86_64-macos" CXX="zig c++ -target x86_64-macos" CGO_ENABLED=1 GOOS=darwin GOARCH=amd64 go build -o dback-macos main.go
+    if [ $? -eq 0 ]; then
+        echo "macOS build successful: ./dback-macos"
+    else
+        echo "macOS build failed."
+    fi
+else
+    echo "Cross-compiler for macOS not found (Zig recommended)."
+    echo "To build for macOS on Linux, install 'zig' or 'osxcross'."
+    echo "Example with Zig: snap install zig --classic"
+fi