Files
d2r-mobile/dm/android/VALIDATION.md

3.0 KiB
Raw Permalink Blame History

Android subresource-layout validation

Local validation date: 2026-10-15 (America/Los_Angeles).

This change retains android-port and its build94012 game integration. The per-mip approach is adapted from dodola/d2r-mobile at 642480b. No build91738 game addresses or platform/input services were imported.

Implemented scope

  • Track independent layouts for single-layer 2D color mip chains (2–16 levels) when sampled mips do not intersect any attachment mip in either graphics stage.
  • Retain the existing path for storage/comparison images, overlapping views, depth/stencil, arrays, volumes and devices using feedback-layout support.
  • Consolidate mixed layouts using the actual old layout of each mip run before whole-image operations; restore individual layouts after diagnostic captures.
  • Allow device A/B with DM_VK_SUBRES=0 / 1, without replacing the current pipeline cache, input, audio, save or APK packaging implementations.
  • Add a game-free system Vulkan capability probe, GPU readback fixture and a host/NDK/device test runner with explicit device opt-in and JSON receipts.

Completed checks

Check Result
Production layout tracker vs independent per-level oracle 320,000 deterministic random transitions; 407,319 emitted barriers checked
Same regression with AddressSanitizer + UndefinedBehaviorSanitizer Passed
Invalid ranges, no-op transitions, mixed-to-uniform transitions, >16-level whole-image fallback Passed in both host builds
NDK 28.2.13676358 / API 33 / arm64 device test binaries t_vk_perf and t_vk_caps built and linked
Production Vulkan App object, -fPIC -ffixed-x18 -O2 Built successfully
Diff whitespace and Python syntax Passed

Reproduction:

python3 dm/android/tests/run_checks.py --output dm/android/build/checks-new

Local receipts and compiler logs are under ignored dm/android/build/checks-mip-final/. The JSON explicitly records device_contacted: false, gpu_executed: false and game_tested: false.

Outstanding device and package checks

No Android device was attached. The new cross-stage binding-policy and real Vulkan mip pixel-readback fixtures were compiled, not executed. No Mali game compatibility, validation-layer cleanliness, improved FPS, display cadence, thermal behavior or power result is claimed.

The full App native-library build was attempted but stopped at the missing generated dm_hud_exp.h included by dm/host/diag.c. Generate the host headers from the player's own resources before validating the complete library/APK. The modified production Vulkan object builds independently of that header.

Use the explicit --run-device --serial DEVICE_SERIAL runner option for GPU checks, then perform the controlled game A/B described in the Android README. The capability probe reports the system driver; an app using a private Turnip driver requires separate testing with that driver.