Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

EditorPaths

Успадковує: Object

Редактор-only singleton, який повертає шляхи до різних папок даних OS та файлів.

Опис

Цей редактор-only singleton повертає спеціальні шляхи для різних папок даних та файлів. Для забезпечення збереження файлів в правильному місці на кожній операційній системі можна використовувати в додатках редактора.

Примітка: Цей однотон не доступний у експортованих проектах. Припустимо, щоб отримати доступ до його в експортному проекті призведе до помилки скрипта, оскільки одинонтон не буде оголошено. Щоб запобігти помилках сценаріїв у експортованих проектах, скористайтеся Engine.has_singleton(), щоб перевірити, чи доступний одинон до його використання.

Примітка: На платформі Linux/BSD Godot відповідає XDG Специфікація бази каталогів. Ви можете перевизнати змінні середовища відповідно до специфікації, щоб змінити шляхи даних редактора та проекту.

Посібники

Файлові шляхи у проектах Godot

Методи

String	get_cache_dir() const
String	get_config_dir() const
String	get_data_dir() const
String	get_project_settings_dir() const
String	get_self_contained_file() const
bool	is_self_contained() const

Описи методів

String get_cache_dir() const 🔗

Повертає абсолютний шлях до папки кешу користувача. Цю папку слід використовувати для тимчасових даних, які можна безпечно видалити, коли редактор закривається (наприклад, створені мініатюри ресурсів).

Шляхи за умовчанням для кожної платформи:

- Windows: %LOCALAPPDATA%\Godot\
- macOS: ~/Library/Caches/Godot/
- Linux: ~/.cache/godot/

String get_config_dir() const 🔗

Повертає абсолютний шлях до папки конфігурації користувача. Ця папка повинна бути використана для файлів * конфігурації *

Плани за замовчуванням на платформі:

- Вікна: %APPDATA%\Godot\ (наприклад, `get_data_dir()`)`
- macOS: ~/Library/Application support/Godot/ (наприклад, `get_data_dir()`)`)
- Linux: ~/.config/godot/

String get_data_dir() const 🔗

Повертає абсолютний шлях до папки даних користувача. Ця папка повинна бути використана для persistent файлів даних, таких як встановлені шаблони експорту.

Пріжки за платформою:

- Вікна: %APPDATA%\Godot\ (наприклад, `get_config_dir()`)`
- macOS: ~/Library/Application support/Godot/ (наприклад, `get_config_dir()`)`)
- Linux: ~/.local/share/godot/

String get_project_settings_dir() const 🔗

Повертає відносний шлях до налаштувань редактора для цього проєкту. Зазвичай це "res://.godot/editor". Усі проєкти мають унікальний підкаталог у шляху налаштувань, де зберігаються налаштування редактора, специфічні для проєкту.

String get_self_contained_file() const 🔗

Повертає абсолютний шлях до самостійного файлу, що робить поточний екземпляр редактора Godot вважається самодотриманням. Повертає порожній рядок, якщо поточний екземпляр редактора Godot не підтримується. Дивитися також _self_contained().

bool is_self_contained() const 🔗

true, якщо редактор позначений як самоконтейнер, false в іншому випадку. Коли ввімкнено режим, конфігурація користувача, дані та файли кешу зберігаються в папці editor_data/ поряд з редактором бінарних. Це полегшує переносне використання і забезпечує редактор Godot, що зменшує кількість файлів, що надходить з власної папки. Самостійний режим не доступний для експортованих проектів.

Самостійний режим можна ввімкнути, створивши файл ._sc_ або _sc_ в тій же папці, як і редактор бінарних або macOS .app пучка, поки редактор не працює. Дивитися також get_self_contained_file().

Примітка: На macOS, карантинний прапор слід вручну видалити, перш ніж використовувати режим самотримання, див. ` Запуск на macOS <https://docs.godotengine.org/en/stable/tutorials/export/running_on_macos.html>`__.

Примітка: На macOS, розміщення _sc_ або будь-який інший файл всередині .app пучка буде розбити цифровий підпис і зробити його непортабельним, розглянути розміщення його в тій же папці, як пакет .app замість.

Примітка: Паровий випуск Godot використовує режим самотримання за замовчуванням.