초보자를 위한 유니티(Unity) 설치 방법과 VSCode 연동하기 | 자동 완성 안될 때 대처법

게임 개발에 관심이 있으시다면 유니티(Unity)를 한 번씩 들어보셨을 텐데요.

하지만 유니티(Unity)를 설치하면서 오래된 정보를 따라 하다가 오류가 발생하거나 환경설정의 어려움을 겪은 경험이 있으실 것입니다. 그래서 오늘은 최신 버전의 Unity 설치 방법과 비주얼 스튜디오 코드(VSCode) 설정 방법을 통해 효율적인 게임 개발 환경을 구축해 보겠습니다.

 

 

유니티(Unity) 설치하기

유니티 홈페이지에 접속하여 다운로드 버튼을 통하여 설치파일을 다운로드합니다.

 

 

다운로드한 UnityHubSetup파일을 실행한 뒤, 약관에 동의하고 설치 폴더를 지정한 후 설치를 클릭합니다. 

 

 

유니티(Unity)를 사용하려면 유니티 허브(Unity Hub) 계정이 필요합니다. 

계정이 없다면 프로그램에 Create account 버튼을 눌러 회원가입 후 Sign in 버튼을 클릭합니다.

 

 

유니티 허브(Unity Hub) 계정으로 로그인을 하면  Unity Editor 최신버전 설치 팝업이 나타납니다.

Install Unity Editor를 클릭하여 최신 버전을 설치합니다.

 

 

VSCode 설치 및 익스텐션 설정하기

VSCode 설치

Visual Sutdio Code 공식 웹사이트에 접속합니다.

Download for Windows를 클릭하여 설치파일을 다운로드한 뒤 설치합니다. 기본설정은 건드릴 필요 없이 설치를 진행하시면 됩니다.

 

 

C# 확장 플러그인 설치

VSCode를 실행한 뒤 왼쪽의 아이콘을 클릭하여 마켓플레이스에 접속하여 C#을 입력하고 Microsoft에서 제공하는 C# Dev Kit 확장플러그인을 설치합니다. 마찬가지로 바로 아래 있는 C# 확장플러그인도 함께 설치합니다.

 

 

.NET SDK 설치

.NET SDK 다운로드 페이지에 접속합니다.

.NET 8.0 SDK 파일을 다운로드합니다. 운영체제에 따라 64비트 운영체제는 x64, 32비트 운영체제는 x86을 선택하여 받습니다.

 

 

설치 프로그램을 실행하고 지시에 따라 설치를 완료합니다. 

 

Unity 확장 플러그인 설치

VSCode의 마켓플레이스에서 Unity를 검색하여 Unity확장플러그인을 설치합니다.

 

 

Unity에서 VSCode 사용 설정하기

Unity 프로젝트 생성하기

유니티(Unity) 설치가 완료되었으면 New project로 프로젝트를 하나 생성합니다.

 

 

제작하고자 하는 템플릿을 선택하면 되지만 저는 2D기반의 유니티앱을 제작하기 위해서 2D를 선택하고 프로젝트를 생성하겠습니다.

 

 

유니티 외부편집기 vscode로 설정하기

유니티에서 Script 코드를 열면 기본적으로 VisualStduio로 열리게 됩니다.

VSCode로 외부 편집기가 열리게 하기 위해서는 유니티 내에서 설정을 통해 간편히 변경할 수 있습니다.

 

유니티(Unity)의 상단 Edit - Preferences... 를 클릭하여 설정에 들어갑니다.

 

 

Prefernces창 왼쪽 External Tools 항목으로 이동하여 Script Editor를 Visual Studio Code로 변경한 뒤 창을 닫습니다.

 

 

이제 유니티에서 C# 스크립트를 더블클릭하면 비주얼스튜디오가 아닌 VSCode로 자동으로 열리게 됩니다.

 

 

VSCode 자동완성이 안될 때

C#파일을 VSCode에서 불러온 뒤 코드를 작성하다 보면 자동완성이 안 되는 현상이 발생할 수 있습니다.

가장 먼저 확인할 건 위의 확장프로그램 중 설치가 누락된 확장프로그램이 없는지 확인할 필요가 있습니다. 확장프로그램이 모두 정상적으로 설치가 되어있는데도 오류가 발생한다면 아래 방법을 따라 해주세요.

 

유니티 프로그램 상단 Assets - Open C# Project를 클릭하면 현재 프로젝트의 C# 코드가 동일하게 VSCode로 열리게 되는데 이후 코딩부터는 자동완성이 제대로 작동되게 됩니다. 한번 이렇게 VSCode로 불러오면 이후에는 이전처럼 더블클릭으로 VSCode를 실행해도 자동완성 오류문제없이 작동하게 됩니다.