gpu_testing.md

Running GPU integration tests on Fuchsia

[TOC]

General instruction on running and debugging GPU integration tests can be found here.

Fuchsia uses either web_engine_shell or the Chrome browser to run GPU integration tests. For the sake of this example, we will be using web_engine_shell as the target browser and gpu_process as the test suite we wish to execute. Build the target telemetry_gpu_integration_test_fuchsia and run the appropriate commands:

Hermetic emulation

The test script brings up an emulator, runs the tests on it, and shuts the emulator down when finished.

$ content/test/gpu/run_gpu_integration_test_fuchsia.py gpu_process
--browser=web-engine-shell --out-dir=/path/to/outdir

Run on an physical device

$ content/test/gpu/run_gpu_integration_test_fuchsia.py gpu_process
--browser=web-engine-shell --out-dir=/path/to/outdir -d

Run on a device that needs packages built from Fuchsia source

$ content/test/gpu/run_gpu_integration_test_fuchsia.py gpu_process
--browser=web-engine-shell --out-dir=/path/to/outdir -d
--repo=/path/to/fuchsia/outdir --no-repo-init

Note that fx serve should not be running, since the script handles launching the package server from the Fuchsia output directory.

Run on a device the host is connected to remotely via ssh

$ content/test/gpu/run_gpu_integration_test_fuchsia.py gpu_process
--browser=web-engine-shell --out-dir=/path/to/outdir -d --target-id=[::1]:8022

Note the this requires a remote tunnel to have been set up first.