gdext-based custom resource format tools needs experimental-threads feature #597
Description
To handle custom Resource formats, one needs to define ResourceFormatSaver and ResourceFormatLoader, and register them with ResourceSaver::add_resource_format_saver() and ResourceLoader::add_resource_format_loader() for the formats to be recognizable by Godot.
Unbeknownst to the user, registered GodotClasses can be used by Godot outside of the main thread, and it happens only when opening the project in the Godot Editor (or just on InitLevel::Editor - as the same happens also during export). Currently, I can confirm only usage of ResourceFormatLoader methods, but I can't say for sure that any other calls won't be made.
Methods in question:
ResourceFormatLoader::get_resource_uid()ResourceFormatLoader::get_recognized_extensions()ResourceFormatLoader::get_resource_type()
After thread-hardening with additional checks in #581, in practice, it means that any gdext-based project that provides ResourceFormatLoader will panic without the experimental-threads feature enabled.
Will try to provide a minimal example at a further date, currently I paste below the output produced by the locally-modified gd-props integration testing project.
- While running the empty scene without entering Godot Editor in any way:
$ godot --headless --path tests/godot
Initialize godot-rust (API v4.2.stable.official, runtime v4.2.stable.official)
Godot Engine v4.2.stable.official.46dc27791 - https://godotengine.org
Thread: 1 ResourceFormatLoader::get_recognized_extensions()
Thread: 1 ResourceFormatLoader::handles_type()
- While running headless editor with
--quitoption (and during project export outputs seems to be analogous -EditorExportPluginitself is running only on the main thread)
$ godot --headless --path tests/godot -e --quit
Initialize godot-rust (API v4.2.stable.official, runtime v4.2.stable.official)
Godot Engine v4.2.stable.official.46dc27791 - https://godotengine.org
Thread: 1 ResourceFormatLoader::get_recognized_extensions()
Thread: 1 ResourceFormatLoader::handles_type()
WARNING: Custom cursor shape not supported by this display server.
at: cursor_set_custom_image (servers/display_server.cpp:505)
Thread: 1 ResourceFormatSaver::get_recognized_extensions()
Thread: 1 ResourceFormatLoader::handles_type()
Thread: 1 ResourceFormatLoader::handles_type()
Thread: 1 ResourceFormatLoader::handles_type()
Thread: 1 ResourceFormatLoader::handles_type()
Thread: 1 ResourceFormatLoader::handles_type()
Thread: 1 ResourceFormatLoader::handles_type()
Thread: 1 ResourceFormatLoader::handles_type()
Thread: 1 ResourceFormatLoader::handles_type()
Thread: 1 ResourceFormatLoader::handles_type()
Thread: 1 ResourceFormatLoader::handles_type()
Thread: 1 ResourceFormatLoader::get_recognized_extensions()
Thread: 14 ResourceFormatLoader::get_resource_uid()
Thread: 14 ResourceFormatLoader::get_recognized_extensions()
Thread: 14 ResourceFormatLoader::get_recognized_extensions()
Thread: 1 ResourceFormatLoader::handles_type()
Thread: 1 ResourceFormatLoader::handles_type()
- While opening project in editor with GUI, without insta-quit
$ godot --path tests/godot -e
Initialize godot-rust (API v4.2.stable.official, runtime v4.2.stable.official)
Godot Engine v4.2.stable.official.46dc27791 - https://godotengine.org
/lib/x86_64-linux-gnu/libxkbcommon.so.0: undefined symbol: xkb_utf32_to_keysym
/lib/x86_64-linux-gnu/libxkbcommon.so.0: undefined symbol: xkb_keymap_key_get_mods_for_level
OpenGL API 4.6 (Core Profile) Mesa 21.2.6 - Compatibility - Using Device: Intel - Mesa Intel(R) HD Graphics 520 (SKL GT2)
Thread: 1 ResourceFormatLoader::get_recognized_extensions()
Thread: 1 ResourceFormatLoader::handles_type()
Thread: 1 ResourceFormatSaver::get_recognized_extensions()
Thread: 1 ResourceFormatLoader::handles_type()
Thread: 1 ResourceFormatLoader::handles_type()
Thread: 1 ResourceFormatLoader::handles_type()
Thread: 1 ResourceFormatLoader::handles_type()
Thread: 1 ResourceFormatLoader::handles_type()
Thread: 1 ResourceFormatLoader::handles_type()
Thread: 1 ResourceFormatLoader::handles_type()
Thread: 1 ResourceFormatLoader::handles_type()
Thread: 1 ResourceFormatLoader::handles_type()
Thread: 1 ResourceFormatLoader::handles_type()
Thread: 1 ResourceFormatLoader::get_recognized_extensions()
Thread: 16 ResourceFormatLoader::get_resource_uid()
Thread: 16 ResourceFormatLoader::get_recognized_extensions()
Thread: 16 ResourceFormatLoader::get_recognized_extensions()
Thread: 1 ResourceFormatLoader::handles_type()
Thread: 1 ResourceFormatLoader::handles_type()
Thread: 17 ResourceFormatLoader::get_resource_type()
Thread: 17 ResourceFormatLoader::get_resource_type()
Thread: 17 ResourceFormatLoader::get_resource_type()
Thread: 17 ResourceFormatLoader::get_resource_type()
Thread: 17 ResourceFormatLoader::get_resource_type()
Thread: 17 ResourceFormatLoader::get_resource_type()
Thread: 17 ResourceFormatLoader::get_resource_type()
Thread: 17 ResourceFormatLoader::get_resource_type()
Thread: 17 ResourceFormatLoader::get_resource_type()
Thread: 17 ResourceFormatLoader::get_resource_type()
Thread: 17 ResourceFormatLoader::get_resource_type()
Thread: 17 ResourceFormatLoader::get_resource_type()
Browsing the project in the editor while some testing, all the methods seem to be called from the main thread.