in 게임 개발 노트, 공부 노트, 소프트웨어 개발

유니티에 비주얼 스튜디오 코드 (Visual Studio Code; VSCode) 연동방법

VSCode 를 사용해야 하는 이유

유니티에서 코딩을 위해 기본 내장된 MonoDevelop 이나 Visual Studio Community 를 사용하는 것은 고통입니다. 너무 무겁습니다.

맥에서는 MonoDevelop 과 Visual Studio for Mac 모두 한국어가 제대로 타이핑 되지 않는 문제가 추가로 존재합니다.

가장 권장할만한 사항은 유니티로 Visual Studio Code 를 사용하는 것입니다. 맥, 리눅스, 윈도우를 모두 지원하며, 가볍고 빠르고, 커뮤니티가 활발합니다.

예전에는 서브라임(Sublime) 을 유니티 에디터로 사용했습니다. 서브라임 또한 가볍고 빠르지만, 커뮤니티 지원이 예전같지 않기에 문제를 스스로 해결해야 하는 경우가 많습니다. 코딩 보다 유니티와의 연동 문제를 해결하는 시간이 길어집니다.

VSCode를 사용해야 하는 또다른 이유는, 유니티가 공식 지원하기 때문에 외부 플러그인에 크게 의존하지 않고 유니티와 연동할 수 있기에 설정 과정이 깔끔하기 때문입니다.

VSCode 설치

공식 사이트: https://code.visualstudio.com

매우 간단합니다. 공식 사이트에서 다운로드하여 설치하면 끝입니다.

설치 프로그램의 안내에 따라 기본 설정 그대로 설치를 진행하면 됩니다.

 

VSCode 를 유니티 에디터로 등록

Unity Preferences 에서 사용할 에디터로 VSCode 를 지정합니다.

메뉴 경로는 아래와 같습니다.

  • 맥은 Unity > Preferences
  • 윈도우는 Edit > Preferences

Unity Preferences 의 External Tools 탭에서 External Script Editor 의 드롭다운 메뉴에서 사용할 에디터의 경로를 새로 찾아 등록하면 됩니다.

Visual Studio Code 의 설치 경로를 찾아서

  • 맥은 VSCode.app
  • 윈도우는 VSCode.exe

파일을 등록하세요.

 

유니티 연동에 필요한 의존 라이브러리 설치

VSCode를 정상적으로 유니티에 사용하기 위해서는 아래 라이브러리를 모두 설치해야 합니다.

  • 깃: https://git-scm.com
  • 닷넷 코어: https://microsoft.com/net/core
  • 모노 최신버전: http://www.mono-project.com/download/​

닷넷 코어는 최초 예제 프로젝트를 한번이라도 빌드해야 정상적으로 동작합니다.

닷넷 코어를 설치한 다음, 아래 절차를 실행해주세요. 첨부한 닷넷 코어 링크에도 같은 내용이 영어로 적혀 있습니다.

한번만 아래 과정을 따라하면 이후에는 다시 할 필요가 없습니다.

1. .NET SDK 를 다운로드 받고 설치

그냥 링크에서 다운로드 받아 설치하세요.

2. 닷넷코어 예제 앱 생성

예제 앱을 생성합니다.

맥은 Terminal, 윈도우는 CMD 를 열고 아래 커맨드를 입력하고 실행해주세요. Hello World 를 출력하는 간단한 샘플 프로젝트를 만드는 커맨드 입니다.

dotnet new console -o myApp

그리고 아래 커맨드를 입력하여 생성한 프로젝트로 이동해주세요.

cd myApp

3. 예제 앱 빌드 및 실행

생성한 프로젝트 이동된 상태에서 예제 프로젝트를 빌드 및 실행합니다.

dotnet run

콘솔창에 빌드 관련 메시지와 함께, Hello World! 가 출력될겁니다.

다 끝났습니다. 닷넷 코어가 활성화 됬습니다.

VSCode 의 C# 플러그인 설치

이제 VSCode 를 실행하고 전용 C# 플러그인만 설치하면 됩니다.

아래 그림을 따라 VSCode의 확장(Extension) 탭을 펼친 다음 검색 창에 C# 을 검색하고, 그림에 빨간색으로 제가 마킹해둔 플러그인을 설치하면 됩니다.

설치 및 연동 끝!

VSCode 연동이 다 끝났습니다.

이제 유니티에서 C# 스크립트를 만들고 실행할때 VSCode 로 열릴 것입니다. 또한 자동완성 기능도 잘 동작할 것입니다.

  • 최초로 유니티 C# 스크립트를 VSCode로 열때 VSCode의 콘솔창에 유니티와의 연동을 위한 많은 메시지들이 출력될수 있습니다.
    1~2분 정도 기다리면 처리가 모두 끝나니까 걱정할 필요가 없습니다.

VSCode 에 대한 다른 팁은 아래 링크를 참고해보세요.

  • http://gomcine.tistory.com/entry/VS-Code-기본-세팅
  • 애니타임

    설명해주신대로 VSCode와 플러그인까지 모두 설치했습니다.. 제 컴퓨터가 윈도우10 64비트인데 Mono 64비트에는 no GTK#이라고 되어있어 그냥 32비트를 설치했습니다.. 마지막 C#플러그인 설치하고 실행해보면 Git을 찾을 수 없습니다. ‘git.path’를 사용하여 Git을 설치하거나 구성합니다.라는 메세지가 나오는데 여기서는 어떻게 해야하나요?

    • https://ijemin.com 이제민

      여기서 https://git-scm.com Git 을 설치한 다음, 다시 비주얼 스튜디오 코드로 C# 스크립트를 열어보세요.

    • 애니타임

      강의 듣고 있는데 피드백 너무 좋습니다.. 감사합니다^^

  • CodeDiver

    Mac에 VSCode를 설치했지만 인텔리센스가 동작하지 않네요. ;;

    • https://ijemin.com 이제민

      .NET Core와 Mono 프로젝트 최신버전을 설치하셨나용? .NET Core를 설치해도 최초로 예제 프로젝트를 한번 빌드해야 동작합니다.

  • name nick

    자동완성이 안됩니다 ㅠㅠ