c-cpp.yml

name: C/C++ CI

on:
  push:
    branches: [ master ]
  pull_request:
    branches: [ master ]
  workflow_dispatch:

jobs:
  build:
    strategy:
      fail-fast: false
      matrix:
        config:
          # Linux
          - displayTargetName: 'Linux x86_64 (GCC)'
            artifact: 'virtualjaguar_libretro.so'
            os: ubuntu-latest
            cc: 'gcc'
            cxx: 'g++'

          - displayTargetName: 'Linux x86_64 (Clang)'
            artifact: 'virtualjaguar_libretro.so'
            os: ubuntu-latest
            cc: 'clang'
            cxx: 'clang++'

          - displayTargetName: 'Linux aarch64'
            artifact: 'virtualjaguar_libretro.so'
            os: ubuntu-24.04-arm
            cc: 'gcc'
            cxx: 'g++'

          - displayTargetName: 'Linux i686'
            artifact: 'virtualjaguar_libretro.so'
            os: ubuntu-latest
            cc: 'gcc -m32'
            cxx: 'g++ -m32'
            multilib: true

          # macOS
          - displayTargetName: 'macOS arm64 (Clang)'
            artifact: 'virtualjaguar_libretro.dylib'
            os: macos-latest
            cc: 'clang'
            cxx: 'clang++'

          - displayTargetName: 'macOS x86_64 (Clang)'
            artifact: 'virtualjaguar_libretro.dylib'
            os: macos-13
            cc: 'clang'
            cxx: 'clang++'

          # Windows (MinGW)
          - displayTargetName: 'Windows x86_64 (MSYS2)'
            artifact: 'virtualjaguar_libretro.dll'
            os: windows-latest
            cc: 'gcc'
            cxx: 'g++'
            shell: 'msys2 {0}'
            msystem: 'MINGW64'
            msys2_packages: 'mingw-w64-x86_64-gcc make'

          - displayTargetName: 'Windows i686 (MSYS2)'
            artifact: 'virtualjaguar_libretro.dll'
            os: windows-latest
            cc: 'gcc'
            cxx: 'g++'
            shell: 'msys2 {0}'
            msystem: 'MINGW32'
            msys2_packages: 'mingw-w64-i686-gcc make'

          # Emscripten (WebAssembly)
          - displayTargetName: 'Emscripten (WASM)'
            artifact: 'virtualjaguar_libretro_emscripten.bc'
            os: ubuntu-latest
            emscripten: true

          # Android NDK
          - displayTargetName: 'Android arm64-v8a'
            artifact: 'libs/arm64-v8a/libretro.so'
            os: ubuntu-latest
            android: true
            android_abi: 'arm64-v8a'

          - displayTargetName: 'Android armeabi-v7a'
            artifact: 'libs/armeabi-v7a/libretro.so'
            os: ubuntu-latest
            android: true
            android_abi: 'armeabi-v7a'

          - displayTargetName: 'Android x86_64'
            artifact: 'libs/x86_64/libretro.so'
            os: ubuntu-latest
            android: true
            android_abi: 'x86_64'

          - displayTargetName: 'Android x86'
            artifact: 'libs/x86/libretro.so'
            os: ubuntu-latest
            android: true
            android_abi: 'x86'

          # iOS / tvOS
          - displayTargetName: 'iOS arm64'
            artifact: 'virtualjaguar_libretro_ios.dylib'
            os: macos-latest
            make_platform: 'ios-arm64'
            cross: true

          - displayTargetName: 'tvOS arm64'
            artifact: 'virtualjaguar_libretro_tvos.dylib'
            os: macos-latest
            make_platform: 'tvos-arm64'
            cross: true

    name: build-${{ matrix.config.displayTargetName }}
    runs-on: ${{ matrix.config.os }}

    defaults:
      run:
        shell: ${{ matrix.config.shell || 'bash' }}

    steps:
    - uses: actions/checkout@v4

    - name: Install multilib
      if: matrix.config.multilib
      run: |
        sudo dpkg --add-architecture i386
        sudo apt-get update
        sudo apt-get install -y gcc-multilib g++-multilib

    - name: Set up MSYS2
      if: runner.os == 'Windows'
      uses: msys2/setup-msys2@v2
      with:
        msystem: ${{ matrix.config.msystem || 'MINGW64' }}
        update: false
        install: ${{ matrix.config.msys2_packages || 'mingw-w64-x86_64-gcc make' }}

    - name: Set up Emscripten
      if: matrix.config.emscripten
      uses: mymindstorm/setup-emsdk@v14

    - name: Set up Android NDK
      if: matrix.config.android
      uses: nttld/setup-ndk@v1
      id: setup-ndk
      with:
        ndk-version: r26d

    - name: Build
      if: ${{ !matrix.config.emscripten && !matrix.config.android && !matrix.config.make_platform }}
      run: make -j4 CC="${{ matrix.config.cc }}" CXX="${{ matrix.config.cxx }}"

    - name: Build (platform)
      if: matrix.config.make_platform
      run: make -j4 platform=${{ matrix.config.make_platform }}

    - name: Build (Emscripten)
      if: matrix.config.emscripten
      run: emmake make -j4 platform=emscripten

    - name: Build (Android NDK)
      if: matrix.config.android
      run: |
        ${{ steps.setup-ndk.outputs.ndk-path }}/ndk-build \
          APP_ABI=${{ matrix.config.android_abi }} -j4

    # Host/native toolchains only — skips cross-compile rows (e.g. aarch64 on x86 runner).
    - name: Run cheat engine unit tests
      if: ${{ !matrix.config.emscripten && !matrix.config.android && !matrix.config.cross && runner.os != 'Windows' }}
      run: make test CC="${{ matrix.config.cc }}"

    - name: Run SIMD blitter tests
      if: ${{ !matrix.config.emscripten && !matrix.config.android && !matrix.config.cross }}
      run: |
        ARCH=$(uname -m)
        CC="${{ matrix.config.cc }}"
        case "$ARCH" in
          x86_64|i686|i386)  SIMD_SRC=src/tom/blitter_simd_sse2.c; EXTRA="-msse2" ;;
          aarch64|arm64)     SIMD_SRC=src/tom/blitter_simd_neon.c;  EXTRA="" ;;
          *)                 SIMD_SRC=src/tom/blitter_simd_scalar.c; EXTRA="" ;;
        esac

        echo "==> Testing ${SIMD_SRC}..."
        $CC -O2 -Wall ${EXTRA} -I src -I src/core -I src/tom \
          -o test_blitter_simd test/test_blitter_simd.c ${SIMD_SRC}
        ./test_blitter_simd

        echo "==> Cross-checking against scalar..."
        $CC -O2 -Wall -I src -I src/core -I src/tom \
          -o test_blitter_scalar test/test_blitter_simd.c src/tom/blitter_simd_scalar.c
        ./test_blitter_scalar

        echo "==> DSP 40-bit MAC accumulator regression (dsp_acc40.h)..."
        $CC -O2 -Wall -I src -I src/jerry -o test_dsp_mac40 test/test_dsp_mac40.c
        ./test_dsp_mac40

    - name: Run memory map test
      if: ${{ !matrix.config.emscripten && !matrix.config.android && !matrix.config.cross && runner.os != 'Windows' }}
      run: |
        CC="${{ matrix.config.cc }}"
        if [ "$(uname)" = "Linux" ]; then
          LDFLAGS="-ldl"
        else
          LDFLAGS=""
        fi
        $CC -O2 -Wall -o test/tools/test_memory_map test/tools/test_memory_map.c $LDFLAGS
        ./test/tools/test_memory_map ./${{ matrix.config.artifact }}

    - name: Run DSP instruction set tests
      if: ${{ !matrix.config.emscripten && !matrix.config.android && !matrix.config.cross && runner.os != 'Windows' }}
      run: |
        CC="${{ matrix.config.cc }}"
        if [ "$(uname)" = "Linux" ]; then LDFLAGS="-ldl"; else LDFLAGS=""; fi
        $CC -O2 -Wall -o test/test_dsp_ops test/test_dsp_ops.c $LDFLAGS
        $CC -O2 -Wall -o test/test_dsp_unit test/test_dsp_unit.c $LDFLAGS
        ./test/test_dsp_ops
        ./test/test_dsp_unit

    - name: Run GPU instruction set tests
      if: ${{ !matrix.config.emscripten && !matrix.config.android && !matrix.config.cross && runner.os != 'Windows' }}
      run: |
        CC="${{ matrix.config.cc }}"
        if [ "$(uname)" = "Linux" ]; then LDFLAGS="-ldl"; else LDFLAGS=""; fi
        $CC -O2 -Wall -o test/test_gpu_ops test/test_gpu_ops.c $LDFLAGS
        ./test/test_gpu_ops

        $CC -O2 -Wall -o test/test_op_gpu_object test/test_op_gpu_object.c $LDFLAGS
        ./test/test_op_gpu_object ./${{ matrix.config.artifact }}

    - name: Run 68K instruction set tests
      if: ${{ !matrix.config.emscripten && !matrix.config.android && !matrix.config.cross && runner.os != 'Windows' }}
      run: |
        CC="${{ matrix.config.cc }}"
        if [ "$(uname)" = "Linux" ]; then LDFLAGS="-ldl"; else LDFLAGS=""; fi
        $CC -O2 -Wall -o test/test_m68k_ops test/test_m68k_ops.c $LDFLAGS
        ./test/test_m68k_ops

    - name: Cache pinned rcheevos E2E build
      if: ${{ !matrix.config.emscripten && !matrix.config.android && !matrix.config.cross && runner.os != 'Windows' }}
      uses: actions/cache@v4
      with:
        path: build/rcheevos-static
        key: rcheevos-e2e-fd57e900-${{ runner.os }}-${{ matrix.config.cc }}-${{ matrix.config.displayTargetName }}

    - name: RetroAchievements rc_libretro E2E test
      if: ${{ !matrix.config.emscripten && !matrix.config.android && !matrix.config.cross && runner.os != 'Windows' }}
      env:
        # Immutable pin (rcheevos v12.3.0); tarball via .../archive/${SHA}.tar.gz
        RCHEEVOS_REF: fd57e900758a9e3de343e7b0316b8a6059dce228
        CC: ${{ matrix.config.cc }}
      run: bash test/tools/test_rcheevos_e2e.sh ./${{ matrix.config.artifact }}

    - name: Upload artifact
      uses: actions/upload-artifact@v4
      with:
        name: ${{ matrix.config.displayTargetName }}
        path: ${{ matrix.config.artifact }}
        if-no-files-found: error

  msvc-check:
    name: MSVC ${{ matrix.arch }} compilation check
    runs-on: windows-latest
    strategy:
      fail-fast: false
      matrix:
        arch: [x64, x86]
    steps:
    - uses: actions/checkout@v4

    - uses: ilammy/msvc-dev-cmd@v1
      with:
        arch: ${{ matrix.arch }}

    - name: Compile all sources with cl.exe
      shell: cmd
      run: |
        cl.exe /c /W3 /O2 /DNDEBUG /D_CRT_SECURE_NO_DEPRECATE ^
          /I. /Isrc /Isrc\core /Isrc\tom /Isrc\jerry /Isrc\cd /Isrc\bios /Isrc\m68000 /Ilibretro-common\include ^
          /D__LIBRETRO__ /DINLINE="_inline" ^
          libretro.c ^
          src\tom\blitter.c src\tom\blitter_compare.c src\tom\blitter_mmio.c src\jerry\dac.c src\jerry\dsp.c src\core\file.c ^
          src\tom\gpu.c src\core\jaguar.c src\jerry\jerry.c src\tom\tom.c src\tom\op.c ^
          src\cd\cdintf.c src\cd\cdrom.c src\core\crc32.c src\core\event.c ^
          src\jerry\eeprom.c src\core\filedb.c src\jerry\joystick.c src\core\settings.c ^
          src\core\memtrack.c src\core\vjag_memory.c src\core\cheat.c ^
          src\core\universalhdr.c src\jerry\wavetable.c ^
          src\bios\jagbios.c ^
          src\bios\jagcdbios.c src\bios\jagdevcdbios.c ^
          src\bios\jagstub1bios.c src\bios\jagstub2bios.c ^
          src\m68000\m68kinterface.c ^
          src\tom\blitter_simd_scalar.c ^
          src\tom\blitter_simd_sse2.c
        echo MSVC compilation check passed

  vita-build:
    name: build-PS Vita
    runs-on: ubuntu-latest
    container:
      image: vitasdk/vitasdk:latest
    steps:
    - uses: actions/checkout@v4

    - name: Build
      run: make -j4 platform=vita

    - name: Upload artifact
      uses: actions/upload-artifact@v4
      with:
        name: PS Vita
        path: virtualjaguar_libretro_vita.a
        if-no-files-found: error

  switch-build:
    name: build-Nintendo Switch
    runs-on: ubuntu-latest
    container:
      image: devkitpro/devkita64:latest
    steps:
    - uses: actions/checkout@v4

    - name: Build
      run: make -j4 platform=libnx
      env:
        DEVKITPRO: /opt/devkitpro

    - name: Upload artifact
      uses: actions/upload-artifact@v4
      with:
        name: Nintendo Switch
        path: virtualjaguar_libretro_libnx.a
        if-no-files-found: error

  c89-lint:
    name: C89 compliance check
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v4

    - name: Check for declaration-after-statement
      run: |
        echo "==> Checking C89 compliance (catches MSVC C89 errors)..."
        scripts/c89-lint.sh

    - name: Check for stdbool.h usage (use boolean.h instead)
      run: |
        echo "==> Checking for direct stdbool.h includes..."
        FAILED=0
        for f in libretro.c $(git ls-files 'src/**/*.c' 'src/**/*.h'); do
          case "$f" in
            src/core/boolean.h) continue ;;
          esac
          if grep -n '#include.*<stdbool\.h>' "$f" 2>/dev/null; then
            echo "::error file=$f::Use <boolean.h> instead of <stdbool.h> (MSVC 2005/2010 compat)"
            FAILED=1
          fi
        done
        if [ "$FAILED" = "1" ]; then
          exit 1
        fi
        echo "==> No direct stdbool.h includes found"