Troubleshooting
Common build and runtime issues.
Troubleshooting
Use the first substantive error in the build log rather than only its final summary.
Editor Shows an Old Version
Close every running editor process. Check the exact path of the executable and build the current source again. Inspect embedded QML and version constants if the UI still appears stale.
Android CMake: Invalid Character Escape
An error like Invalid character escape '\U' usually indicates an unnormalized Windows path in generated CMake code. Use an exporter revision that converts Android package paths to forward slashes before configuring.
Android: Qt6TaskTree Warning
A warning about a missing optional private dependency is not necessarily the fatal error. Read the following CMake Error section to identify the actual failure.
Web: Emscripten Not Active
Verify the emsdk_env.bat location, the installed Emscripten version, and whether the editor has inherited that environment. Launch the editor through an activated Command Prompt if automatic detection does not work.
Web Page Still Shows an Old Name
Confirm Product Name in Build Settings, verify regenerated index.html title/metadata, and clear browser cache. Product Name should be different from the internal project name when needed.
Game Runs but Scene Looks Wrong
Check the startup scene, main camera, rendering assets, shader compatibility, and runtime logs on the target platform.