VS Code를 사용해서 Unity 개발하기 (mac 세팅 포함)

VS Code를 사용해서 Unity 개발하기 (mac 세팅 포함)

유니티의 경우 안드로이드 스튜디오(안드로이드 개발 시 사용)와 XCode(os x, ios 앱 개발 시 사용)와 달리 게임 구성 편집 밀 빌드를 담당하는 '유니티 에디터'와 스크립트 편집기가 분리되어 있습니다.

스크립트 편집기으이 경우 유니티를 설치할 때 함께 설치되지 않아서 본인의 취향에 맞는 에디터 사용이 필요합니다. 본문에서는 VS Code(Visual Studio Code)를 사용해 스크립트 편집기의 설정을 하는 방법을 알아보도록 하겠습니다.

VS Code (Visual Studio Code)

VS Code의 특징은 다음과 같습니다.

• Visual Studio에서 사용하는 IntelliSense 지원
• 익스텐션을 활용해 다양한 언어 및 개발환경 세팅 가능
• 상용 개발에 제약없이 사용 가능

VS Code는 Visual Studio Code 사이트에서 받을 수 있습니다.

유니티에서 VS Code를 사용하기

VS Code를 사용해 유니티 스크립트를 편집하기 위해서는 VS Code 외 추가 개발 툴 설치가 필요합니다.

.NET Core SDK

유니티 C#에서 .NET Framework를 사용하기 때문에 .NET 개발을 위한 SDK를 설치해야 합니다.

1. 다운로드 사이트에서 .NET Core SDK를 다운로드 후 설치합니다.
2. 명령 프롬프트 또는 터미널에서 dotnet 명령어를 실행해 SDK가 정상적으로 설치되었는지 확인합니다.
   • 확인되지 않는 경우 재부팅 또는 재설치를 진행합니다.

Mono (mac 사용자의 경우)

맥 사용자의 경우, Mono가 제대로 설정되어 있지 않다면 편집기에서 유니티 관련 AAPI에 대한 참조를 찾지 못해 에러가 발생할 수 있습니다.
Mono를 기존에 설치한 경우라도 간혹 설정이 깨져서 에러가 발생할 수 있는데, 이 경우 Mono를 재설치하면 해결할 수 있습니다.

mac Mono 다운로드 페이지에서 Visual Studio channel* 버전을 설치해줍니다.

VS Code Extension

VS Code를 실행한 뒤, Extension 메뉴에서 다음 익스텐션을 설치합니다.

• C# 익스텐션
• Debugger for Unity
• Unity Tools

Debugger for Unity의 경우 Unity에서 작성한 VS Code 스크립트로 VS Code에서 유니티 디버깅을 할 수 있도록 해줍니다.
Unity Toold의 경우는 Unity 공식 익스텐션이 아닙니다. Debugger for Unity 익스텐션의 확장 기능을 제공해줍니다.

C# 익스텐션과 mac 사용자에 대한 유의사항

C# 익스텐션이 버전업 되면 .NET Core SDK가 호환되지 않는 경우가 종종 발생합니다. 이렇게 되면 자동 완성이 정상적으로 동작하지 않아 유니티 스크립트 작성에 지장이 생길 수 있습니다.

이러한 현상을 방지하기 위해 VS Code에서 익스텐션 자동 업데이트 옵션을 해제하고 C# 익스텐션의 버전을 조정하는 작업이 필요합니다.

익스텐션 자동 업데이트 해제

익스텐션의 자동 업데이트를 하는 방법은 다음과 같습니다.

1. Ctrl + , 또는 Command + , 키를 입력해 설정 창을 띄웁니다.
2. 설정 창 상단 검색 창에 updaate를 입력해 업데이트 관련 설정만 표시합니다.
3. 기능 또는 Features 탭 아래 Extensions: Auto Update 설정을 체크 해제 합니다.

익스텐션을 다운그레이드 하는 방법

VS Code의 익스텐션을 다운그레이드 하는 방법은 다음과 같습니다.

1. Extensions 메뉴를 선택에 현재 설치되어 있는 익스텐션 리스트를 띄웁니다.
2. 
   설치된 익스텐션 목록에서 버전을 다운그레이드 하려는 익스텐션의 우측 하단 설정 버튼을 누릅니다.
3. Install another version 또는 다른 버전 설치를 눌러 설치하려는 버전을 선택합니다.

Unity Editor 설정 변경

스크립트 파일을 열 때 VS Code를 사용하도록 Unity Editor 설정을 변경해야 합니다.

1. Unity Editor 내 Edit - Preferences 메뉴를 선택합니다.
2. External Tools 탭의 External Script Editor 드롭다운에서 Visual Studio Code를 선택합니다.
   
   • 만약 Visual Studio Code 항목이 보이지 않는다면 Browse를 선택해 VS Code 실행 파일을 선택합니다.

Unity VS Code 디버깅 설정하기

VS Code에서 breakpoint를 잡으면서 Unity를 디버깅하기 위해서는 다음 설정이 필요합니다.

VSCode 플러그인 설치

유니티 에셋 스토어에서 VSCode 플러그인을 설치합니다.

디버그 사용 활성화

Edit - Preferences > VSCode를 엽니다.

Use Unity Debugger 옵션을 체크해서 디버거를 사용하도록 설정합니다.