SDL window and surface tests
Section titled “SDL window and surface tests”Inno.Adapter.Platform.Sdl3.Tests verifies window composition and lifetime using the actual Win32 or Cocoa integration. It declares the player native product and a test-assembly main-thread host. Its evaluated validation context must match the host; do not infer cross-platform readiness from a default project property.
Behavior covered
Section titled “Behavior covered”| Source | Representative assertions |
|---|---|
HostIntegrationTests |
Missing hosts fail before SDK initialization; wrapping failure destroys only the newly owned window; a single-window capability rejects another creation before calling the host. |
Sdl3WindowOperationsTests |
Creation preserves options and leaves registration to the owner; invalid input fails before window creation. |
WindowOwnershipTests |
Directories contain only created/adopted windows; adopted wrappers invalidate before the original owner destroys them; cross-application release and cross-thread creation are rejected. |
WindowSurfaceTests |
Owned and borrowed wrappers resolve their surface through the same host boundary. |
NativeSurfaceLifetimeTests |
A real window exposes the correct nonzero Win32/Cocoa handle, then rejects surface borrowing after disposal. |
The final assertion was moved out of the managed Input suite together with its native dependency. It still executes against a real window.
Main-thread and process contract
Section titled “Main-thread and process contract”Cocoa operations run on the process main thread. NativeWindowTestHost directly invokes the declared original test methods and assertions in an isolated process; it does not use reflection, a dummy video driver or a production test entry. Individual failure, exception and timeout propagate as test failures. Windows can exercise this dispatch route with INNO_TEST_MAIN_THREAD_HOST=1.
The shared isolated executor supplies the selected target and product properties, retaining ProcessIsolation=Required where declared. Windows and macOS use their own native integration; neither borrows the other platform’s surface.
Prepare and run
Section titled “Prepare and run”Follow native validation. Missing SDK, window, library or valid deployment prevents certification. Preserve owner-thread execution and release order during diagnosis; deleting shared locks does not fix a lifetime error.
Read the SDL backend guide for product-facing constraints. Public test methods are discovery infrastructure rather than script exports.