# The verification suite: lint + build + test on JDK 21 with a real headless GL context. # # This is a reusable workflow (`workflow_call`) rather than a job inside ci.yml, because two things # need to run EXACTLY this and must not be allowed to drift apart: every push/PR (ci.yml) and every # release (release.yml). A release that ran a subtly different suite than the branch gate is a # release whose green tick means less than it looks like it does. name: Verification on: workflow_call: # Least-privilege default: checkout is all this workflow needs. GitHub reports each # job's pass/fail as a PR status check natively, no extra `checks`/`statuses` scope required. permissions: contents: read jobs: build: runs-on: ubuntu-latest timeout-minutes: 45 steps: - uses: actions/checkout@v7 - name: Set up JDK 21 uses: actions/setup-java@v5 with: distribution: temurin java-version: "21" # Provides ANDROID_HOME + sdkmanager; needed for the :android app + android targets. # `packages` is overridden because the action's default list includes the legacy `tools` # package, which current cmdline-tools no longer resolve, and sdkmanager exits 1 on it. - name: Set up Android SDK uses: android-actions/setup-android@v4 with: packages: platform-tools - name: Install Android SDK packages run: sdkmanager "platforms;android-36" "build-tools;36.0.0" - name: Set up Gradle (with caching) uses: gradle/actions/setup-gradle@v6 # :render's GL tests drive a real GLFW / OpenGL 3.3 core context and assert on read-back pixels, # so without a display they cover exactly nothing. Xvfb + Mesa's llvmpipe give the runner a real # context. libgl1-mesa-dri is the load-bearing one — it carries swrast/llvmpipe, and Mesa cannot # do software GL without it. The GLFW X11 libs are listed explicitly rather than trusted to the # runner image, so an image change fails here instead of silently degrading the suite. - name: Install headless OpenGL (Xvfb + Mesa software GL) run: | sudo apt-get update sudo apt-get install -y --no-install-recommends \ xvfb libgl1 libgl1-mesa-dri libglx-mesa0 libegl1 \ libxrandr2 libxinerama1 libxcursor1 libxi6 libxext6 # umamo.requireGl turns the GL tests' missing-context skip into a hard failure (HeadlessGlGate), # so if this Xvfb setup ever stops yielding a context, CI says so instead of going green on a # suite that ran nothing. That is the whole point of the step above — without this flag a broken # Xvfb is indistinguishable from a pass. LIBGL_ALWAYS_SOFTWARE pins Mesa to llvmpipe, since the # runner has no GPU. # # NOTE: the golden corpus (test/corpus/, gitignored) is absent here, so every corpus-gated test # either skips or — for the ~76 print-and-return sites — reports PASSED while asserting nothing. # This suite therefore proves markedly less than the same command does locally. See # RELEASING.md § "What this gate does not prove". - name: Build, test, and lint env: LIBGL_ALWAYS_SOFTWARE: "1" run: > xvfb-run -a --server-args="-screen 0 1280x1024x24" ./gradlew build --stacktrace -Dumamo.requireGl=true