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

JetBrains Райдер

JetBrains Rider — це комерційне середовище розробки JetBrains для C++, C# та GDScript, яке використовує ту саму систему рішень, що й Visual Studio.

Примітка

Ця документація призначена для внеску в ігровий рушій, а не для використання JetBrains Rider як редактора C# або GDScript. Щоб написати код на C# або GDScript у зовнішньому редакторі, див. the C# guide to configure an external editor.

Імпорт проекту

Порада

Якщо ви вже використовуєте Visual Studio як основну IDE, ви можете використовувати той самий файл рішення в Rider. Rider і Visual Studio використовують однаковий формат рішення, тому ви можете перемикатися між двома IDE без перебудови файлу рішення. Конфігурації налагодження потрібно змінювати під час переходу від однієї IDE до іншої.

Якщо ви починаєте з нуля, будь ласка, дотримуйтесь інструкцій instructions, зокрема:

  • Встановіть усі залежності.

  • Визначте команду scons для компіляції для певної платформи.

Надайте scons додаткові аргументи для запиту на створення файлу рішення:

  • Додайте vsproj=yes dev_build=yes до команди scons

Параметр vsproj сигналізує про те, що вам потрібно створити рішення Visual Studio. Параметр dev_build гарантує, що символи налагодження включено, що дозволяє, наприклад, покроково проходити код за допомогою точок зупинки.

  • Відкрийте згенерований файл godot.sln у Rider.

Примітка

Переконайтеся, що на панелі інструментів Rider вибрано відповідну конфігурацію рішення. Це впливає на виконання SDK, аналіз коду, збірку, запуск тощо.

Компіляція та налагодження проекту

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

../../../_images/rider_run_debug.webp

  • Натисніть опцію Godot > Edit Configurations у верхній частині екрана.

../../../_images/rider_configurations.webp

  • Переконайтеся, що такі значення для конфігурації виконання проекту C++:

    • Шлях до Exe: $(LocalDebuggerCommand)

    • Аргументи програми: -e --path <шлях до проекту Godot>

    • Робочий каталог: $(LocalDebuggerWorkingDirectory)

    • Перед запуском має значення «Створити проект»

Це вкаже виконуваному файлу налагоджувати вказаний проект без відкриття Менеджера проектів. Використовуйте кореневий шлях до папки проекту, а не шлях до файлу project.godot.

../../../_images/rider_configurations_changed.webp

  • Нарешті натисніть «Застосувати» та «ОК», щоб зберегти зміни.

  • Коли ви натискаєте піктограму Debug у верхній частині екрана, JetBrains Rider запустить редактор Godot із підключеним налагоджувачем.

Крім того, ви можете скористатися Виконати > Приєднати до процесу, щоб приєднати налагоджувач до запущеного екземпляра Godot.

../../../_images/rider_attach_to_process.webp

  • Ви можете знайти екземпляр Godot, виконавши пошук за godot.editor і натиснувши Прикріпити за допомогою LLDB

../../../_images/rider_attach_to_process_dialog.webp

Візуалізатори налагодження

Візуалізатори налагодження налаштовують спосіб відображення складних структур даних під час налагодження. Для Windows автоматично використовується вбудований Godot "natvis" (скорочення від "Native Visualization"). Для інших операційних систем подібну функціональність можна налаштувати вручну.

Будь ласка, дотримуйтесь інструкцій RIDER-123535.

Модульне тестування

Підтримка Leverage Rider doctest. Будь ласка, зверніться до інструкцій.

Профілювання

Будь ласка, зверніться до інструкцій з профілювання <https://github.com/JetBrains/godot-support/wiki/Profiling-Godot-engine-(native-code)-with-dotTrace-or-JetBrains-Rider>`_.

Зверніться до документації JetBrains Rider, щоб отримати будь-яку конкретну інформацію про JetBrains IDE.

Відомі проблеми

Налагодження збірки Windows MinGV - символи не завантажуються. Повідомлено про помилку RIDER-106816.