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...

Використання редактора конфігурації компіляції двигуна

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

Щоб зменшити розмір бінарного файлу, можна скомпілювати власні шаблони експорту з вимкненими певними функціями. Детально про це описано в Оптимізація збірки за розміром. Однак визначення функцій, які потрібно вимкнути, може бути нудним завданням. Редактор конфігурації компіляції движка покликаний вирішити цю проблему, надаючи інтерфейс для зручного перегляду та управління цими функціями, а також можливість виявляти функції, які наразі використовуються в проєкті.

Project > Tools > Engine Compilation Configuration Editor дозволяє створювати та керувати профілями збірки для вашого проєкту Godot.

Відтепер у вас є дві можливості:

Перегляньте список і вручну зніміть прапорці з тих функцій, які вам не потрібні.
Використовуйте кнопку Detect from Project, щоб автоматично виявити функції, які зараз використовуються в проекті, і вимкнути невикористовувані функції. Зверніть увагу, що це замінить існуючий список функцій, тому якщо ви вручну зняли позначку з деяких елементів, їх стан буде скинуто залежно від того, чи проект фактично використовує цю функцію.

Відкриття редактора конфігурації компіляції двигуна

Після натискання кнопки Detect from Project розпочнеться процес виявлення проекту. Залежно від розміру проекту, це може зайняти від декількох секунд до декількох хвилин. Після завершення виявлення ви побачите оновлений список функцій, деякі з яких будуть вимкнені:

Оновлено список функцій після використання виявлення функцій (приклад з демонстрації 3D-платформера)

Попередження

Скасування вибору функцій у цьому діалоговому вікні не призведе до зменшення розміру бінарного файлу безпосередньо під час експорту. Оскільки фактично видалити функції з бінарного файлу можна лише під час компіляції, вам все одно потрібно компілювати власні шаблони експорту із зазначеним профілем збірки, щоб фактично скористатися перевагами редактора конфігурації компіляції движка.

Тепер ви можете зберегти профіль збірки, натиснувши Зберегти як у верхній частині вікна. Профіль збірки можна зберегти в будь-якому місці, але рекомендується зберегти його десь у папці проекту та додати до системи контролю версій, щоб мати можливість повернутися до нього пізніше, коли це буде потрібно. Це також дозволяє використовувати систему контролю версій для відстеження змін у профілі збірки.

Профіль збірки — це JSON-файл (і розширення .gdbuild), який після виявлення у наведеному вище прикладі виглядає ось так:

{
    "disabled_build_options": {
        "disable_navigation_3d": true,
        "disable_xr": true,
        "module_godot_physics_3d_enabled": false,
        "module_msdfgen_enabled": false,
        "module_openxr_enabled": false
    },
    "disabled_classes": [
        "AESContext",
        ...
        "ZIPReader"
    ],
    "type": "build_profile"
}

Цей файл можна передати як опцію SCons під час експорту шаблонів compiling:

scons target=template_release build_profile=/path/to/profile.gdbuild

Система збірки використовуватиме це для вимкнення невикористовуваних класів і, як наслідок, зменшення розміру бінарного файлу.

Обмеження

Функціональність Detect from Project залежить від зчитування сцен та скриптів проекту. Вона не зможе виявити використані функції в таких сценаріях:

Функції, що використовуються в GDScripts, створені процедурно, а потім запускаються під час виконання.
Функції, що використовуються в expressions.
Функції, які використовуються в GDExtensions, якщо мова зв'язування не дозволяє визначати використовувані класи і розширення використовує цю функціональність. Дивіться GH-104129 для детальної інформації.
Функції, що використовуються в external PCKs loaded at runtime.
Можуть існувати певні граничні випадки. Якщо ви не впевнені, будь ласка, відкрийте проблему на GitHub з доданим мінімальним проектом відтворення.

Дивись також

Ви можете досягти подальшого зменшення розміру, передаючи інші опції, що зменшують розмір двійкового файлу. Див. Оптимізація збірки за розміром для отримання додаткової інформації.