Troubleshooting

Troubleshooting

Do not uninstall or clear app data: that deletes saves/settings. Never attach game assets, XBE, generated game sources or compiled game libraries to a report.

Setup and updates

Problem	Check / action
APK will not install	Android 10+, ARM64/x86_64. For a signing mismatch, obtain an APK with the same certificate; do not uninstall to bypass it. Runtime requires Vulkan 1.1.
Unsupported game	Verify the original-Xbox build and hashes. PC/Xbox 360 files do not work.
Builder-version error	Windows builder is retired. Import the ISO, archive or game folder for on-device compilation.
Import/compile stopped	Keep setup open; check free-space requirements. Use Compile / resume; interrupted extraction may need input selection again. Export logs after the failure.
“Game folder already exists”	Import intentionally refuses overwrite. Ordinary updates need no reimport. Back up saves/settings and ask before replacing an installation.
No local compilation on x86_64	Update from 0.2.0-testing.2 or earlier to a current release.
Log export failed	Delete the incomplete destination ZIP and retry in a writable location. Do not clear app data.

Graphics and drivers

• Slow rendering: start at 50% render resolution. Compare the same gameplay scene, not menu FPS. Graphics settings.
• Turnip missing: expected on Mali, x86_64, unsupported chips or failed detection. Do not install random driver ZIPs.
• Failure after enabling Turnip: force-stop → launcher → Manufacturer → force-stop/reopen → Play. Switching a menu choice cannot replace a running driver.
• Unsure which driver loaded: check exported Vulkan diagnostics/startup logs; verified Turnip driver confirms activation.
• Flicker or corrupted effects on Mali: set GPU SYNC to Strict (details) and report the device.
• Mali graphics problems: the workaround covers only one Mali-G51 driver, not all Mali devices.

Controls and launcher

• No phone gyro: requires gyroscope + accelerometer; enable PHONE under CONTROLLER → GYRO. Motion applies only during weapon aim/sniping.
• Calibration: keep the phone still about two seconds; expect DONE or RETRY within ten seconds. X/Y inversion is separate from stick inversion.
• Touch controls missing: AUTOMATIC hides them when a controller is connected. Controls.
• Long menus/licenses: scroll; Back returns to the previous page. For overlap/inaccessible controls, report screen size, Android font size and a screenshot.
• App icon returns to game: expected while the game process is active. Fully stop/reopen to reach the launcher.

Reading exported logs

• ZIP export contains saved runs, not full Android logcat. Older logs can describe previous builds/settings.
• A log ending mid-line does not prove a crash; buffered output may be missing.
• Observed doubled paths such as T:\D:\Default\... followed by a successful SplinterCellLogo.tga open are failed fallback searches, not proof of a broken loading screen.
• RECORD_AUDIO errors in the supplied logs describe failed voice/microphone initialization, not ZIP-export failure.

Report a bug

1. Use Share device report for app/device/Android/GPU details.
2. Use Export error logs (ZIP), save and review for personal paths before sharing. Export contents and limits.
3. Open an issue with:
   • Exact app version; steps, level/location, expected vs. actual result.
   • Input type, render resolution and relevant settings.
   • Driver selection, whether fully restarted, and actual recorded driver.
   • Error text/screenshot and the reviewed ZIP.

Reports are public when posted to GitHub. Never include your game ZIP, default.xbe, saves or libscda_code.so.