| name | glue-manual-repro |
| description | Manually launching a built GlueFormsCore.exe to repro/verify an editor UI bug (layout, startup state, first-launch behavior). Triggers: GlueFormsCore.exe, %AppData%\GlueFormsCore, settings.xml, GlueLayoutSettings.xml, simulating first launch. |
For investigating a UI/layout bug that a unit test can't pin alone (timing, first-launch state, window
rendering) — driving the real GlueFormsCore.exe yourself is fine; the process doc's "don't drive the
tool yourself" rule is about the final user-facing manual-test step, not internal repro.
Landmines
- Build
Glue with All.sln, not Glue.csproj alone. A Glue.csproj-only build boots with no
plugins loaded (Explorer tree, property grid, etc. all silently missing) — the window looks badly
broken in a way that has nothing to do with the bug you're chasing. Costs a full rebuild cycle to
notice.
settings.xml's LastProjectFile must be the .csproj, not the .gluj. Glue opens it via
Microsoft.Build.Evaluation.Project; a .gluj path throws a real "Could not load the project" popup.- User profile lives at
%AppData%\GlueFormsCore\settings.xml and GlueLayoutSettings.xml. Back
both up before simulating a fresh/first-launch profile (delete or rewrite them), restore after —
these are the developer's real Glue preferences, not scratch files.
- A backgrounded/unfocused window doesn't repaint.
Program.cs forces
RenderOptions.ProcessRenderMode = SoftwareOnly; a screenshot of an occluded or non-foreground window
shows stale/blank content. Bring it to the foreground and maximize (ShowWindow/SetForegroundWindow
via P/Invoke in PowerShell) immediately before capturing.
- A project auto-load on startup can take minutes, not seconds (MSBuild restore, codegen) — a window
title still reading generic "FlatRedBall Editor" (no project path) means it hasn't finished; don't
read the UI state as final until the title shows the loaded
.csproj path.
exitwhenquiet may never fire. The automation hook
(MainGlueWindow.StartExitWhenQuietWatcherIfRequested) exits only once
TaskManager.Self.AreAllAsyncTasksDone has held for N seconds, and on some projects that never
happens — Glue loads fine and then just stays open (issue #2053). Don't build a headless
verify loop on a clean exit; launch, wait for the title to show the .csproj, kill, and assert on
files written.
Reusable pattern
Self-serve-log via a temporary File.AppendAllText probe in the suspect code path (see the
self-serve-logging skill), launch the exe from Bash/PowerShell, drive it headlessly where possible
(writing settings.xml directly beats simulating clicks), then read the log — don't ask the user to
transcribe anything.
