From def76ceb74143d76d81061f01ab154eb3f9955dd Mon Sep 17 00:00:00 2001 From: Lars Vogel Date: Tue, 28 Jul 2026 20:14:02 +0200 Subject: [PATCH] Document how to check which bundles a test run actually uses Building the changed bundle alongside its test bundle covers that one bundle, but every other bundle still comes from the target platform as a released artifact, so a change reached only indirectly is not under test. Mention -am for building the upstream closure from source, and describe how to tell from config.ini whether the harness installed the local build or the released bundle. --- AGENTS.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index f032094fc5..3c714da51b 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -44,6 +44,17 @@ mvn verify -pl :org.eclipse.pde.ui.tests -Pbuild-individual-bundles -Dtest=Depen mvn verify -pl :org.eclipse.pde.core,:org.eclipse.pde.ui.tests -Pbuild-individual-bundles ``` +Every bundle not listed in `-pl` is taken from the target platform as a released bundle, so a changed bundle that the test bundle only reaches indirectly is not covered. +`-am` (`--also-make`) builds the whole upstream closure of the test bundle from source instead: +```bash +mvn verify -pl :org.eclipse.pde.ui.tests -am -Pbuild-individual-bundles -Dtest=DependencyLoopFinderTest +``` + +**Confirm the test runtime really uses your build.** +A test that passes or fails against a released bundle says nothing about the change. +After a run, `ui/org.eclipse.pde.ui.tests/target/work/configuration/config.ini` lists the bundles the harness installed: an entry under the local `target/` directory is your build, one under `~/.m2/repository/p2/` is the released bundle. +Only the test bundle itself is additionally mapped to its class folders, through `target/work/dev.properties`. + **Headless (Wayland-safe):** pin the GTK backend to X11 so the UI test harness renders on Xvfb instead of the real compositor: ```bash GDK_BACKEND=x11 xvfb-run -a mvn verify -pl :org.eclipse.pde.ui.tests -Pbuild-individual-bundles -Dtest=DependencyLoopFinderTest