godotengine/godot-docs
1
0
Fork 0
mirror of https://github.com/godotengine/godot-docs.git synced 2025-12-31 17:49:03 +03:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #10488 from Calinou/feature-tags-get-setting-with-override

Browse Source 
Document reading project settings with overrides taken into account in Feature tags
This commit is contained in:
Matthew
2025-04-11 10:19:53 -04:00
committed by GitHub
parent 19cabbcb00 6eae590bee
commit 092529f891
1 changed files with 22 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
tutorials/export/feature_tags.rst
View File

@@ -188,6 +188,28 @@ in many sections of the project settings.
.. image:: img/feature_tags4.webp
Taking feature tags into account when reading project settings
--------------------------------------------------------------
By default, feature tags are **not** taken into account when reading project settings
using the typical approaches (:ref:`ProjectSettings.get_setting<class_ProjectSettings_method_get_setting>`
or :ref:`ProjectSettings.get <class_Object_private_method__get>`).
Instead, you must use :ref:`ProjectSettings.get_setting_with_override <class_ProjectSettings_method_get_setting>`.
For example, with the following project settings:
::
[section]
subsection/example = "Release"
subsection/example.debug = "Debug"
Using ``ProjectSettings.get_setting("section/subsection/example")`` will return
``"Release"`` regardless of whether a debug build is currently running. On the
other hand, ``ProjectSettings.get_setting_with_override("section/subsection/example")``
will obey feature tags and will return ``"Debug"`` if using a debug build.
Customizing the build
---------------------