godotengine/godot-docs
1
0
Fork 0
mirror of https://github.com/godotengine/godot-docs.git synced 2026-01-05 22:09:56 +03:00
Code Issues Packages Projects Releases Wiki Activity

Added breaking change note for @export_file behavior in 4.4

Browse Source
This commit is contained in:
Ayush Raj
2025-07-02 18:36:53 +00:00
parent 0c9ce77560
commit bf9f61819e
1 changed files with 17 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
tutorials/migrating/upgrading_to_godot_4.4.rst
View File

@@ -52,8 +52,24 @@ Method ``create_from_string`` adds a new ``show_error`` optional parameter
**Semaphore**
Method ``post`` adds a new ``count`` optional parameter |✔️| |✔️ with compat| |✔️ with compat| `GH-93605`_
**TranslationServer**
Method ``standardize_locale`` adds a new ``add_defaults`` optional parameter |✔️| |✔️ with compat| |✔️ with compat| `GH-98972`_
Method ``standardize_locale`` adds a new ``add_defaults`` optional parameter
|✔️| |✔️ with compat| |✔️ with compat| `GH-98972`_
======================================================================================================================== =================== ==================== ==================== ============
**Export annotations**
.. warning::
The behavior of ``@export_file`` changed in Godot 4.4. When assigning a new value from the Inspector, the path is now stored and returned as a ``uid://`` reference instead of the traditional ``res://`` path. This is a **breaking change** and may cause issues if you're expecting ``res://``-based paths in scripts or serialized files.
For example, exported arrays of files may now contain a mix of ``uid://`` and ``res://`` paths, especially if they were edited partially in the Inspector.
In 4.4, the only way to retain the ``res://`` format is to **manually edit** the `.tscn` or `.tres` files in a text editor. Starting in Godot 4.5, a new annotation ``@export_file_path`` can be used to explicitly retain the old behavior and export raw ``res://`` paths.
Related issues:
- PR: `Add @export_file_path to export raw paths (no UID) <https://github.com/godotengine/godot/pull/105414>`_
- Issue: `@export_file behavior change is breaking <https://github.com/godotengine/godot/issues/11065>`_
- See also: `ProjectSettings stores UIDs for file paths <https://github.com/godotengine/godot/pull/104818>`_
.. [#f1] Default buffer size in 4.3 is ``1024``.