Fix release builds for new GDExtension developers by fixing release identifiers in .gdextension

[MoralCode]

In working on my own GDExtension as a first-time godot developer, I have discovered (while debugging a performance related issue) that the example of a .gdextension In the tutorial (the C++ example) is incorrect.

When using scons to build my extension in release mode (scons target=template_release) my demo project would fail to open in godot without loading errors. it was only after I saw this comment and tried changing the release identifier to linux.x86_64 (from linux.release.x86_64) that godot successfully loaded with the release version of my extension.

godot 4.1

[AThousandShips]

If this is incorrect then the code in godot-cpp is also incorrect

[bruvzg]

This is not an intended way to do it, target tag probably should be template_release, template_debug and editor, but definitely not empty. If it's not working, it's a bug in the engine, not a documentation issue.

[AThousandShips]

It also seems to work for godot Jolt, and the standards, it uses the tag not the suffix, it should be debug and release respectively AFAIK, it searches for the feature tags, which for release builds is release, using no tag works, but could probably break with picking it for other ones as it doesn't check any tag

Edit: both release and template_release are valid, but it should be one of those

[AThousandShips]

Assuming this is verified by the gdextension team by the above, I think this can be closed, based on my analysis of the code

[dsnopek]

@AThousandShips Yes, you are correct!

I think what we have already in the docs represents how it should work. If the OP is having issues, it's either (a) something in their setup, or (b) a bug in Godot.

[MoralCode]

so if scons is building using the template_release configuration, should the values in .gdextension be linux.template_release.arm64 = "res://bin/libgdexample.linux.template_release.arm64.so"?

[dsnopek]

so if scons is building using the template_release configuration, should the values in .gdextension be linux.template_release.arm64 = "res://bin/libgdexample.linux.template_release.arm64.so"?

That should work, but so should:

linux.release.arm64 = "res://bin/libgdexample.linux.template_release.arm64.so"

The parts of the linux.release.arm64 are feature tags, so linux, release and arm64. All feature tags must be present in the Godot build for a particular GDExtension to be selected. And both release and template_release are valid feature tags that are present in target=template_release builds of Godot.

See here for more information about feature tags:

https://docs.godotengine.org/en/stable/tutorials/export/feature_tags.html