Files
eepp/.github/workflows/eepp-linux-build-check.yml
T
Martín Lucas Golini 4baa4ae4b1 Split accessibility backends, fix CI regressions and document architecture
CI fixes for the previous commit:
- Windows: announce one BoundsChanged on the window root when the scene
  resizes, so UIA raises LayoutInvalidated again. Widgets still do not
  report their own bounds changes.
- macOS: collapse identical pending notifications per element within one
  update, so one text selection change posts a single
  AXSelectedTextChanged. Created/Destroyed keep every occurrence, in order.
- MinGW: link the UIA test harness with -municode and uuid, which fixes
  the nightly MinGW build.

Backends:
- Split the AT-SPI backend into a private header plus connection, events,
  tree/marshalling and method files. Break the 600-line D-Bus dispatcher
  into one handler per interface.
- Split the UIA backend into a private header plus core, element provider
  and text range files.
- Share hasState/hasAction in accessibilitybackend.hpp instead of three
  per-backend copies.

CI and docs:
- Run test_atspi.py --multi-window on Linux: closing a secondary window
  while an AT-SPI client stays connected.
- Add docs/articles/uiaccessibilityarchitecture.md (layer map, files,
  invariants, per-backend layout, common tasks, test matrix) and link it
  from the articles index and the accessibility guide.
- Add a unit test for the single layout notification on scene resize.
2026-10-09 01:02:11 -03:00

155 lines
5.7 KiB
YAML

name: Linux
on: [push, pull_request]
permissions:
contents: write
jobs:
Linux:
runs-on: ubuntu-24.04
steps:
- name: Checkout repository
uses: actions/checkout@v6
with:
ref: ${{ github.ref }}
fetch-depth: 2
- name: Checkout submodules
run: |
git submodule update --init --recursive
- name: Install dependencies
run: |
sudo add-apt-repository -y universe
sudo add-apt-repository -y multiverse
sudo apt update
sudo apt install -y gcc-13 g++-13 wget mesa-utils xvfb gdb zstd \
python3-gi gir1.2-atspi-2.0 at-spi2-core dbus-x11
bash projects/linux/scripts/install_sdl2.sh --keep-build
wget https://cdn.ensoft.dev/eepp-assets/premake-5.0.0-beta6-linux.tar.gz
tar xvzf premake-5.0.0-beta6-linux.tar.gz
- name: Build
run: |
./premake5 --disable-static-build --with-debug-symbols gmake
cd make/linux
make all -j$(nproc) -e config=release_x86_64
- name: Package development environment
if: github.event_name == 'push'
run: |
{
echo "commit=${GITHUB_SHA}"
echo "compiler=g++-13"
echo "configuration=release_x86_64"
echo "platform=linux"
echo "arch=x86_64"
echo "sdl2=$(sdl2-config --version)"
} > .eepp-dev-environment
# Keep the small set of system graphics headers needed to compile
# renderer/backend translation units in a relocated development VM.
mkdir -p .eepp-dev/sysroot/include
for include_dir in GL EGL GLES GLES2 GLES3 KHR; do
if [ -d "/usr/include/$include_dir" ]; then
cp -a "/usr/include/$include_dir" .eepp-dev/sysroot/include/
fi
done
tar \
--exclude='.git' \
--exclude='projects/linux/sdk' \
--zstd \
-cf "$RUNNER_TEMP/eepp-dev-linux-x86_64.tar.zst" \
.
- name: Upload development environment
if: github.event_name == 'push'
uses: ./.github/actions/upload-split-artifact
with:
archive: ${{ runner.temp }}/eepp-dev-linux-x86_64.tar.zst
artifact_prefix: eepp-dev-linux-x86_64
chunk_size: 64M
retention_days: 5
max_parts: 64
- name: Set SDK version
id: sdk_version
run: |
if [[ "$GITHUB_REF" == refs/tags/eepp-* ]]; then
echo "version=${GITHUB_REF#refs/tags/}" >> "$GITHUB_OUTPUT"
else
echo "version=nightly" >> "$GITHUB_OUTPUT"
fi
- name: Package eepp SDK
if: github.event_name == 'push' || github.event_name == 'workflow_dispatch'
run: |
bash projects/scripts/package_sdk.sh linux x86_64 --strip --version ${{ steps.sdk_version.outputs.version }}
- name: Upload SDK package
if: always()
uses: actions/upload-artifact@v4
with:
name: linux-eepp-sdk-x86_64
path: projects/linux/sdk/eepp-sdk-*.tar.gz
- name: Unit Tests
run: |
cd projects/scripts
bash ./run_gdb_tests.sh
- name: Inactive Accessibility Benchmark
timeout-minutes: 2
run: |
mkdir -p bin/unit_tests/output
env -u AT_SPI_BUS_ADDRESS dbus-run-session -- projects/scripts/xvfb-run-eepp \
/usr/bin/python3 projects/scripts/benchmark_accessibility_inactive.py --json \
> bin/unit_tests/output/accessibility-inactive-benchmark.json
cat bin/unit_tests/output/accessibility-inactive-benchmark.json
- name: Native AT-SPI Regression Tests
timeout-minutes: 2
run: |
mkdir -p bin/unit_tests/output
env -u AT_SPI_BUS_ADDRESS dbus-run-session -- projects/scripts/xvfb-run-eepp \
/usr/bin/python3 projects/scripts/test_atspi.py --hidden --close-primary \
> bin/unit_tests/output/atspi-regressions.log
cat bin/unit_tests/output/atspi-regressions.log
- name: Native AT-SPI Secondary Window Tests
# Closes a secondary window while the client stays connected; the primary must keep answering.
timeout-minutes: 2
run: |
mkdir -p bin/unit_tests/output
env -u AT_SPI_BUS_ADDRESS dbus-run-session -- projects/scripts/xvfb-run-eepp \
/usr/bin/python3 projects/scripts/test_atspi.py --hidden --multi-window \
> bin/unit_tests/output/atspi-multi-window.log
cat bin/unit_tests/output/atspi-multi-window.log
- name: AT-SPI Benchmark
timeout-minutes: 5
run: |
mkdir -p bin/unit_tests/output
env -u AT_SPI_BUS_ADDRESS dbus-run-session -- projects/scripts/xvfb-run-eepp \
/usr/bin/python3 projects/scripts/benchmark_atspi.py --json \
> bin/unit_tests/output/atspi-benchmark.json
cat bin/unit_tests/output/atspi-benchmark.json
- name: Publish nightly SDK package
if: github.ref == 'refs/heads/develop'
uses: softprops/action-gh-release@v3
with:
tag_name: ${{ steps.sdk_version.outputs.version }}
draft: false
prerelease: true
generate_release_notes: false
fail_on_unmatched_files: true
files: |
projects/linux/sdk/eepp-sdk-linux-x86_64-nightly.tar.gz
- name: Publish stable release package
if: startsWith(github.ref, 'refs/tags/eepp-')
uses: softprops/action-gh-release@v3
with:
tag_name: ${{ steps.sdk_version.outputs.version }}
draft: false
prerelease: false
generate_release_notes: false
fail_on_unmatched_files: true
files: |
projects/linux/sdk/eepp-sdk-linux-x86_64-*.tar.gz
- name: Upload artifacts
if: always()
uses: actions/upload-artifact@v4
with:
name: linux-test-output
path: bin/unit_tests/output/*