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 Rider

JetBrains Rider <https://www.jetbrains.com/rider/>`_은 Visual Studio와 동일한 솔루션 시스템을 사용하는 C++, C# 및 GDScript용 상용 `JetBrains IDE입니다.

참고

이 문서는 JetBrains Rider를 C# 또는 GDScript 편집기로 사용하기 위한 것이 아니라 게임 엔진에 기여하기 위한 것입니다. 외부 편집기에서 C# 또는 GDScript를 코딩하려면 :ref:`외부 편집기 구성을 위한 C# 가이드 <doc_c_sharp_setup_external_editor>`를 참조하세요.

프로젝트 가져오기

팁

이미 Visual Studio를 기본 IDE로 사용하고 있다면 Rider에서도 동일한 솔루션 파일을 사용할 수 있습니다. Rider와 Visual Studio는 동일한 솔루션 형식을 사용하므로 솔루션 파일을 다시 빌드하지 않고도 두 IDE 간에 전환할 수 있습니다. 한 IDE에서 다른 IDE로 이동할 때 디버그 구성을 변경해야 합니다.

처음부터 시작하는 경우 구체적으로 :ref:`instructions<doc_compiling_index>`를 따르십시오.

  • 패키지 설치하기

  • 특정 플랫폼을 대상으로 컴파일하기 위한 scons 명령을 알아보세요.

솔루션 파일 생성을 요청하려면 추가 인수를 scons에 제공하세요.

  • scons 명령에 `vsproj=yes dev_build=yes`를 추가합니다.

Visual Studio 솔루션을 생성하려는 vsproj 매개 변수 시그널입니다. dev_build 매개변수는 디버그 기호가 포함되도록 보장합니다. 중단점을 사용하여 코드를 단계별로 실행합니다.

  • 생성된 ``godot.sln``를 Rider에서 엽니다.

참고

Rider 도구 모음에서 적절한 솔루션 구성이 선택되었는지 확인하세요. SDK 해결, 코드 분석, 빌드, 실행 등에 영향을 미칩니다.

프로젝트 컴파일하기 및 디버깅

Rider에는 Godot 프로젝트를 디버그하는 데 사용할 수 있는 디버거가 내장되어 있습니다. 화면 상단에 있는 디버그 아이콘을 눌러 디버거를 시작할 수 있습니다. 이는 프로젝트 Manager에서만 작동합니다. 편집기를 디버그하려면 먼저 디버거를 구성해야 합니다.

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

  • 그것을 선택하기 위해서 레이블 노드를 클릭하고 창 하단의 만들기 버튼을 누릅니다.

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

  • C++ 프로젝트 실행 구성에 대해 다음 값을 확인하십시오.

    • 실행 경로 : $(LocalDebuggerCommand)

    • 프로그램 인수: -e --path <path to the Godot project>

    • 작업 디렉토리: $(LocalDebuggerWorkingDirectory)

    • 출시 전 값은 "Build 프로젝트"입니다.

그러면 프로젝트 관리자를 열지 않고 지정된 프로젝트를 디버깅하도록 실행 파일에 지시합니다. project.godot 파일 경로가 아닌 프로젝트 폴더의 루트 경로를 사용하세요.

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

  • 마지막으로 "적용"과 "확인"을 클릭하여 변경 사항을 저장합니다.

  • 화면 상단의 디버그 아이콘을 누르면 JetBrains Rider가 디버거가 연결된 Godot 편집기를 실행합니다.

또는 **실행 > 프로세스에 연결**을 사용하여 실행 중인 Godot 인스턴스에 디버거를 연결할 수 있습니다.

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

  • ``godot.editor``를 검색한 다음 ``Attach with LLDB``를 클릭하여 Godot 인스턴스를 찾을 수 있습니다.

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

디버그 옵션

디버그 시각화 도우미는 디버깅 중에 복잡한 데이터 구조가 표시되는 방식을 사용자 지정합니다. Windows의 경우 Godot에 내장된 "natvis"("Native Visualization"의 약자)가 자동으로 사용됩니다. 다른 운영 체제의 경우 유사한 기능을 수동으로 설정할 수 있습니다.

`RIDER-123535 <https://youtrack.jetbrains.com/issue/RIDER-123535/nix-Debug-Godot-Cpp-from-Rider-pretty-printers-usability>`_를 팔로우하세요.

비트 시프트

Rider doctest 지원을 활용하세요. `지침 <https://github.com/JetBrains/godot-support/wiki/Godot-doctest-Unit-Tests>`_을 참조하세요.

프로파일러

`프로파일링 지침 <https://github.com/JetBrains/godot-support/wiki/Profiling-Godot-engine-(native-code)-with-dotTrace-or-JetBrains-Rider>`_을 참조하세요.

JetBrains IDE에 대한 구체적인 정보는 `JetBrains Rider 문서 <https://www.jetbrains.com/rider/documentation/>`_를 참조하세요.

Known issues

Windows MinGV 빌드 디버깅 - 기호가 로드되지 않습니다. `RIDER-106816 <https://youtrack.jetbrains.com/issue/RIDER-106816/Upgrade-LLDB-to-actual-version>`_으로 신고되었습니다.