ci: enhance GitHub workflow with LLVM configuration and macOS support

- Update workflow name to "Go tests" for clarity
- Configure specific LLVM version 20 with proper env variables for Linux
- Add proper LLVM configuration for macOS with dynamic library paths
- Improve generator step with better error handling and documentation
- Set minimum macOS deployment target to 13.0 to avoid version warnings
- Rearrange build and test steps for better workflow organization

Author: flexiondotorg

.github/workflows/go.yml

@@ -1,4 +1,4 @@
-name: Go
+name: Go tests
 
 on:
   push:
@@ -40,16 +40,43 @@ jobs:
         run: |
           if [ "${{ matrix.os }}" = "linux" ]; then
             sudo apt-get update
-            sudo apt-get install -y libclang-dev llvm-dev
+            sudo apt-get install -y libclang-20-dev llvm-20-dev
+            echo "CGO_LDFLAGS=-L/usr/lib/llvm-20/lib" >> $GITHUB_ENV
+            echo "CGO_CFLAGS=-I/usr/lib/llvm-20/include" >> $GITHUB_ENV
+            # Also try the generic path
+            echo "LD_LIBRARY_PATH=/usr/lib/llvm-20/lib:$LD_LIBRARY_PATH" >> $GITHUB_ENV
           elif [ "${{ matrix.os }}" = "darwin" ]; then
             brew install llvm
+            LLVM_PREFIX=$(brew --prefix llvm)
+            echo "CGO_LDFLAGS=-L${LLVM_PREFIX}/lib" >> $GITHUB_ENV
+            echo "CGO_CFLAGS=-I${LLVM_PREFIX}/include" >> $GITHUB_ENV
+            echo "PATH=${LLVM_PREFIX}/bin:$PATH" >> $GITHUB_ENV
+            # macOS needs explicit library path
+            echo "DYLD_LIBRARY_PATH=${LLVM_PREFIX}/lib:$DYLD_LIBRARY_PATH" >> $GITHUB_ENV
           fi
 
       - name: Download FFmpeg libraries
         run: go run ./cmd/download-lib/
 
-      - name: Run generator
-        run: go run ./internal/generator
+      - name: Build
+        run: go build -v .
+
+      # Note: macOS may show linker warnings about version mismatches if the static
+      # libraries were built on a newer macOS version than the runner.
+      # These warnings are harmless - the libraries have MACOSX_DEPLOYMENT_TARGET=13.0
+      - name: Test
+        run: go test -v .
+
+      # The generator creates Go bindings from FFmpeg headers using libclang.
+      # It's only needed during development when FFmpeg is updated.
+      # Failures here are acceptable in CI as the generated files are committed.
+      - name: Run generator (optional - for development only)
+        run: |
+          echo "::notice::Generator requires libclang. Failures are expected if libclang setup differs from development environment."
+          echo "Running generator with environment:"
+          echo "CGO_LDFLAGS=$CGO_LDFLAGS"
+          echo "CGO_CFLAGS=$CGO_CFLAGS"
+          go run ./internal/generator 2>&1 | grep -v "cgo-gcc-prolog\|deprecated" || true
         continue-on-error: true
 
       - name: Check for generated code differences
@@ -64,9 +91,3 @@ jobs:
             echo "::notice title=Generated Code Match on ${{ matrix.os }}/${{ matrix.arch }}::Generated bindings match committed version."
           fi
         continue-on-error: true
-
-      - name: Build
-        run: go build -v .
-
-      - name: Test
-        run: go test -v .

internal/builder/library.go

@@ -207,5 +207,20 @@ func buildEnv(installDir string) []string {
 		env = append(env, "PATH="+binPath)
 	}
 
+	// Set minimum macOS deployment target to avoid version mismatch warnings
+	// This ensures libraries work on macOS 13.0 and later (supports Intel and Apple Silicon)
+	if runtime.GOOS == "darwin" {
+		hasDeploymentTarget := false
+		for _, e := range env {
+			if strings.HasPrefix(e, "MACOSX_DEPLOYMENT_TARGET=") {
+				hasDeploymentTarget = true
+				break
+			}
+		}
+		if !hasDeploymentTarget {
+			env = append(env, "MACOSX_DEPLOYMENT_TARGET=13.0")
+		}
+	}
+
 	return env
 }